إضافة 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 وتتيح لك إضافة دعم لإضافات أخرى عبر توسعات معيارية دون تعديل كل إضافة مستهلكة.
Herocraft Onlineشبكة RPG مع فئات متعددة، بلدات، زنزانات واقتصاد — مناسبة للاعبين الذين يفضلون البقاء بنكهة تمثيل الأدوار وPvP.
٢٥55.76
Restarting...١٥54.5
LinkCraftسيرفر Minecraft مجتمعي يركز على الترقّي بالرتب، مسارات الباركور، المتاهات والتحديات — ألعاب صغيرة تقدم تقدمًا ممتعًا.
١٥53.62
A Minecraft Server٨51.67
Froggieسيرفر SMP بقاء ودود يقدّم مناطق محمية، واقتصادًا يضم متاجر اللاعبين والمزادات، ودعمًا لعدة إصدارات، وميزة اللعب المشترك بين Java وBedrock للبنّائين العاديين والمجتمعات.
٦51.15
Rooted RealmSMP بقاء على Java بنظام قائمة مسموح لهم: لا لمسح مخطط، اقتصاد يقوده اللاعبون، فعاليات أسبوعية وPvP اختياري. مجتمع ودود للبالغين.
٤51.1
Minecart Rapid Transitخادم يركز على المجتمع وبناء المدن والنقل، ويتمحور حول القطارات القابلة للركوب، وشبكات النقل الكبيرة، والمباني المحمية، والاقتصاد الذي يديره اللاعبون، وساحات PvP المنظمة.
١١50.91
Eclipse Roleplay١50.87
SmithtainmentSMP بقاء يركّز على المجتمع، مع إضافات مخصصة، اقتصاد، mcMMO وألعاب صغيرة — لاعبون ودودون ومنتدى نشط.
٥50.86
Netherlite is loading...٢49.28
DaemoniaCraftسيرفر Towny بنكهة RPG — مخلوقات مخصصة، اقتصاد فعّال ودعم Bedrock. مناسب للاعبي التقدّم والقِتَال.
١48.58- LilBoxPvP
خادم يركّز على BoxPvP مع قتال سريع في الساحات، ومبارزات، وتقدم موسمي. يوفّر عناصر مخصصة، وقوائم تعتمد على NPC، وعلى الأرجح دعم اللعب المشترك بين Java وBedrock.
٢48.37 
A Minecraft Server١48.22
GospelCraftسيرفر Towny بطابع مسيحي: وحوش مخصصة، mcMMO، وظائف — تقديم الكتاب المقدس من خلال اللعب.
١47.76
AnarchyLands CZ/SK٤46.83
TGG Onlineخادم Minecraft كوري بأسلوب FPS يقدّم وضع البقاء ضد الزومبي وميني غيمز bomb/escape، مع مجموعة واسعة من الأسلحة المخصصة والنماذج المخصصة وتجربة مدعومة بحزمة موارد.
١١46.54
Racsu PlanetMMORPG للبقاء مع دعم اللعب المشترك (Java + Bedrock) يضم مهارات ومهامًا وزنزانات مخصصة واقتصادًا داخل اللعبة مدعومًا بمتجر رسمي ومركز للمجتمع.
٠46.26
تعرض صفحة إضافة PlaceholderAPI الخوادم التي وجد نظام المراقبة هذه الإضافة عليها، والمنصات والإصدارات التي تظهر معها.
قد تضيف الإضافات أوامر، اقتصادا، حماية، صلاحيات، ألعابا مصغرة، تكاملات أو آليات أخرى. يعتمد الدور الفعلي لـ PlaceholderAPI على إعداد كل خادم.
تُنشأ البيانات تلقائيا من الردود التقنية للخوادم. إذا كان الخادم يخفي قائمة الإضافات، فقد لا يظهر في هذا القسم حتى إذا كان يستخدم PlaceholderAPI.
استخدم قائمة الخوادم التي تحتوي على PlaceholderAPI لمقارنة المشاريع، التحقق من الإصدارات المتوافقة أو العثور على أمثلة لاستخدام الإضافة في الخوادم العامة.