إضافة Minecraft SCore

🔌 حول SCore

SCore هو الإضافة الأساسية/المكتبة التي تنتجها Ssomar لتجميع الوظائف المشتركة المستخدمة عبر حزمة إضافاتهم في مكان واحد. يوفّر محررات داخل اللعبة وميزات وقت التشغيل التي تعتمد عليها إضافات Ssomar الأخرى، ويمكن استخدامه أيضًا بشكل مستقل لإنشاء وتشغيل المقذوفات المخصصة، وإدارة المتغيرات، وتنفيذ الأوامر المخصصة المجمعة.

🎯 الغرض

يوجد SCore لتوفير أساس قابل لإعادة الاستخدام لمطوري الإضافات (وخاصة عائلة إضافات Ssomar) بحيث تُنفَّذ الميزات مرة واحدة وتُستخدم من قِبل عدة إضافات. وهو موجّه للمطورين ومديري الخوادم الذين يشغّلون إضافة واحدة أو أكثر من إضافات Ssomar أو الذين يريدون إتاحة آلياته القابلة لإعادة الاستخدام على خوادمهم.

⚙️ الميزات

• محرر داخل اللعبة لإنشاء المقذوفات المخصصة وتحريرها.
• مقذوفات مخصصة وقت التشغيل يمكن إطلاقها أو تفعيلها.
• متغيرات عامة ومتغيرات لكل لاعب بأنواع (NUMBER, STRING, LIST).
• دعم العناصر النائبة للمتغيرات (رموز placeholder لاستخدامها في إضافات/إعدادات أخرى).
• إطار تنفيذ الأوامر المجمعة/المخصصة يمكن الوصول إليه من وحدة تحكم الخادم أو من إضافات أخرى.
• مصمم ليُستخدم كاعتمادية من قِبل إضافات Ssomar الأخرى.

🧩 لمن هذا؟

• مالكو الخوادم الذين يشغّلون إضافات Ssomar (ExecutableItems، ExecutableBlocks، إلخ).
• المطورون الذين يحتاجون إلى مكتبة قابلة لإعادة الاستخدام للمقذوفات والمتغيرات وتنفيذ الأوامر المخصصة.
• المسؤولون الذين يريدون محررات خفيفة داخل الخادم لهذه الميزات.

🏗️ حالات استخدام مثال

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

⌨️ الأوامر

ملاحظات: توثّق الوثائق الرسمية أيضًا رموز العناصر النائبة للمتغيرات (مثل %score_variables_<var_name>% و%score_variables_<var_name>_int%). لم تُدرج عقد الصلاحيات في بيانات الإضافة المشار إليها.

⚙️ التثبيت

📥 الإعداد

• نزّل ملف SCore الرسمي .jar للإصدار المطابق من الإضافة.
• ضع ملف .jar في مجلد plugins/ الخاص بالخادم.
• أعد تشغيل الخادم وتحقق من وحدة تحكم الخادم للتأكد من أن SCore قد تم تحميله.
• إذا كنت تشغّل إضافات Ssomar أخرى، فثبّت نسخة SCore المطابقة لللاحقة في إصدارها كما يوصي المشروع (مطابقة إصدار SCore مع إصدار الإضافة التابعة).

🧠 ملاحظات تقنية

• المنصات المدعومة والمؤكدة: Bukkit, Spigot, Paper, Purpur, Folia.
• تشمل إصدارات Minecraft المدعومة والمؤكدة: 1.21.x حتى 1.8.x (كما أدرجها المشروع).
• تسرد بيانات المشروع وصف ترخيص مقيدًا (ARR / All Rights Reserved)، بينما تشير توزيعة المشروع أيضًا إلى مستودع Git للمساهمات؛ تظهر هذه العناصر معًا في البيانات الرسمية.
• من المفترض تثبيت SCore كمكتبة/اعتمادية لإضافات Ssomar الأخرى؛ فهو يوفّر ميزات تستدعيها الإضافات الأخرى وقت التشغيل.

🤝 متى تكون هذه الإضافة مفيدة

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