creator-mods-suite

# Creator Mods Suite **Creator Mods Suite** هي مجموعة تعديلات شاملة مصممة خصيصًا لمبدعي محتوى Minecraft، ويوتيوبرز، والبث المباشر الذين يلعبون الإصدار 1.21.1. توفر مجموعة من ثماني ميزات قابلة للتبديل بشكل مستقل تعزز أسلوب اللعب لأغراض التسجيل، وتدعم كلاً من NeoForge وFabric ضمن قاعدة كود واحدة متعددة المحملات. ## الغرض الأساسي تعمل المجموعة كـ"صندوق أدوات المخرج" لماينكرافت، مما يسمح للمبدعين بتشغيل أحداث معقدة، وإدارة زوايا الكاميرا، وتعديل قواعد اللعبة أثناء التشغيل باستخدام الأوامر أو اختصارات المفاتيح. يلغي هذا الحاجة إلى الإيقاف المؤقت، أو الخروج إلى القوائم، أو إعادة تشغيل اللعبة أثناء جلسات التسجيل، مما يضمن لقطات سلسة واحترافية. ## الميزات الرئيسية تتكون المجموعة من ثماني وحدات مميزة، كل منها يخدم وظيفة إبداعية محددة: 1. **Director's Toolkit (`/toolkit`)**: أداة مساعدة للتسجيل تتميز بلوحة كلاكيت على الشاشة، وعلامات اللقطات، ومفاتيح تجميد للوحوش/اللاعبين، ومولّدات موجات، ولقطات سريعة للساحة، وإشارات مرجعية للكاميرا، ومفاتيح تبديل واجهة HUD للإطار النظيف. تتيح تحكمًا دقيقًا في لقطات التسجيل. 2. **Ashen Colossus (`/colossus`)**: معركة زعيم متحركة من ثلاث مراحل مدعومة بـ GeckoLib. تتضمن آليات مثل ضربات الموجة الصادمة، ومطر الحمم، وموجات الأتباع، ومرحلة غضب بحلقة من النار. 3. **Power Kit (`/power`)**: يوفر ست قدرات مفعّلة باختصارات المفاتيح مثل الاندفاع، والانفجار الناري، والضربة الأرضية، وسحب الإندر، وقبة الدرع، وتجميد الوحوش. تتضمن فترات تهدئة خاضعة للخادم وتغذية بصرية عبر صف في شريط الأدوات السريع. 4. **Rule Engine (`/rule`, `/shop`)**: يسمح بتعديل قواعد اللعبة مباشرةً مع أحد عشر خيارًا قابلاً للتراكم (مثل الإسقاطات العشوائية، والصناعة المضاعفة، وأرضيات الحمم، والوحوش العملاقة). يدعم إعدادات مسبقة لحزم البيانات لتبديل سهل. 5. **Evolve (`/evolve`)**: نظام تحول للاعب من خمس مراحل حيث يكتسب اللاعبون حجمًا وتعزيزات إحصائية وقدرات سلبية عند كل درجة، مصحوبة بتأثيرات جسيمية وتبديل النماذج. 6. **Event Director (`/event`)**: يشغّل أحداثًا عالمية موجهة مثل أقمار الدم، والنيازك، والحصارات، والأمطار المحظوظة، وصعود الفراغ. الأحداث قائمة على المراحل ويمكن إعادة توقيتها أو تخطيها أو إيقافها عبر الأوامر. 7. **Arsenal (`/arsenal`)**: يقدم أربعة أسلحة فريدة: Grapple Blade، وStorm Bow، وGravity Hammer، وSoul Scythe، لكل منها تفاعلات ميكانيكية مميزة. 8. **Cursed Vault (`/vault`)**: هيكل زنزانة من نوع jigsaw يحتوي على مذبح ملعون يستدعي زعيمًا صغيرًا (Vault Keeper) وصناديق مختومة تُفتح عند هزيمته. يتضمن ميزة إعادة تعيين بأمر واحد. ## تصميم يركز على المبدع * **التحكم عبر سطر الأوامر**: كل ميزة قابلة للتحكم عبر أوامر الدردشة (مثل `/colossus phase 3`، `/event skip`)، مما يتيح تعديلات فورية دون مقاطعة أسلوب اللعب. * **الوضع الصامت**: يمكن تكوين الأوامر لإخراج التغذية الراجعة فقط إلى شريط الإجراءات بدلاً من سجل الدردشة، مما يمنع الفوضى في اللقطات المسجلة مع إبقاء رسائل الخطأ مرئية للمشغل. * **تبديل مستقل**: يمكن تمكين أو تعطيل كل من الميزات الثماني بشكل فردي عبر التكوين أو الأوامر. الميزات المعطلة لا تسجل أي شيء في عالم اللعبة، مما يضمن عدم وجود حمل أداء أو تداخل بصري عند عدم الاستخدام. * **واجهة HUD غير تدخلية**: جميع طبقات HUD المخصصة تحترم وضع ملء الشاشة F1 الأصلي ويمكن تنظيفها لكل لاعب باستخدام الأوامر، مما يساعد في إعدادات الكاميرات المتعددة. * **سلامة الكاميرا**: يتم تجاهل اللاعبين في أوضاع الإبداع أو المتفرج من قبل الميكانيكا العدائية (هجمات الزعماء، المخاطر البيئية)، مما يسمح لمشغلي الكاميرا بالطيران عبر المشاهد بأمان. ## التفاصيل التقنية * **التوافق**: يدعم Minecraft 1.21.1 مع NeoForge 21.1.250+ وFabric Loader 0.19.5+. يتطلب Java 21. * **البنية**: يستخدم وحدة `common/` مشتركة لمنطق أسلوب اللعب، مع وحدات `fabric/` و`neoforge/` منفصلة لنقاط الدخول والميكسينات الخاصة بالمنصة. يضمن هذا سلوكًا متطابقًا عبر المحملات. * **التكوين**: يُدار عبر ملف واحد `config/creatormods.json`. قيم التوازن ثوابت مضمّنة؛ البيانات الديناميكية تستخدم حزم بيانات Minecraft. * **الاختبار**: يتضمن المشروع اختبارات موسعة، تشمل 486 اختبار وحدة JUnit 5 و134 اختبار GameTests داخل العالم لكل محمل، تغطي المنطق والشبكات وسيناريوهات أسلوب اللعب التفاعلية. * **الأصول**: الأصول الحالية هي عناصر نائبة مولّدة برمجيًا (نسيج Python، صوت ffmpeg) لضمان تشغيل التعديل دون موارد مفقودة. الأصول الفنية الحقيقية مخطط لها ولكن لم تُضمّن بعد. ## التثبيت يجب على المستخدمين بناء التعديل من المصدر أو استخدام ملفات JAR المقدمة إن وُجدت. تشمل التبعيات GeckoLib (مطلوب للرسوم المتحركة) وFabric API (لبنيات Fabric). يجب تثبيت التعديل على كل من العميل والخادم للحصول على الوظائف الكاملة. ## الترخيص المشروع مرخص تحت MIT License، مما يسمح بالتفريع والتعديل والاستخدام الخاص على الخوادم دون إلزام بنشر التغييرات.