Slik oppdaterer du et plugin til en ny Minecraft-versjon

Steg for steg

1. 1.Prøv den gamle .jar-filen først

   Legg den på en testserver med den nye versjonen og les konsollen. Lastes den og fungerer, trenger du kanskje ikke å endre noe.

2. 2.Endre API-avhengigheten

   I pom.xml eller build.gradle setter du paper-api eller spigot-api til den nye versjonen.

3. 3.Oppdater api-version og Java

   Sett api-version i plugin.yml (for eksempel '1.21') og kompiler for den Java-versjonen den nye versjonen trenger: Java 17 før 1.20.5, Java 21 fra 1.20.5, Java 25 for 26.x.

4. 4.Rett det som ikke lenger kompilerer

   Bygg og gå gjennom feilene: omdøpte materialer, fjernede metoder, endrede eventklasser. Kompilatoren lister dem opp med fil og linje.

5. 5.Oppdater avhengighetene

   Plugins som pluginet ditt bruker (Vault, PlaceholderAPI, ProtocolLib, WorldGuard), trenger også versjoner som støtter den nye Minecraft-versjonen, både i byggefilen og på serveren.

6. 6.Test på den nye versjonen

   Last det på en server med den nye versjonen og de samme pluginene, og prøv hver kommando og funksjon, ikke bare oppstarten.

Hva som vanligvis går i stykker

• Navn på materialer og enums: 1.13-oppdateringen ga de fleste gjenstander og blokker nye navn; senere versjoner legger til, omdøper eller fjerner noen. Kode som bruker gamle navn eller numeriske id-er, feiler.
• Utdaterte metoder fjernet: metoder som har vært merket som deprecated i flere versjoner, forsvinner til slutt.
• Gjenstandsdata: fra 1.20.5 ble NBT på gjenstander erstattet av data components. Plugins som redigerer NBT på gjenstander direkte, må få den delen skrevet om; det vanlige ItemMeta-API-et fungerer fortsatt.
• NMS og reflection: kode som bruker interne serverklasser, går i stykker på nesten hver versjon. Erstatt den med API-et der det går, eller med et bibliotek som ProtocolLib.
• Bibliotekversjoner: shadede biblioteker bygd for en eldre Java kan feile på den nye.

Oppdatere over mange versjoner

Å gå fra 1.8 eller 1.12 til 1.21 er nærmere en omskriving av delene som rører gjenstander, blokker og partikler enn en oppdatering. Gjør det i én omgang mot det nye API-et, ikke versjon for versjon, og regn med at konfigurasjonsfilene også trenger nye materialnavn.

Må pluginet støtte flere versjoner samtidig, kompilerer du mot den eldste du støtter og unngår API som er lagt til senere, eller bruker egne bygg per versjon.

Med Codexe

På Pro og høyere kan du importere kildekoden til pluginet som en ZIP og be om for eksempel «Dette er Paper 1.20.4-pluginet mitt. Oppdater det til Paper 1.21.4». Codexe leser Minecraft-versjonen fra byggefilen, bygger med den Java-versjonen den versjonen trenger, og retter kompileringsfeil med de ekte signaturene til API-et det bygger mot. For et plugin du har laget på Codexe, ber du om den nye versjonen i prosjektchatten.

Kompilering beviser at pluginet bygger på det nye API-et. Prøv det så på en testserver, fordi endringer i oppførsel mellom versjoner ikke dukker opp som kompileringsfeil.

Spørsmål