إضافة Minecraft skript-placeholders

🔌 حول skript-placeholders

skript-placeholders هو إضافة لملف Skript توفر تكامل الـ placeholders: فهي تتيح لك تسجيل placeholders من Skript وإتاحة استخدامها في PlaceholderAPI وMVdWPlaceholderAPI حتى تتمكن الإضافات الأخرى من الاستعلام عن متغيرات Skript.

🎯 الغرض

تحل هذه الإضافة مشكلة مشاركة القيم الديناميكية التي يديرها Skript (المتغيرات، والبيانات المحسوبة) مع إضافات أخرى تدعم الـ placeholders. وهذا مفيد عندما تريد إظهار الحالة التي يتحكم بها Skript أو القيم المخصصة في لوحات النتائج، وتنسيقات الدردشة، وboss bars، وقوائم tab، أو أي إضافة تقرأ placeholders الخاصة بـ PlaceholderAPI / MVdWPlaceholderAPI.

⚙️ الميزات

• تسجيل وإتاحة الـ placeholders من Skript إلى PlaceholderAPI.
• دعم اختياري لـ MVdWPlaceholderAPI (يتطلب إضافة متوافقة مع MVdW لكي يعمل MVdWPlaceholderAPI).
• الحصول على قيم placeholders من Skript داخل السكربتات (راجع wiki المشروع للحصول على أمثلة).
• نسخة متفرعة/امتداد لمشروع Ersatz، تم تحديثها للعمل مع نظام PlaceholderExpansion الخاص بـ PlaceholderAPI.

🧩 لمن هذا مناسب

• مالكو السيرفرات والمديرون الذين يستخدمون Skript لتنفيذ منطق مخصص ويحتاجون إلى إتاحة تلك القيم لإضافات أخرى.
• السيرفرات التي تستخدم PlaceholderAPI أو MVdWPlaceholderAPI وتعديلات مبنية على Skript.

🏗️ أمثلة على الاستخدام

• إتاحة متغير Skript يحتوي على إحصائية لاعب حتى تتمكن إضافة scoreboard من عرضها عبر placeholder.
• إنشاء placeholders مخصصة في Skript تستخدمها إضافات الدردشة/الـ tab/الـ bossbar التي تدعم PlaceholderAPI.

⚙️ التثبيت

📥 الإعداد

• حمّل ملف JAR الخاص بالإضافة وضعه في دليل plugins/ على السيرفر.
• تأكد من أن Skript (الإصدار 2.7.3 أو أحدث) مثبت وموجود.
• ثبّت PlaceholderAPI أو MVdWPlaceholderAPI حسب نظام الـ placeholders الذي تنوي استخدامه.
• ابدأ السيرفر أو أعد تشغيله وتحقق من وحدة التحكم للتأكد من أن الإضافة تم تحميلها بشكل صحيح.

📦 المتطلبات

• Skript (يتطلب الإصدار 2.7.3 أو أحدث)
• PlaceholderAPI أو MVdWPlaceholderAPI (يجب تثبيت أحدهما لإتاحة الـ placeholders)

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

• هذه الإضافة هي نسخة متفرعة من مشروع Ersatz وتم تحديثها لاستخدام نظام PlaceholderExpansion الخاص بـ PlaceholderAPI.
• يذكر مؤلف الإضافة مجموعة من إصدارات Minecraft التي تم اختبارها في صفحة المشروع.

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

إذا كنت تدير سيرفرًا يعتمد على Skript للميكانيكيات المخصصة وتحتاج إلى جعل القيم التي يديرها السكربت متاحة لإضافات أخرى عبر نظام placeholders موحد، فإن skript-placeholders توفر جسرًا مباشرًا وسهلًا إلى PlaceholderAPI وMVdWPlaceholderAPI.