مولّد plugin.yml

plugin.yml هو ملف YAML صغير يخبر Spigot و Paper و Purpur كيفية تحميل الإضافة الخاصة بك: الاسم، الفئة الرئيسية، الإصدار، هدف API، الأوامر، والصلاحيات. هذا المولد يملأ هذه الحقول المعتادة حتى لا تكتب YAML هشًا يدويًا بعد كل إعادة تسمية مشروع. لا يكتب Java، ولا يجمع jar، ولا يصلح مسار فئة رئيسية مكسور.

تقوم بإدخال اسم الإضافة، الفئة الرئيسية، الإصدار، المؤلفين الاختياريين، الوصف، الموقع الإلكتروني، api-version، قوائم depend/softdepend، ثم الأوامر والصلاحيات إذا كنت بحاجة إليها. تقوم الصفحة ببناء plugin.yml يمكنك تنزيله أو لصقه في src/main/resources. هذا يحافظ على السقالة الأولى وإصلاحات "أحتاج فقط أمرًا واحدًا إضافيًا في /help" قصيرة.

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

يجب أن يكون api-version قريبًا من إصدار Minecraft الذي تبني عليه حتى يتمكن Paper من التحذير من واجهات برمجة التطبيقات غير المتوافقة. depend و softdepend يساعدان فقط عندما تكون تلك الإضافات موجودة فعليًا على الخادم الهدف. الأسماء الخاطئة هنا لا تقوم بتنزيل أي شيء؛ فهي تغير فقط ترتيب التحميل وسلوك التمكين.

يمكن أن يحمل كل أمر وصفًا وسطر استخدام وعقدة صلاحية. يمكن لكل صلاحية تعيين افتراضي (op، true، false، not op). حافظ على ثبات الأسماء بمجرد أن يبدأ اللاعبون ومجموعات LuckPerms في استخدامها؛ إعادة تسمية عقدة لاحقًا تعني ترحيل التكوينات على الخوادم الحية.

في مشروع Maven أو Gradle عادي، يكون الملف تحت resources بحيث ينتهي به الأمر في جذر jar كـ plugin.yml. بعد إعادة البناء، تأكد من أن الجرة لا تزال تحتوي على هذا الملف قبل إلقاء اللوم على المولد. لوحات الاستضافة التي ترفع "مجلدات الإضافات" لا تزال بحاجة إلى jar صحيح لإضافات نمط Spigot.