Ako aktualizovať plugin na novú verziu Minecraftu

Krok za krokom

1. 1.Najprv vyskúšaj starý .jar

   Daj ho na testovací server novej verzie a prečítaj si konzolu. Ak sa načíta a funguje, možno nemusíš nič meniť.

2. 2.Zmeň závislosť API

   V pom.xml alebo build.gradle nastav paper-api alebo spigot-api na novú verziu.

3. 3.Aktualizuj api-version a Java

   Nastav api-version v plugin.yml (napríklad '1.21') a kompiluj pre verziu Java, ktorú nová verzia potrebuje: Java 17 pred 1.20.5, Java 21 od 1.20.5, Java 25 pre 26.x.

4. 4.Oprav, čo sa už neskompiluje

   Zostav plugin a prejdi chyby: premenované materiály, odstránené metódy, zmenené triedy eventov. Kompilátor ich vypíše so súborom a riadkom.

5. 5.Aktualizuj závislosti

   Pluginy, ktoré tvoj plugin používa (Vault, PlaceholderAPI, ProtocolLib, WorldGuard), tiež potrebujú verzie, ktoré podporujú novú verziu Minecraftu, v súbore buildu aj na serveri.

6. 6.Otestuj na novej verzii

   Načítaj ho na serveri novej verzie s rovnakými pluginmi a vyskúšaj každý príkaz a funkciu, nielen štart.

Čo sa zvyčajne pokazí

• Názvy materiálov a enumov: aktualizácia 1.13 premenovala väčšinu predmetov a blokov; neskoršie verzie niektoré pridávajú, premenúvajú alebo odstraňujú. Kód, ktorý používa staré názvy alebo číselné ID, zlyhá.
• Odstránené zastarané metódy: metódy označené ako zastarané počas niekoľkých verzií nakoniec zmiznú.
• Dáta predmetov: od 1.20.5 nahradili NBT predmetov dátové komponenty. Pluginy, ktoré priamo upravujú NBT predmetov, potrebujú túto časť prepísať; bežné API ItemMeta funguje ďalej.
• NMS a reflexia: kód, ktorý používa interné triedy servera, sa pokazí takmer v každej verzii. Kde sa dá, nahraď ho API alebo knižnicou ako ProtocolLib.
• Verzie knižníc: pribalené knižnice zostavené pre starší Java môžu na novom zlyhať.

Aktualizácia o mnoho verzií

Prechod z 1.8 alebo 1.12 na 1.21 je skôr prepisom častí, ktoré pracujú s predmetmi, blokmi a časticami, než aktualizáciou. Urob to naraz proti novému API, nie verziu po verzii, a počítaj s tým, že aj konfiguračné súbory budú potrebovať nové názvy materiálov.

Ak musí plugin podporovať viac verzií naraz, kompiluj proti najstaršej podporovanej a vyhni sa API pridanému neskôr, alebo použi samostatné buildy pre každú verziu.

S Codexe

V pláne Pro a vyššom môžeš importovať zdrojový kód pluginu ako ZIP a požiadať napríklad: „Toto je môj plugin pre Paper 1.20.4. Aktualizuj ho na Paper 1.21.4“. Codexe prečíta verziu Minecraftu zo súboru buildu, zostaví plugin s verziou Java, ktorú táto verzia potrebuje, a opraví chyby kompilácie podľa skutočných signatúr API, proti ktorému zostavuje. Pri plugine, ktorý si vytvoril v Codexe, požiadaj o novú verziu v chate projektu.

Kompilácia dokazuje, že sa plugin zostaví na novom API. Potom ho vyskúšaj na testovacom serveri, pretože zmeny správania medzi verziami sa neprejavia ako chyby kompilácie.

Otázky