Kube Utils Mod pour Minecraft 1.20.1, 1.21.1

Kube Utils

Kube Utils est un simple addon pour KubeJS qui ajoute de nouvelles fonctionnalités aux fonctionnalités existantes et s'en écarte pour créer de nouveaux systèmes permettant un code plus performant, simplifié et concis.

Comment ça marche

Kube Utils (Ku à partir de maintenant) a été conçu avec le concept d'une API claire, concise et cohérente. Tout ce qui est ajouté par ce mod est contenu dans l'objet global Ku, ce qui signifie que si vous voulez accéder aux apis de level, vous y accéderez via Ku.Level, si vous voulez faire quelque chose avec les fluides vous utiliserez Ku.Fluids etc.

Fonctionnalités

Actuellement, nous n'avons que quelques helpers pour certaines des zones les moins supportées de KubeJS mais nous prévoyons d'étendre cela grandement au cours du cycle de vie du développement des systèmes. Si vous avez des suggestions, veuillez faire une demande de fonctionnalité !

• Ajouts au Level comme pouvoir obtenir des structures à une position de bloc, la capacité de faire apparaître des structures, trouver des entités et dégager des espaces, obtenir un emplacement aléatoire avec une boîte englobante, etc.
• Fluides, vous permettant d'obtenir une liste de fluides en fonction de leur(s) namespace(s), et de pouvoir vérifier si un fluide est vide ou non.
• Ajouts aux listes comme obtenir des entrées aléatoires basées sur une table pondérée
• L'ajout d'utilitaires généraux comme nullOrEmpty qui vous donne un moyen très simple de toujours savoir si un objet est nullOrEmpty, qu'il s'agisse d'un item, d'un block, d'un itemstack, d'une string, d'un fluid ou d'un itemEntity ! (plus de support à venir selon les besoins)
• Code entièrement documenté
• Validé en production
• API claire et simple

Nos objectifs

• Nous visons à ne jamais faire de changements cassants sauf si nous y sommes absolument forcés par Minecraft, Forge ou Fabric. Au moment où nous estimons devoir nous en écarter et faire des changements cassants, cela sera fait de manière optionnelle qui n'affectera pas le code existant.
• Ne jamais rendre les ajouts trop complexes
• Toujours documenter les ajouts en anglais simple

Documentation

Notre objectif est de publier un site web qui documente tous les nouveaux ajouts et comment les utiliser.

Pour l'instant, vous pouvez vous renseigner sur les fonctionnalités que nous ajoutons directement dans le code. Notre classe BaseBinding vous montre quels objets vous pouvez utiliser dans l'objet Ku. Par exemple BaseBindings contient Streams comme champ. Cela signifie que vous pouvez utiliser Ku.Steams.MethodName. Vous pouvez trouver les méthodes disponibles dans le fichier de classe du module concerné. Si vous voyez un champ entouré de ClassWrapper<?> cela signifie que pour utiliser le champ dans KubeJS, vous devrez créer l'objet. Par exemple, Level est enveloppé avec ClassWrapper<LevelUtils> ce qui signifie que vous devrez utiliser le champ comme ceci new Ku.Level(player.level). C'est un peu compliqué mais une fois le site web prêt, ce sera beaucoup plus simple.

Avertissement

Avertissement, tant que nous sommes en bêta, attendez-vous à d'éventuels changements cassants du code. Une fois que nous atteindrons la version stable, ce message sera supprimé et à partir de ce moment, le code ne contiendra plus de changements cassants !

Problèmes

Veuillez signaler tout problème sur notre tracker de problèmes avec un exemple de code afin que nous puissions valider les problèmes.