איך יוצרים פלאגין ל-Paper

שלב אחר שלב

1. 1.בחרו את גרסת Minecraft

   השתמשו בגרסה שהשרת שלכם מריץ. היא קובעת את גרסת Java: Java 17 לפני 1.20.5, Java 21 מ-1.20.5, Java 25 ל-26.x.

2. 2.צרו את הפרויקט

   פרויקט Gradle או Maven עם התלות paper-api לגרסה הזו, ממאגר PaperMC, בהיקף provided/compileOnly.

3. 3.כתבו את המחלקה הראשית

   מחלקה שמרחיבה את JavaPlugin, עם onEnable() שרושם פקודות ומאזינים.

4. 4.תארו את הפלאגין לשרת

   plugin.yml (name, version, main, api-version, commands, permissions). Paper תומך גם ב-paper-plugin.yml, עם כללי טעינה משלו.

5. 5.בנו ובדקו

   בנו את ה-.jar, שימו אותו בתיקיית plugins/ של שרת בדיקה של Paper, הפעילו אותו ובדקו בקונסולה אם יש שגיאות.

Paper או Spigot?

קוד שנכתב ל-API של Spigot רץ על Paper, אבל לא להפך: Paper מוסיף אירועים ושיטות (למשל רכיבי הטקסט של Adventure והרבה ממשקי API אסינכרוניים) שאין ב-Spigot. כתבו ל-Paper אם השרת שלכם מריץ Paper; כתבו ל-Spigot אם הפלאגין חייב לרוץ גם על שרתי Spigot.

הדרך המהירה

ב-Codexe, בחרו פלאגין Bukkit/Spigot/Paper, כתבו "Paper" ואת הגרסה בבקשה, ותארו מה הוא עושה. Codexe מקים את הפרויקט ואת גרסת ה-Java הנכונה, מקמפל אותו, מתקן שגיאות בנייה ונותן לכם להצטרף לשרת בדיקה של Paper עם הפלאגין מותקן.

בעיות נפוצות

• UnsupportedClassVersionError: הפלאגין קומפל עם Java חדש יותר ממה שהשרת מריץ.
• NoSuchMethodError / NoClassDefFoundError: הפלאגין משתמש ב-API שלא קיים בגרסת השרת, או שתלות לא נארזה (shade) לתוך ה-.jar.
• הפלאגין נטען אבל הפקודות לא עושות כלום: הפקודה חסרה ב-plugin.yml או שה-executor לא רשום.

שאלות