plugins لـ Spigot وPaper

تنتج أنواع Bukkit/Spigot/Paper plugin خادم يعمل على Paper وSpigot والنسخ المشتقة منهما. اختر Java (مشروع Maven) أو Kotlin (مشروع Gradle مع build.gradle.kts).

لتجربة الـ plugin داخل اللعبة، شغّل خادماً تجريبياً خاصاً عبر جرّبه الآن.

عندما ترسل الطلب، يسألك Codexe عن إصدار Minecraft المقصود للـ plugin، من 1.8.8 إلى 26.3. يُكتب الكود لـ API ذلك الإصدار ومستوى Java الخاص به، ويعمل الخادم التجريبي بذلك الإصدار. أما المشاريع المنشأة قبل 30 September 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 الـ plugin قبل أن يصفه بأنه Ready، ويتأكد من أن ملف JAR يحتوي على الفئات وعلى plugin.yml (أو paper-plugin.yml). يستغرق بناء الـ plugins عادةً أقل من دقيقة بكثير. راجع التجميع.

#التثبيت

نزّل ملف JAR، وضعه في plugins/، وأعد تشغيل الخادم (لا تستخدم /reload)، وراجع وحدة التحكم بحثاً عن أخطاء عند الإقلاع.

#المشكلات الشائعة