Sådan opdaterer du et plugin til en ny Minecraft-version

Trin for trin

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

   Læg den på en testserver med den nye version, og læs konsollen. Hvis den indlæses og virker, behøver du måske ikke ændre noget.

2. 2.Ændr API-afhængigheden

   Sæt paper-api eller spigot-api til den nye version i pom.xml eller build.gradle.

3. 3.Opdatér api-version og Java

   Sæt api-version i plugin.yml (for eksempel '1.21'), og kompilér til den Java, som den nye version kræver: Java 17 før 1.20.5, Java 21 fra 1.20.5, Java 25 til 26.x.

4. 4.Ret det, der ikke længere kompilerer

   Byg, og gå fejlene igennem: omdøbte materialer, fjernede metoder, ændrede event-klasser. Compileren viser dem med fil og linje.

5. 5.Opdatér afhængigheder

   Plugins, som dit plugin bruger (Vault, PlaceholderAPI, ProtocolLib, WorldGuard), skal også være i versioner, der understøtter den nye Minecraft-version, både i buildfilen og på serveren.

6. 6.Test på den nye version

   Indlæs det på en server med den nye version og de samme plugins, og prøv hver kommando og funktion, ikke kun opstarten.

Hvad der typisk går i stykker

• Navne på materialer og enums: 1.13-opdateringen omdøbte de fleste genstande og blokke; senere versioner tilføjer, omdøber eller fjerner nogle. Kode, der bruger gamle navne eller numeriske id'er, fejler.
• Forældede metoder fjernet: metoder, der har været markeret som deprecated i flere versioner, forsvinder til sidst.
• Genstandsdata: fra 1.20.5 blev NBT på genstande erstattet af data components. Plugins, der redigerer genstandes NBT direkte, skal have den del omskrevet; den normale ItemMeta-API virker stadig.
• NMS og reflection: kode, der bruger serverens interne klasser, går i stykker på næsten hver version. Erstat den med API'en, hvor det er muligt, eller med et bibliotek som ProtocolLib.
• Biblioteksversioner: shadede biblioteker bygget til en ældre Java kan fejle på den nye.

Opdatering på tværs af mange versioner

At gå fra 1.8 eller 1.12 til 1.21 er tættere på en omskrivning af de dele, der rører genstande, blokke og partikler, end på en opdatering. Gør det i én omgang mod den nye API, ikke version for version, og regn med, at konfigurationsfilerne også skal have nye materialenavne.

Hvis pluginet skal understøtte flere versioner på én gang, så kompilér mod den ældste, du understøtter, og undgå API, der er tilføjet senere, eller brug separate builds pr. version.

Med Codexe

På Pro og opefter kan du importere pluginets kildekode som en ZIP og f.eks. skrive "Det her er mit Paper 1.20.4-plugin. Opdatér det til Paper 1.21.4". Codexe læser Minecraft-versionen fra buildfilen, bygger med den Java, versionen kræver, og retter kompileringsfejl ud fra de rigtige signaturer i den API, der bygges mod. For et plugin, du har lavet på Codexe, beder du om den nye version i projektchatten.

At det kompilerer, beviser, at pluginet kan bygges mod den nye API. Prøv det derefter på en testserver, for ændringer i opførsel mellem versioner viser sig ikke som kompileringsfejl.

Spørgsmål