كيف تصنع plugin لـ Minecraft

خطوة بخطوة

1. 1.اختر برنامج الخادم والإصدار

   تعمل الـ plugins على الخوادم المبنية على Bukkit: Spigot وPaper وFolia (وBungeeCord وVelocity للبروكسي). اختر إصدار Minecraft الذي يعمل عليه خادمك، من 1.8 إلى 26.x.

2. 2.صف ما يفعله الـ plugin

   اكتب الأوامر والصلاحيات وما يحدث في اللعبة وما يجب أن يكون قابلاً للضبط. مثال: "/sethome و/home و/delhome، بحد أقصى 3 منازل لكل لاعب، وانتظار 3 ثوانٍ، والرسائل في config.yml".

3. 3.دع Codexe يكتبه ويجمّعه

   يكتب Codexe فئات Java وplugin.yml وconfig.yml وpom.xml، وينفّذ بناءً حقيقياً ويصلح أخطاء التجميع قبل أن يعلن المشروع Ready.

4. 4.اختبره على خادم حقيقي

   اضغط «جرّبه الآن» للانضمام إلى خادم Minecraft خاص مثبّت عليه الـ plugin. يشغّل اللاعبون التجريبيون في Codexe كل أمر ويتحققون مما طلبته.

5. 5.نزّل ملف .jar وثبّته

   نزّل ملف .jar المبني وضعه في مجلد plugins/ على خادمك وأعد تشغيل الخادم. تظهر ملفات الإعدادات في plugins/<PluginName>/.

ما هو الـ plugin لـ Minecraft

الـ plugin ملف .jar يحمّله خادم Minecraft من مجلد plugins/. يضيف أوامر وقواعد لعب واقتصاداً وألعاباً مصغرة أو أي شيء آخر، على الخادم فقط: ينضم اللاعبون باللعبة العادية، دون حاجة إلى mods.

تُكتب الـ plugins بلغة Java (أو Kotlin) وفق API الخادم: Spigot وPaper لخوادم اللعب، وBungeeCord أو Velocity للبروكسي. ويحتاج الـ plugin أيضاً إلى ملف plugin.yml يخبر الخادم باسمه وفئته الرئيسية وأوامره وصلاحياته.

الطريقة اليدوية: Java وMaven وAPI الخاص بـ Spigot أو Paper

تعلّمها أطول لكنها تمنح تحكماً كاملاً. ينتج Codexe النوع نفسه من المشاريع، فيمكنك البدء من plugin مولَّد ومتابعة العمل يدوياً.

1. ثبّت JDK (Java 21 للإصدارات من 1.20.5 إلى 1.21.x، وJava 25 للإصدارات 26.x) وبيئة تطوير مثل IntelliJ IDEA.
2. أنشئ مشروع Maven أو Gradle وأضف اعتمادية paper-api أو spigot-api لإصدارك، بنطاق provided.
3. اكتب فئة رئيسية تمتد من JavaPlugin، مع onEnable() وonDisable().
4. أضف plugin.yml في src/main/resources مع name وversion وmain وapi-version وأوامرك.
5. سجّل الأوامر بـ getCommand("name").setExecutor(...) والمستمعين بـ getServer().getPluginManager().registerEvents(...).
6. ابنِ بـ mvn package، وانسخ ملف .jar من target/ إلى مجلد plugins/ على خادم تجريبي وأعد التشغيل.

أسئلة