مشروعك الأول

تبني هذه الجولة plugin صغيراً لكنه حقيقي، لترى كل مرحلة مرة واحدة. ينطبق المسار نفسه على كل أنواع المشاريع.

#الطلب

في صفحة إنشاء، اختر Plugin لـ Bukkit/Spigot/Paper (Java) واكتب:

A Paper 1.21.4 plugin called SimpleHomes.
- /sethome saves the player's current location as their home (one home per player).
- /home teleports them there after a 3 second warm-up; moving cancels it.
- 30 second cooldown on /home, configurable in config.yml.
- Homes persist across restarts in a YAML file.
- Permissions: simplehomes.use (default true), simplehomes.bypasscooldown (default op).
- Messages configurable in config.yml, with color codes.

لاحظ ما يحتويه: المنصة والإصدار، وكل أمر وما يفعله، وقواعد التوقيت، والتخزين، والصلاحيات، وما يجب أن يكون قابلاً للضبط. هذا ما يجعل النتيجة الأولى صالحة للاستخدام.

#ما الذي يحدث بعد ذلك

1. يبثّ Codexe الملفات: ملف Maven pom.xml، والفئة الرئيسية، وفئات الأوامر والمستمعين، وplugin.yml وconfig.yml.
2. يتحوّل الشريط إلى جارٍ فحص المشروع… ثم جارٍ البناء…، ويجمّع Codexe الـ plugin.
3. إذا أبلغ المترجم عن خطأ (مثل استيراد خاطئ)، فسترى جارٍ إصلاح مشكلة…. يصلح Codexe الكود ويبني من جديد، وهذا لا يستهلك توكناتك.
4. يصبح المشروع Ready.

#افحص النتيجة

• افتح plugin.yml وتأكد أن الأوامر والصلاحيات تطابق ما طلبته.
• افتح config.yml: يجب أن تجد فيه مدة الانتظار والرسائل.
• ألقِ نظرة سريعة على الفئة الرئيسية. لا تحتاج إلى فهم كل سطر، لكن يمكنك ملاحظة النواقص الواضحة.

#غيّر شيئاً

في محادثة المشروع، اكتب:

Allow up to 3 named homes per player: /sethome <name>, /home <name>, /delhome <name>, /homes to list them.

يعدّل Codexe الملفات الموجودة بدلاً من البدء من الصفر. تكلّف طلبات المتابعة أقل بكثير من مشروع جديد لأن الملفات المتأثرة وحدها هي التي تُعاد كتابتها. وعندما يمسّ التغيير مشروعاً قابلاً للبناء، يتحقق منه Codexe مرة أخرى.

#ابنِه واختبره

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

#التالي

• كيف تكتب طلباً جيداً
• العمل مع الذكاء الاصطناعي
• دليل Spigot وPaper