Kube Utils Mod za Minecraft 1.20.1, 1.21.1

Kube Utils

Kube Utils je jednostavan dodatak za KubeJS koji dodaje nove funkcionalnosti postojećim funkcijama i odvaja se kako bi stvorio nove sisteme koji omogućavaju performantniji, pojednostavljeniji i sažetiji kod.

Kako funkcioniše

Kube Utils (od sada Ku) je dizajniran sa konceptom jasnog, sažetog i doslednog API dizajna. Sve što ovaj mod dodaje nalazi se unutar globalnog Ku objekta, što znači da ako želite da pristupite level apijima, pristupićete mu preko Ku.Level, ako želite nešto da uradite sa fluidima koristićete Ku.Fluids itd.

Funkcionalnosti

Trenutno imamo samo nekoliko pomoćnika za neke od slabije podržanih oblasti KubeJS-a, ali planiramo da ovo znatno proširimo tokom životnog ciklusa razvoja sistema. Ako imate bilo kakve predloge, pošaljite zahtev za funkcionalnost!

• Level dodaci kao što je mogućnost dobijanja struktura na poziciji bloka, mogućnost generisanja struktura, pronalaženja entiteta i čišćenja prostora, dobijanja nasumične lokacije sa graničnim okvirom itd.
• Fluidi, omogućavaju vam da dobijete listu fluida na osnovu njihovog namespace-a, i da proverite da li je fluid prazan ili ne.
• List dodaci kao što je dobijanje nasumičnih unosa na osnovu ponderisane tabele
• Dodavanje opštih uslužnih programa kao što je nullOrEmpty koji vam daje vrlo jednostavan način da uvek znate da li je objekat nullOrEmpty, bilo da je item, block, itemstack, string, fluid ili itemEntity! (više podrške dolazi po potrebi)
• Potpuno dokumentovan kod
• Proizvodno validiran
• Jasan i jednostavan API

Naši ciljevi

• Cilj nam je da nikada ne pravimo prelomne promene osim ako na to nismo apsolutno primorani od strane Minecraft-a, Forge-a ili Fabric-a. U trenutku kada osetimo da treba da se odvojimo i napravimo prelomne promene, to će biti urađeno na opcioni način koji neće uticati na postojeći kod.
• Nikada da dodatke ne činimo preterano složenim
• Uvek dokumentujemo dodatke na jasnom engleskom jeziku

Dokumentacija

Naš cilj je da objavimo veb sajt koji dokumentuje sve nove dodatke i kako ih koristiti.

Trenutno možete čitati o funkcionalnostima koje dodajemo unutar koda. Naša BaseBinding klasa vam pokazuje koje objekte možete koristiti u Ku objektu. Na primer, BaseBindings sadrži Streams kao polje. To znači da možete koristiti Ku.Steams.MethodName. Dostupne metode možete pronaći unutar klase povezanog modula. Ako vidite polje okruženo sa ClassWrapper<?> to znači da da biste koristili to polje u KubeJS-u, moraćete da kreirate objekat. Na primer, Level je obavijen sa ClassWrapper<LevelUtils> što znači da ćete morati da koristite polje ovako new Ku.Level(player.level). Malo je komplikovano, ali kada sajt bude spreman, biće mnogo jednostavnije.

Odricanje od odgovornosti

Odricanje od odgovornosti, dok je u beta fazi, očekujte moguće prelomne promene koda. Kada dostignemo stabilno izdanje, ova poruka će biti uklonjena i od tog trenutka nadalje, kod neće sadržati prelomne promene!

Problemi

Molimo prijavite sve probleme na naš tracker problema zajedno sa primerom koda kako bismo mogli da validiramo probleme.