איך לעדכן פלאגין לגרסת 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.בדקו על הגרסה החדשה

   טענו אותו בשרת של הגרסה החדשה עם אותם פלאגינים, ונסו כל פקודה ותכונה, לא רק את העלייה.

מה בדרך כלל נשבר

• שמות של חומרים ו-enums: עדכון 1.13 שינה את השמות של רוב הפריטים והבלוקים; גרסאות מאוחרות יותר מוסיפות, משנות או מסירות חלק מהם. קוד שמשתמש בשמות ישנים או במזהים מספריים נכשל.
• מתודות deprecated שהוסרו: מתודות שסומנו כ-deprecated במשך כמה גרסאות נעלמות בסוף.
• נתוני פריטים: מ-1.20.5, ה-NBT של פריטים הוחלף ב-data components. פלאגינים שעורכים NBT של פריטים ישירות צריכים לכתוב את החלק הזה מחדש; ה-API הרגיל של ItemMeta ממשיך לעבוד.
• NMS ו-reflection: קוד שמשתמש במחלקות פנימיות של השרת נשבר כמעט בכל גרסה. החליפו אותו ב-API כשאפשר, או בספרייה כמו ProtocolLib.
• גרסאות של ספריות: ספריות ארוזות שנבנו ל-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 החדש. אחר כך נסו אותו בשרת בדיקה, כי שינויי התנהגות בין גרסאות לא מופיעים כשגיאות קומפילציה.

שאלות