Proyekto

Hindi nasisira ang mod mo

Kailangang patuloy na gumana ang isang Crafting mod kapag nag-update ang Minecraft at kapag nag-update ang Crafting. Sinasabi ng pahinang ito kung ano ang garantisado at kung ano ang kailangan mong gawin para makinabang dito.

Ano ang garantisado

Lahat ng public sa Kotlin at Java API, at bawat keyword, built-in function at pangalan ng event sa CraftScript. Puwedeng magbago sa anumang bersyon ang loob ng Crafting (kung paano nito nilo-load ang mga mod, kung paano ito kumakabit sa laro); hindi ito nakikita ng mod mo at hindi nito kailangan.

Bakit hindi ito nasisira ng update ng laro

Hindi kailanman ginagalaw ng mod mo ang code ng Minecraft. Kapag may inilipat o pinalitan ng pangalan ang bagong bersyon ng laro, binabago ng Crafting sa loob kung aling bahagi ng laro ang tinatawag ng bawat function ng API. Pareho pa rin ang pangalan at ginagawa ng function na ginagamit ng mod mo.

Sa ngayon, gumagana ang Crafting sa Minecraft Java 26.3. Buo idinadagdag ang bawat bagong bersyon ng laro: gumagana sa bersyong iyon ang isang function ng API, o hindi itinuturing na suportado ang bersyon.

Apat na patakaran

  1. Nagdadagdag, hindi nagbabago. May default value ang bagong parameter, kaya valid pa rin ang mga dating tawag. Bagong pangalan ang kasama ng bagong behaviour.
  2. May babala ang mga kapalit. Kapag may mas magandang paraan para gawin ang isang bagay, minamarkahang deprecated ang luma, sinasabi kung ano ang gagamitin sa halip, at patuloy itong gumagana nang eksaktong pareho, kahit hanggang sa susunod na major version. Nakaguhit ito sa editor mo.
  3. Sa major version lang may inaalis, iyong nagpapalit ng unang numero ng bersyon ng Crafting. Inaanunsyo ito sa release notes, kasama ang kapalit ng bawat isa.
  4. Walang pineke. Kung hindi gagana ang isang function sa larong tumatakbo, malinaw na error ang ibinibigay nito. Hindi ito kailanman nagre-return ng gawa-gawang value na magpapaisip sa mod na maayos ang lahat.

Ano ang ibig sabihin nito sa iyo

  • Hindi ka kailanman pipilitin ng pag-update ng Crafting na baguhin ang mod mo, maliban sa major version, at alam mo kung ano mismo ang babaguhin.
  • Kapag lumabas na deprecated ang isang bagay na ginagamit mo, may oras ka: palitan ito kung kailan mo gusto, bago ang susunod na major version. Laging ipinapakita ng dokumentasyon ang kasalukuyang paraan.
  • Kung may kailangan ang isang mod na wala pa sa bersyon mo ng Crafting, sinasabi ito ng Crafting habang nilo-load ito sa halip na kalahati lang ang ma-load.
  • Huwag mag-import ng mga class na net.minecraft sa isang Kotlin o Java mod: walang anumang garantiya ang bahaging iyon.
  • Iwasan ang run_command at summon na may data ng laro: tumatanggap sila ng mga format ng Minecraft, na nagbabago. Kung kailangan mo sila para sa isang bagay, may kulang na function sa API; hilingin ito.

Kung may pumalya

  • Nilo-log kasama ang pangalan ng mod ang error sa isang event o command, at patuloy na tumatakbo ang natitirang bahagi ng server.
  • Hindi nilo-load ang script na may type error, at ibinibigay ng mensahe ang file, ang linya at ang inaasahan nito.
  • Hindi nilo-load ang .jar mod na may kulang na dependency o nangangailangan ng mas bagong bersyon ng Crafting, at sabay-sabay na iniuulat ng Crafting ang bawat problema kasama ang mungkahi para sa bawat isa.