CrazyCrates — إضافة لإدراج صناديق مخصصة ومكافآت في Minecraft

CrazyCrates — إضافة لإدراج صناديق مخصصة ومكافآت في Minecraft

يتيح لك CrazyCrates إضافة صناديق (crates) إلى خادم Minecraft. كل صندوق عبارة عن كتلة في العالم أو عنصر في قائمة يفتحه اللاعب بمفتاح لتلقي جائزة عشوائية. توفر الإضافة 11 نوعًا مختلفًا من الرسوم المتحركة، ونوعين من المفاتيح — مادية (عناصر في المخزون) وافتراضية (مخزنة في قاعدة البيانات) — ونظام فرص يعتمد على الوزن بدلاً من النسب المئوية. يتم توزيعه مجانًا. 

القائمة الرئيسية /crates مع عرض الصناديق كعناصر في المخزون 

أنواع الصناديق 

كل صندوق على الخادم هو ملف .yml مستقل في مجلد crates/. يحتوي الملف على معامل CrateType، الذي يحدد رسوم الفتح المتحركة.

عند التشغيل الأول، تقوم الإضافة بإنشاء 6 أمثلة جاهزة تغطي 5 أنواع مؤكدة. يمكنك فتح أي منها لاختباره بدون مفتاح باستخدام الأمر /crazycrates forceopen <اسم_الملف> <الاسم>.

جميع الصناديق الأساسية المتاحة 

Scroll - يظهر شريط أفقي من العناصر في المخزون، يمرر لأسفل، يتباطأ تدريجياً، ويتوقف عند العنصر الفائز في المنتصف. يستخدم هذا النوع في مثالين — CrateExample.yml و AdvancedExample.yml.

تنفيذ CrateExample — شريط أفقي يمرر ويتوقف عند الفائز

Cosmic — تظهر عدة جوائز في المخزون للاختيار من بينها. ينقر اللاعب على الجائزة التي يريد أن يأخذها. إذا لم يتم اختيار أي شيء في غضون 10 ثوانٍ، تمنح الإضافة جائزة واحدة تلقائيًا. Casino — صندوق بمستويات (tiers). تحدد الرسوم المتحركة المستوى أولاً، ثم داخل المستوى — الجائزة المحددة. 

QuadCrate — عند الفتح، تظهر أربع كتل مادية حول اللاعب في العالم. يقترب اللاعب من كل واحدة ويفتحها واحدة تلو الأخرى — كل منها يعطي جائزة منفصلة. 

Wonder — تظهر نافذة بمخزون كامل تختفي منها العناصر تدريجياً؛ العنصر الذي يبقى سيكون الجائزة.

المفاتيح

يستخدم كل صندوق مفتاحه الخاص. المفتاح المادي — هو عنصر عادي بمظهر واسم ووصف (lore) مخصص، يحتفظ به اللاعب في مخزونه. لا يشغل المفتاح الافتراضي مساحة — فهو مخزن في قاعدة بيانات الإضافة ومرتبط بحساب اللاعب.

افتراضيًا، تقبل كتلة الصندوق المادية كلا النوعين. يمكن تغيير السلوك في config.yml بشكل منفصل لكل تركيبة.

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

يمكن للمسؤولين إعطاء وأخذ المفاتيح حتى من اللاعبين غير المتصلين بالإنترنت، أو توزيع مفتاح على جميع اللاعبين عبر الإنترنت مرة واحدة من خلال أمر واحد، أو إعطاء مفتاح عشوائي من جميع الصناديق المتاحة. يمكن للاعبين الذين لديهم إذن مناسب نقل مفاتيحهم الافتراضية للآخرين.

مفتاح مادي لصندوق — عنصر بوصف مخصص

نظام الفرص 

لا يتم تحديد احتمالية كل جائزة بالنسب المئوية، بل بالوزن — معامل Weight في ملف الصندوق. كلما ارتفعت قيمة الوزن، زاد معدل سقوط الجائزة؛ وكلما كانت أقل، قل معدل سقوطها.

الحد الأقصى للنطاق هو مجموع الأوزان في الصندوق. إذا كانت ثلاث جوائز لها أوزان 10 و 15 و 25، فإن النطاق هو 50. فرصة الأولى هي 20٪، والثانية — 30٪، والثالثة — 50٪.

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

الأوامر

أمر الإضافة الرئيسي هو /crazycrates، مع الاختصارات /crates و /cc. لا يمكن للاعبين الوصول إلا إلى /keys (عرض مفاتيحهم) و /crates (فتح القائمة).

أوامر المشرفين:

• /crazycrates give و /crazycrates take — إعطاء أو أخذ مفتاح من لاعب معين، بما في ذلك غير المتصلين.

• /crazycrates giveall — توزيع مفتاح على جميع اللاعبين عبر الإنترنت في وقت واحد.

• /crazycrates forceopen — فتح صندوق للاعب مجانًا، بدون مفتاح.

• /crazycrates editor — وضع وضع الصندوق في العالم: تشير إلى كتلة وتربط صندوقًا بها.

• /crazycrates debug — الحصول على جميع جوائز الصندوق مرة واحدة لاختبار الإعدادات.

• /crazycrates mass-open — فتح شامل لعدد محدد من الصناديق في وقت واحد.

• /crazycrates reload — إعادة تحميل جميع التكوينات دون إعادة تشغيل الخادم.

• /crazycrates migrate — استيراد صناديق من إضافات أخرى أو تحويل التنسيق القديم للملفات.

تنقسم الأذونات إلى ثلاثة بدائل (wildcards): crazycrates.players.* للاعبين، crazycrates.admin.* للمسؤولين، crazycrates.schematic.* للعمل مع schematics. يمكن استبعاد اللاعب من التوزيع الشامل /giveall من خلال إذن منفصل.

الإعدادات

تقع جميع ملفات الإضافة في مجلد plugins/CrazyCrates/. الملف الرئيسي هو config.yml، حيث تتركز إعدادات الخادم العالمية. يتم تخزين الصناديق في المجلد الفرعي crates/ — كل منها في ملف منفصل. يحتوي المجلد examples/ على أمثلة من المطورين، ولكن لا ينبغي تعديلها: حيث يتم استبدالها بالكامل مع كل إعادة تحميل /crazycrates reload. يتم استخراج جميع نصوص الرسائل إلى messages.yml وتعديلها بشكل منفصل.

في config.yml، يجب الانتباه إلى بعض الأمور. تظهر الصور المجسمة (holograms) فوق الصناديق تلقائيًا إذا تم تثبيت DecentHolograms أو FancyHolograms أو CMI على الخادم — حيث تلتقطها الإضافة بنفسها. إذا لم يكن هناك أي منها، فلن تكون هناك صور مجسمة. يمكن توجيه الرسائل للاعبين إما في الدردشة أو في شريط الإجراءات (action bar) — اعتمادًا على كيفية إعداد الخادم. يتم تمكين تسجيل الإجراءات بالمفاتيح والصناديق بشكل منفصل للوحة التحكم وللملف؛ يتم ضغط ملفات السجل إلى ملف zip عند إعادة التشغيل.

يتم إعداد كل صندوق في ملفه الخاص. إلى جانب نوع الرسوم المتحركة وقائمة الجوائز، فإنه يحدد شكل المفتاح المادي، ونص الصورة المجسمة فوق الكتلة، وحجم وتصميم نافذة المعاينة، والأصوات أثناء التمرير وعند الانتهاء، بالإضافة إلى إمكانية إعادة تدوير (reroll) الجائزة إذا لم تكن النتيجة مُرضية.

استنتاج

يضيف CrazyCrates أنظمة رسوم متحركة لكل من متاجر التبرع والتقدم داخل اللعبة في وضع البقاء على قيد الحياة. نظام الفرص القائم على الوزن أكثر ملاءمة من النسب المئوية عند التعديل بنشاط — ليست هناك حاجة لإعادة حساب القائمة بأكملها في كل مرة.

بالنسبة لخوادم PvP والبقاء على قيد الحياة مع نظام التبرع، يعد CrazyCrates خيارًا مناسبًا. لخادم بسيط يتطلب صندوقًا واحدًا بدون رسوم متحركة، فإن QuickCrate والإعدادات البسيطة ستكون كافية.