TESLA Мод для Minecraft 1.12.2

Tesla

Tesla — це енергетичний API, розроблений для взаємодії між модами. Він дозволяє предметам, блокам і сутностям з різних модів взаємодіяти одне з одним через енергетичну мережу Tesla.

УВАГА: Альфа- та бета-версії призначені для авторів модів і тестувальників. Моди, які підтримують Tesla, повинні орієнтуватися лише на повноцінні релізи! Використання альфа-збірки може призвести до збою модів, які її потребують!

Цей проєкт спонсорується Nodecraft. Використовуйте код Darkhax, щоб отримати 30% знижки на перший місяць обслуговування!

Початок роботи

Найкращий спосіб використовувати Tesla API — через систему можливостей (Capability) Forge. Ідея дуже проста: можливості — це реалізації інтерфейсу, які обробляють певний тип логіки, пов'язаної з Tesla. Ці можливості потім можна прикріпити до підтримуваних об'єктів (Tile Entity, ItemStack і Entity). Коли можливість прикріплена, цей об'єкт отримає доступ до наданої логіки Tesla, і він буде видимий для інших об'єктів, що підтримують Tesla. Ви можете побачити базову реалізацію можливості тут і приклад tile entity тут. Також є приклад предмета тут.

Часті запитання

Де люди можуть обговорити Tesla API?

Є публічний сервер Discord, який можна знайти тут.

Чим Tesla відрізняється від інших енергетичних API?

Tesla API функціонує дуже подібно до інших енергетичних API, однак було зроблено кілька дизайнерських рішень, які зробили API набагато гнучкішим. Одним із таких рішень було використання системи можливостей Forge, яка дозволяє додати підтримку Tesla майже до чого завгодно. З цією системою мод міг би додати підтримку Tesla до ванільної печі без використання будь-яких брудних хаків. Іншим рішенням було використання long замість int. Ця зміна дозволяє модам легко працювати з більшими числами енергії.

Чому ви створили цей API?

API спочатку був створений як цікавий побічний проєкт, але отримав багато несподіваної уваги від інших розробників. Він не створювався як хрестовий похід проти інших енергетичних API чи чогось подібного.

Чи є якісь стандарти для Tesla?

API не нав'язує жодного стандарту, однак є кілька речей, яких авторам модів рекомендується дотримуватися. Одна Tesla має дорівнювати 1 RF, tile entities не повинні безпосередньо реалізовувати інтерфейси можливостей, а логіка сторін має оброблятися через методи можливостей.

Чи слід включати Tesla API до інших модів?

Хоча включення API часто практикується і підтримується Forge, це дуже погана практика. Хоча ніщо не заважає іншим модам включати API, це вкрай не рекомендується і не буде офіційно підтримуватися.

Як працює м'яка залежність, якщо я не можу включити API?

Forge надає кілька інструментів, які роблять м'яку залежність дуже простою. Перший — це анотація Optional. Цю анотацію можна додати до будь-якого класу, який реалізує інтерфейс, і якщо певний ID моду не виявлено, інтерфейс можна видалити з класу. Це дозволяє наявним об'єктам-контейнерам реалізовувати інтерфейси Tesla без жорсткої залежності. Анотація CapabilityInject також надзвичайно корисна для м'якої залежності. Ви можете використати цю анотацію на полі, щоб воно ініціалізувалося певною можливістю, коли ця можливість ініціалізується. Ви також можете поставити цю анотацію на методи, щоб вони викликалися, коли можливість ініціалізується. Одне, що ви можете помітити, це те, що анотація приймає посилання на клас можливості з Tesla, який буде відсутній за м'якої залежності. Завдяки тому, як працюють анотації та JVM, безпечно робити це посилання в анотації. Це не викличе виняток Class Definition.

Політика щодо модпаків

Так, ви можете використовувати це в модпаку. Будь ласка, не надсилайте мені повідомлення з проханням дозволити використовувати це у вашому модпаку. Я не відповідатиму на такі повідомлення.