إضافة Minecraft PlaceholderAPI
معلومات عن PlaceholderAPI والخوادم التي تم العثور عليها فيها
🔌 حول PlaceholderAPI
PlaceholderAPI هو إضافة Minecraft توفّر نظام placeholders مركزيًا ومنظومة توسعات (eCloud). يتيح ذلك للإضافات الأخرى قراءة واستبدال آلاف الـ placeholders الديناميكية (بيانات اللاعب، قيم الاقتصاد، القيم الخاصة بالإضافات، إلخ) دون الحاجة إلى تكامل مباشر أو اعتمادات ثقيلة.
🎯 الهدف
تحل الإضافة مشكلة صعوبة التكامل بين الإضافات عبر توفير API واحد وقابل للتوسعة للـ placeholders. ينشر مطورو الإضافات "توسعات" توفّر placeholders مسماة؛ ويثبت مديرو الخادم هذه التوسعات حتى تتمكن الإضافات التي تعرض بيانات الخادم (لوحات النتائج، الدردشة، الهولوغرامات، الواجهات الرسومية) من إظهار البيانات الحية باستخدام صياغة موحدة.
⚙️ الميزات
- API أساسي لتحليل placeholders حتى تتمكن الإضافات الأخرى من الارتباط به.
- نظام التوسعات: توسعات مستقلة أو توسعات مدمجة داخل الإضافات.
- eCloud (سحابة التوسعات) للعثور على التوسعات الموثوقة وتنزيلها داخل اللعبة.
- أوامر إدارة أثناء التشغيل لعرض التوسعات وتسجيلها وإلغاء تسجيلها وإعادة تحميلها.
- أوامر debug/parse لتقييم placeholders للاعب أو بث النتائج، وهي مفيدة لاستكشاف الأخطاء وإصلاحها.
- أدوات مثل أمر dump لمشاركة التوسعات المثبتة وحالة الإضافة عند طلب الدعم.
🧩 لمن هذه الإضافة
- مديرو الخوادم الذين يحتاجون إلى نص ديناميكي موحّد عبر عدة إضافات (لوحات النتائج، قائمة اللاعبين، الهولوغرامات، الواجهات الرسومية).
- مطورو الإضافات الذين يريدون إتاحة أو استخدام placeholders دون فرض اعتمادات ثقيلة.
- خوادم Survival وminigame وnetwork التي تجمع العديد من الإضافات وتحتاج إلى صياغة placeholders متسقة.
🏗️ أمثلة على الاستخدام
- يثبت خادم توسعة Vault بحيث يمكن استخدام placeholders الخاصة بالاقتصاد مثل رصيد اللاعب في إضافات لوحة النتائج والدردشة.
- يقوم مدير بتنزيل توسعة خاصة بإضافة من eCloud بحيث يمكن لإضافة هولوغرام عرض بيانات الهدف مباشرة.
- يوفّر مطور بيانات الإضافة عبر PlaceholderExpansion حتى تتمكن خوادم أخرى من عرض تلك البيانات دون الاعتماد على الإضافة مباشرة.
⌨️ الأوامر
| الأمر | الوصف | الصلاحية | الوصول |
|---|---|---|---|
| `/papi parse <player | me> | يحلل placeholders داخل نص ويعرض النتيجة لأغراض التصحيح. | غير محدد |
| `/papi bcparse <player | me> | يحلل placeholders ويبث النتيجة إلى جميع اللاعبين. | غير محدد |
| `/papi cmdparse <player | me> | يحلل placeholders وينفذ الأمر الناتج. | غير محدد |
/papi parserel <player1> <player2> <text> | يحلل placeholders النسبية بمقارنة لاعبين اثنين. | غير محدد | مسؤول |
/papi list | يعرض التوسعات النشطة/المسجلة. | غير محدد | مسؤول |
/papi info <expansion> | يعرض معلومات عن توسعة مسجلة. | غير محدد | مسؤول |
/papi register <filename> | يسجل ملف jar لتوسعة من مجلد expansions دون إعادة التشغيل. | غير محدد | مسؤول |
/papi unregister <filename> | يلغي تسجيل/يزيل توسعة مسجلة. | غير محدد | مسؤول |
/papi reload | يعيد تحميل إعدادات PlaceholderAPI ويسجل التوسعات التي تم تنزيلها حديثًا. | غير محدد | مسؤول |
/papi version | يعرض إصدار الإضافة وأسماء المؤلفين. | غير محدد | مسؤول |
/papi dump | يخرج معلومات الإضافة/الإصدار/التوسعات للدعم (خدمة paste). | غير محدد | مسؤول |
/papi ecloud download <expansion> [version] | ينزّل توسعة موثوقة من eCloud إلى الخادم. | غير محدد | مسؤول |
| `/papi ecloud list [all | installed]` | يعرض التوسعات المتاحة على eCloud أو التوسعات المثبتة. | |
/papi ecloud placeholders <expansion> | يعرض الـ placeholders التي توفرها توسعة من eCloud. | غير محدد | مسؤول |
/papi ecloud status | يعرض حالة/اتصال خدمة eCloud. | غير محدد | مسؤول |
(ملاحظة: الأوامر أعلاه موثقة في مرجع الأوامر الرسمي لـ PlaceholderAPI. لا تُدرج نودات الصلاحية للأوامر الفردية في التوثيق المشار إليه.)
⚙️ التثبيت
📥 الإعداد
- نزّل ملف jar الرسمي لـ PlaceholderAPI وضعه في مجلد
plugins/الخاص بالخادم. - شغّل الخادم أو أعد تشغيله وتأكد من أن PlaceholderAPI يتم تحميله في وحدة التحكم.
- ثبّت التوسعات إما بوضع ملفات jar الخاصة بها في
plugins/PlaceholderAPI/expansions/أو باستخدام أوامر eCloud داخل اللعبة (للتوسعات الموثوقة).
📦 الاعتمادات
- لا يحتاج PlaceholderAPI نفسه إلى اعتماد عام على إضافة أخرى ليعمل. بعض الـ placeholders التي توفرها التوسعات تعتمد على إضافات أخرى (مثل توسعة تعرض قيم الاقتصاد، والتي ستحتاج إلى إضافة الاقتصاد المناسبة). تعتمد هذه المتطلبات على التوسعة المحددة.
🧠 ملاحظات تقنية
- يتم توفير PlaceholderAPI للخوادم المبنية على Spigot ويُستخدم أيضًا بشكل شائع على Paper. توفّر هذه الإضافة API للمطورين لتسجيل PlaceholderExpansions.
- يمكن توزيع التوسعات كملفات jar مستقلة أو مضمّنة داخل إضافات أخرى؛ وغالبًا ما تُثبَّت التوسعات المستقلة في
plugins/PlaceholderAPI/expansions/. - تتيح ميزة eCloud اكتشاف التوسعات الموثوقة وتنزيلها داخل اللعبة؛ ويجب أن تسمح الخوادم باتصالات HTTPS الصادرة حتى تعمل تنزيلات eCloud.
- تتضمن الإضافة أوامر debug وparsing لمساعدة المديرين على التحقق من أن placeholders تُحل بشكل صحيح.
🤝 متى تكون هذه الإضافة مفيدة
إذا كان خادمك يستخدم عدة إضافات تحتاج إلى عرض بيانات ديناميكية مشتركة بين الإضافات (الدردشة، التاب، الهولوغرامات، لوحات النتائج أو الواجهات الرسومية)، فإن PlaceholderAPI مفيدة لأنها تركز حل الـ placeholders وتتيح لك إضافة دعم لإضافات أخرى عبر توسعات معيارية دون تعديل كل إضافة مستهلكة.
Rooted RealmSMP بقاء على Java بنظام قائمة مسموح لهم: لا لمسح مخطط، اقتصاد يقوده اللاعبون، فعاليات أسبوعية وPvP اختياري. مجتمع ودود للبالغين.
١٤57.88
Restarting...١٨57.7
LinkCraftسيرفر Minecraft مجتمعي يركز على الترقّي بالرتب، مسارات الباركور، المتاهات والتحديات — ألعاب صغيرة تقدم تقدمًا ممتعًا.
٢٢57.05
- Welcome to Afterlife SMP!٦54.61
A Minecraft Server٤53.91
Minecart Rapid Transitخادم يركز على المجتمع وبناء المدن والنقل، ويتمحور حول القطارات القابلة للركوب، وشبكات النقل الكبيرة، والمباني المحمية، والاقتصاد الذي يديره اللاعبون، وساحات PvP المنظمة.
٤53.88
Welcome To the Kmartz SMP!٥53.54- Survival١53.33
AetherCraftSMP بقاء شبه مخصص مع حماية الأراضي، واقتصاد يديره اللاعبون، وعناصر ومخلوقات مخصصة، وعوالم متعددة، ودعم اللعب المشترك بين Bedrock/Java.
٥53.18
Restarting...٣53.06
Legion Tekkitوضع Survival معدل من Tekkit يركز على التطور التقني والفصائل التي يديرها اللاعبون، مع اقتصاد ومتاجر لاعبين وclaims محمية وأحداث الساحة وعدة عوالم.
٦52.6
GenuineMCSMP بقاء شبه فانيلا يركّز على المجتمع، مع حماية الأراضي، ومتاجر اللاعبين، ومكافآت التصويت، ومستحضرات تجميل، وربما اللعب المشترك بين Bedrock وJava.
١52.16
A Fallout Roleplaying Server٢51.99
SmithtainmentSMP بقاء يركّز على المجتمع، مع إضافات مخصصة، اقتصاد، mcMMO وألعاب صغيرة — لاعبون ودودون ومنتدى نشط.
٤51.87
تعرض صفحة إضافة PlaceholderAPI الخوادم التي وجد نظام المراقبة هذه الإضافة عليها، والمنصات والإصدارات التي تظهر معها.
قد تضيف الإضافات أوامر، اقتصادا، حماية، صلاحيات، ألعابا مصغرة، تكاملات أو آليات أخرى. يعتمد الدور الفعلي لـ PlaceholderAPI على إعداد كل خادم.
تُنشأ البيانات تلقائيا من الردود التقنية للخوادم. إذا كان الخادم يخفي قائمة الإضافات، فقد لا يظهر في هذا القسم حتى إذا كان يستخدم PlaceholderAPI.
استخدم قائمة الخوادم التي تحتوي على PlaceholderAPI لمقارنة المشاريع، التحقق من الإصدارات المتوافقة أو العثور على أمثلة لاستخدام الإضافة في الخوادم العامة.