Како ажурирати плагин на нову Minecraft верзију

Корак по корак

1. 1.Прво пробај стари .jar

   Стави га на тест сервер нове верзије и прочитај конзолу. Ако се учита и ради, можда не мораш ништа да мењаш.

2. 2.Промени API зависност

   У pom.xml или build.gradle постави paper-api или spigot-api на нову верзију.

3. 3.Ажурирај api-version и Java-у

   Постави api-version у plugin.yml (на пример '1.21') и компајлирај за Java-у коју тражи нова верзија: Java 17 пре 1.20.5, Java 21 од 1.20.5, Java 25 за 26.x.

4. 4.Поправи оно што се више не компајлира

   Направи билд и прођи кроз грешке: преименовани материјали, уклоњене методе, промењене класе догађаја. Компајлер их наводи са фајлом и редом.

5. 5.Ажурирај зависности

   Плагини које твој плагин користи (Vault, PlaceholderAPI, ProtocolLib, WorldGuard) такође морају да имају верзије које подржавају нову Minecraft верзију, и у билд фајлу и на серверу.

6. 6.Тестирај на новој верзији

   Учитај га на серверу нове верзије са истим плагинима и испробај сваку команду и функцију, а не само покретање.

Шта се обично поквари

• Називи материјала и enum-а: ажурирање 1.13 преименовало је већину предмета и блокова; касније верзије неке додају, преименују или уклањају. Код који користи старе називе или нумеричке id-јеве пада.
• Уклоњене застареле методе: методе означене као застареле кроз више верзија на крају нестану.
• Подаци предмета: од 1.20.5 NBT предмета је замењен компонентама података. Плагини који директно мењају NBT предмета морају тај део да препишу; обичан ItemMeta API наставља да ради.
• NMS и рефлексија: код који користи интерне класе сервера квари се скоро на свакој верзији. Где је могуће замени га API-јем или библиотеком као што је ProtocolLib.
• Верзије библиотека: shade-оване библиотеке направљене за старију Java-у могу да не раде на новој.

Ажурирање кроз много верзија

Прелазак са 1.8 или 1.12 на 1.21 више личи на поновно писање делова који дирају предмете, блокове и честице него на ажурирање. Уради то у једном потезу над новим API-јем, а не верзију по верзију, и рачунај да ће и конфигурационим фајловима требати нови називи материјала.

Ако плагин мора да подржава више верзија истовремено, компајлирај над најстаријом коју подржаваш и избегавај API додат касније или користи посебне билдове за сваку верзију.

Уз Codexe

На Pro плану и вишим можеш да увезеш изворни код плагина као ZIP и затражиш, на пример: „Ово је мој Paper 1.20.4 плагин. Ажурирај га на Paper 1.21.4“. Codexe чита Minecraft верзију из билд фајла, гради са Java-ом коју та верзија тражи и поправља грешке при компајлирању користећи праве потписе API-ја над којим гради. За плагин који си направио на Codexe-у, затражи нову верзију у чету пројекта.

Компајлирање доказује да се плагин гради над новим API-јем. Затим га испробај на тест серверу, јер се промене у понашању између верзија не појављују као грешке при компајлирању.

Питања