פלאגינים ל-Spigot ול-Paper
איך לקבל מ-Codexe את הפלאגין הטוב ביותר ל-Bukkit, ל-Spigot או ל-Paper, ב-Java או ב-Kotlin. מה לכתוב בבקשה, גרסאות, plugin.yml, תלויות, הבנייה ובעיות נפוצות.
עודכן
הסוגים Bukkit/Spigot/Paper מפיקים פלאגין שרת שרץ על Paper, על Spigot ועל הגרסאות הנגזרות מהם. בחרו Java (פרויקט Maven) או Kotlin (פרויקט Gradle עם build.gradle.kts).
כדי לשחק עם הפלאגין שלכם במשחק, הפעילו שרת בדיקה פרטי עם נסו עכשיו.
כשאתם שולחים את הבקשה, Codexe שואל לאיזו גרסת Minecraft הפלאגין מיועד, מ-1.8.8 עד 26.3. הקוד נכתב ל-API ולרמת ה-Java של הגרסה הזו, ושרת הבדיקה מריץ את אותה גרסה. פרויקטים שנוצרו לפני 30 בספטמבר 2026 שומרים על הגרסה שכתובה בקובצי הבנייה שלהם.
#מה לכתוב בבקשה
- תוכנת השרת והגרסה: "Paper 1.21.4" או "Spigot 1.20.1". ל-Paper יש API גדול יותר מל-Spigot. קוד שנכתב ל-Spigot רץ על Paper, אבל לא להפך, אז בקשו Spigot אם אתם צריכים את שניהם.
- פקודות עם ארגומנטים, מי יכול להשתמש בהן והשלמה אוטומטית ב-Tab.
- הרשאות עם ערכי ברירת המחדל שלהן (
true,op,false). - המפתחות ב-config.yml שאתם רוצים שיהיה אפשר לערוך.
- אחסון: YAML, SQLite, MySQL, או בזיכרון.
- אינטגרציות: Vault, PlaceholderAPI, LuckPerms, WorldGuard…, בשמן המפורש, כדי שיתווספו כתלויות.
A Paper 1.21.4 plugin (Java) called Bounties.
- /bounty set <player> <amount>: takes money via Vault, adds it to the player's bounty.
- Killing a player with a bounty pays it to the killer.
- /bounty top shows the 10 highest bounties.
- Bounties stored in SQLite. Minimum bounty 100 (config.yml).
- Permission bounties.set (default true).A Paper 1.21.4 plugin in Kotlin called Bounties, same features as above.
Use Kotlin idioms (data classes, extension functions) but keep the Bukkit API usage standard.#מה Codexe יוצר
- פרויקט Maven (Java) או פרויקט Gradle (Kotlin) עם התלות הנכונה ב-API.
- המחלקה הראשית שמרחיבה את
JavaPlugin, ועוד מחלקות של פקודות, מאזינים ואחסון. plugin.ymlעם המחלקה הראשית,api-version, פקודות והרשאות, ו-config.ymlכשיש הגדרות.
name: Bounties
version: 1.0.0
main: eu.codexe.bounties.Bounties
api-version: '1.21'
depend: [Vault]
commands:
bounty:
description: Manage bounties
permissions:
bounties.set:
default: true#גרסאות ו-Java
Codexe קורא את גרסת Minecraft מקובץ הבנייה ובונה עם Java 17 (לפני 1.20.5), עם Java 21 (1.20.5 ומעלה) או עם Java 25 (26.x). אם לא תציינו גרסה, נעשה שימוש ב-API של Paper/Spigot 1.20.6.
#בנייה ואימות
Codexe מקמפל את הפלאגין לפני שהוא מכריז עליו כמוכן ובודק שה-JAR מכיל את המחלקות ואת plugin.yml (או paper-plugin.yml). בנייה של פלאגין לוקחת בדרך כלל הרבה פחות מדקה. ראו קומפילציה.
#התקנה
הורידו את ה-JAR, שימו אותו ב-plugins/, הפעילו את השרת מחדש (אל תשתמשו ב-/reload), ובדקו בקונסולה אם יש שגיאות בעלייה.
#בעיות נפוצות
| תסמין | סיבה סבירה |
|---|---|
| הפלאגין לא נטען, "main class not found" | השדה main: ב-plugin.yml לא תואם למחלקה. בקשו מהצ'אט לתקן את זה, או בדקו אחרי שינויי שמות ידניים. |
| "Unsupported API version" על שרת ישן יותר | הפלאגין מכוון ל-API חדש יותר מזה של השרת שלכם. ציינו בבקשה את הגרסה המדויקת של השרת. |
| פקודה לא עושה כלום | הפקודה חסרה ב-plugin.yml, או שלשחקן אין את ההרשאה. |
NoClassDefFoundError עבור Vault או משהו דומה | הפלאגין שתלויים בו לא מותקן על השרת. |
| נבנה, אבל יכולת מתנהגת לא כמו שצריך | תארו בצ'אט את ההתנהגות המדויקת במשחק. האימות בודק את הבנייה, לא את המשחק עצמו. |