دليل
كيف تصنع plugin لـ Spigot
حُدّث في 7 أكتوبر 2026
يستخدم الـ plugin لـ Spigot واجهة Bukkit/Spigot API، فيعمل على Spigot وعلى كل فروعه، بما فيها Paper. وهذا يجعله الخيار الأوسع عندما لا تعرف أين سيعمل الـ plugin. يغطي هذا الدليل المشروع والكود والبناء.
عدّل المثال ليناسب خادمك.
ولّد هذا بـ Codexeخطوة بخطوة
1.أعدّ Java وأداة بناء
ثبّت JDK المطابق لإصدار Minecraft (17 أو 21 أو 25) واستخدم Maven أو Gradle.
2.أضف Spigot API
أضف
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 وبأسماء مواد مختلفة)، لذا يجب كتابة الـ plugin لذلك الإصدار لا نسخه من درس لـ 1.21. يسأل Codexe عن الإصدار ويكتب الكود لذلك الـ API.
مع Codexe
صف الـ plugin واذكر "Spigot" مع الإصدار. يولّد Codexe مشروع Maven ويجمّعه ويصلح الأخطاء، ويتيح لك اختباره على خادم تجريبي بذلك الإصدار قبل أن تنزّله.
أسئلة
هل أحتاج إلى BuildTools؟
فقط لتشغيل خادم Spigot أو لاستخدام NMS (كود الخادم الداخلي). أما للتجميع مقابل الـ API العادي فتكفي اعتمادية spigot-api.
plugin لـ Spigot أم لـ Paper؟
Spigot إذا كان يجب أن يعمل في كل مكان؛ وPaper إذا كان خادمك يعمل بـ Paper وتريد الـ API الإضافي فيه. راجع كيف تصنع plugin لـ Paper.
اصنع plugin لـ Spigot
يُفتح هذا الوصف جاهزاً للإرسال:
“plugin لـ Spigot 1.8.8 باسم Kits: الأمر /kit <name> يعطي مجموعة عناصر قابلة للضبط مع مهلة انتظار لكل كِت، والكِتات معرّفة في config.yml، وصلاحية kits.<name> لكل كِت، وتُحفظ مهل الانتظار عبر إعادات التشغيل.”
ولّد هذا بـ Codexe