מדריך
איך יוצרים פלאגין ל-Spigot
עודכן 7 באוקטובר 2026
פלאגין ל-Spigot משתמש ב-API של Bukkit/Spigot, ולכן הוא רץ על Spigot ועל כל פורק שלו, כולל Paper. זה הופך אותו לבחירה הרחבה ביותר כשלא יודעים איפה הפלאגין ירוץ. המדריך הזה מכסה את הפרויקט, הקוד והבנייה.
שנו את הדוגמה לשרת שלכם.
צרו את זה עם Codexeשלב אחר שלב
1.הקימו Java וכלי בנייה
התקינו את ה-JDK שמתאים לגרסת Minecraft שלכם (17, 21 או 25) והשתמשו ב-Maven או ב-Gradle.
2.הוסיפו את ה-API של Spigot
הוסיפו
spigot-apiלגרסה שלכם ממאגר Spigot בהיקףprovided. הוא נחוץ רק לקומפילציה; השרת מספק אותו בזמן ריצה.3.כתבו פקודות ומאזינים
רשמו
CommandExecutorעםgetCommand("name").setExecutor(...)ומאזיני אירועים עםregisterEvents.4.כתבו plugin.yml
שם, גרסה, מחלקה ראשית,
api-version(מ-1.13), פקודות והרשאות.5.בנו והתקינו
mvn package, ואז העתיקו את ה-.jar מ-target/לתיקייתplugins/של השרת והפעילו מחדש.
גרסאות ישנות (1.8 עד 1.12)
הרבה שרתי מיני-משחקים עדיין רצים על 1.8. ה-API ישן יותר (אין api-version, שמות חומרים שונים), ולכן פלאגין חייב להיכתב לגרסה הזו ולא להיות מועתק ממדריך של 1.21. Codexe שואל את הגרסה וכותב את הקוד ל-API הזה.
עם Codexe
תארו את הפלאגין וכתבו "Spigot" עם הגרסה. Codexe יוצר את פרויקט Maven, מקמפל אותו, מתקן שגיאות ונותן לבדוק אותו בשרת בדיקה מאותה גרסה לפני ההורדה.
שאלות
האם אני צריך BuildTools?
רק כדי להריץ שרת Spigot או להשתמש ב-NMS (קוד פנימי של השרת). כדי לקמפל מול ה-API הרגיל, התלות spigot-api מספיקה.
פלאגין ל-Spigot או פלאגין ל-Paper?
Spigot אם הוא חייב לרוץ בכל מקום; Paper אם השרת שלכם מריץ Paper ואתם רוצים את ה-API הנוסף שלו. ראו איך יוצרים פלאגין ל-Paper.
יצירת פלאגין ל-Spigot
הפרומפט הזה נפתח מוכן לשליחה:
“פלאגין ל-Spigot 1.8.8 בשם Kits: /kit <name> נותן סט פריטים הניתן להגדרה עם זמן המתנה לכל קיט, הקיטים מוגדרים ב-config.yml, הרשאה kits.<name> לכל קיט, זמני ההמתנה נשמרים בין הפעלות מחדש.”
צרו את זה עם Codexe