TESLA Mod za Minecraft 1.12.2

Tesla

Tesla je API za energiju dizajniran za komunikaciju između modova. Omogućava da predmeti, blokovi i entiteti iz raznih modova međusobno komuniciraju preko Tesla mreže energije.

UPOZORENJE: Alfa i beta izdanja su namenjena autorima modova i testerima. Modovi koji podržavaju Tesla treba da ciljaju samo puna izdanja! Korišćenje alfa verzije može srušiti modove kojima je potrebna!

Ovaj projekat sponzoriše Nodecraft. Iskoristite kod Darkhax za 30% popusta na prvi mesec usluge!

Početak rada

Najbolji način da koristite Tesla API je preko Forge-ovog sistema sposobnosti (Capability). Ideja je vrlo jednostavna: sposobnosti su implementacije interfejsa koje obrađuju određenu vrstu Tesla logike. Te sposobnosti se zatim mogu prikačiti na podržane stvari (Tile Entity, ItemStack i Entity). Kada se sposobnost prikači, ta stvar će imati pristup pruženoj Tesla logici i biće vidljiva drugim Tesla omogućenim stvarima. Osnovnu implementaciju sposobnosti možete videti ovde, a primer tile entity-ja ovde. Tu je i primer predmeta ovde.

Često postavljana pitanja

Gde ljudi mogu da diskutuju o Tesla API-ju?

Postoji javni Discord server koji možete pronaći ovde.

Šta čini Tesla drugačijim od drugih API-ja za energiju?

Tesla API funkcioniše vrlo slično drugim API-jima za energiju, ali postoji nekoliko dizajnerskih odluka koje API čine mnogo fleksibilnijim. Jedna od tih odluka bila je korišćenje Forge-ovog sistema sposobnosti, koji omogućava da se Tesla podrška doda skoro svemu. Sa ovim sistemom bi mod mogao da doda Tesla podršku običnoj peći, bez ikakvih prljavih hakova. Druga odluka bila je korišćenje long umesto int. Ova promena omogućava modovima da lako rade sa većim brojevima energije.

Zašto ste napravili ovaj API?

API je prvobitno napravljen kao zabavan sporedni projekat, ali je dobio mnogo neočekivane pažnje drugih programera. Nije napravljen kao krstaški pohod da uništi druge API-je za energiju ili tako nešto.

Postoje li ikakvi standardi za Tesla?

API ne nameće nikakav standard, ali postoji nekoliko stvari koje se preporučuje autorima modova da prate. Jedan Tesla treba da bude jednak 1 RF, tile entity-ji ne treba direktno da implementiraju interfejse sposobnosti, a logika po stranama treba da se obrađuje kroz metode sposobnosti.

Da li Tesla API treba pakovati uz druge modove?

Iako se pakovanje API-ja često radi i Forge ga podržava, to je vrlo loša praksa. Iako ništa ne sprečava druge modove da pakuju API, to se strogo ne preporučuje i neće biti zvanično podržano.

Kako funkcioniše meka zavisnost ako ne mogu da pakujem API?

Forge pruža nekoliko alata koji meku zavisnost čine zaista jednostavnom. Prvi je Optional anotacija. Ova anotacija se može dodati bilo kojoj klasi koja implementira interfejs, i ako se određeni ID moda ne detektuje, interfejs se može ukloniti iz klase. To omogućava postojećim kontejnerskim objektima da implementiraju Tesla interfejse bez tvrde zavisnosti. CapabilityInject anotacija je takođe izuzetno korisna za meku zavisnost. Ovu anotaciju možete koristiti na polju da bi se ono inicijalizovalo određenom sposobnošću kada se ta sposobnost inicijalizuje. Takođe možete staviti ovu anotaciju na metode da bi se pozvali kada se sposobnost inicijalizuje. Jedna stvar koju možete primetiti je da anotacija uzima referencu na klasu sposobnosti iz Tesle, koja će nedostajati pod mekom zavisnošću. Zbog načina na koji anotacije i JVM rade, bezbedno je napraviti ovu referencu u anotaciji. Neće vam dati Class Definition izuzetak.

Politika modpakova

Da, možete ovo koristiti u modpaku. Molim vas da mi ne šaljete poruke sa zahtevom za dozvolu za korišćenje u vašem modpaku. Neću odgovarati na takve poruke.