TESLA Mod pour Minecraft 1.12.2

Tesla

Tesla est une API d'énergie conçue pour la communication entre mods. Elle permet aux objets, blocs et entités de divers mods d'interagir entre eux via le réseau d'énergie Tesla.

ATTENTION : les versions alpha et bêta sont destinées aux auteurs de mods et aux testeurs. Les mods qui prennent en charge Tesla ne doivent cibler que les versions finales ! L'utilisation d'une version alpha peut faire planter les mods qui en dépendent !

Ce projet est sponsorisé par Nodecraft. Utilisez le code Darkhax pour obtenir 30 % de réduction sur votre premier mois de service !

Pour commencer

La meilleure façon d'utiliser l'API Tesla est de passer par le système de capacités de Forge. L'idée est très simple : les capacités sont des implémentations d'une interface qui gèrent un certain type de logique liée à Tesla. Ces capacités peuvent ensuite être attachées aux éléments pris en charge (Tile Entity, ItemStack et Entity). Lorsqu'une capacité est attachée, cet élément aura accès à la logique Tesla fournie, et il sera visible pour les autres éléments compatibles Tesla. Vous pouvez voir un exemple d'implémentation de capacité de base ici et un exemple de tile entity ici. Il y a aussi un exemple d'objet ici.

Questions fréquentes

Où peut-on discuter de l'API Tesla ?

Il existe un serveur Discord public qui se trouve ici.

Qu'est-ce qui différencie Tesla des autres API d'énergie ?

L'API Tesla fonctionne de manière très similaire aux autres API d'énergie, mais plusieurs choix de conception ont rendu l'API bien plus flexible. L'un de ces choix a été de décider d'utiliser le système de capacités de Forge, ce qui permet d'ajouter la prise en charge de Tesla à presque n'importe quoi. Avec ce système, un mod pourrait ajouter la prise en charge de Tesla à un four vanilla, sans recourir à des astuces douteuses. Un autre choix a été d'utiliser des longs plutôt que des entiers. Ce changement permet aux mods de travailler facilement avec des nombres d'énergie plus grands.

Pourquoi avez-vous créé cette API ?

L'API a été créée à l'origine comme un projet annexe amusant, mais elle a reçu beaucoup plus d'attention que prévu de la part d'autres développeurs. Elle n'a pas été créée comme une croisade pour tuer les autres API d'énergie ou quoi que ce soit de ce genre.

Existe-t-il des normes pour Tesla ?

L'API n'impose aucune norme, mais il y a quelques points que les auteurs de mods sont encouragés à suivre. Un Tesla devrait être égal à 1 RF, les tile entities ne devraient pas implémenter directement les interfaces de capacité, et la logique par face devrait être gérée via les méthodes de capacité.

L'API Tesa devrait-elle être incluse avec d'autres mods ?

Bien que l'inclusion d'API soit fréquemment pratiquée, et prise en charge par Forge, c'est une très mauvaise pratique. Rien n'empêche d'autres mods d'inclure l'API, mais c'est fortement déconseillé et ne sera pas officiellement pris en charge.

Comment fonctionne la dépendance souple si je ne peux pas inclure l'API ?

Forge fournit plusieurs outils qui rendent la dépendance souple vraiment simple. Le premier est l'annotation Optional. Cette annotation peut être ajoutée à n'importe quelle classe qui implémente une interface, et si un certain ID de mod n'est pas détecté, l'interface peut être retirée de la classe. Cela permet aux objets conteneurs existants d'implémenter les interfaces de Tesla sans dépendance dure. L'annotation CapabilityInject est également extrêmement utile pour la dépendance souple. Vous pouvez utiliser cette annotation sur un champ pour qu'il soit initialisé avec une capacité spécifique lorsque ladite capacité est initialisée. Vous pouvez aussi placer cette annotation sur des méthodes pour qu'elles soient appelées lorsque la capacité est initialisée. Une chose que vous remarquerez peut-être est que l'annotation prend une référence à la classe de capacité de Tesla, qui sera absente en dépendance souple. En raison du fonctionnement des annotations et de la JVM, il est sûr de faire cette référence dans l'annotation. Cela ne vous donnera pas d'exception Class Definition.

Politique relative aux modpacks

Oui, vous pouvez l'utiliser dans un modpack. Merci de ne pas m'envoyer de messages pour demander la permission de l'utiliser dans votre modpack. Je ne répondrai pas à ce genre de messages.