PlaceholderAPI: العناصر النائبة
تثبيت PlaceholderAPI، وتحميل الإضافات الفرعية، وقائمة بالعناصر النائبة المفيدة، وتصحيح الأخطاء عندما يظهر العنصر النائب نفسه بدلاً من القيمة.
آخر تحديث 13 أغسطس 2026
PlaceholderAPI مكتبة للعناصر النائبة. تتيح لإضافة عرض بيانات من إضافة أخرى: الرصيد في الدردشة، والمنطقة على لوحة النتائج، والعشيرة في قائمة اللاعبين.
التثبيت
ثبّت الإضافة من الكتالوج، ثم ثبّت الامتدادات لمصادر البيانات التي تحتاجها:
papi ecloud download Vault
papi ecloud download Player
papi ecloud download Server
papi reload
ثبّت الامتدادات واحدًا تلو الآخر، امتدادًا واحدًا لكل مصدر بيانات.
عناصر نائبة مفيدة
| العنصر النائب | المعنى |
|---|---|
%player_name% | الاسم المستعار |
%player_ping% | زمن الاستجابة |
%player_world% | العالم |
%server_online% | اللاعبون المتصلون |
%server_tps_1% | TPS خلال الدقيقة الأخيرة |
%vault_eco_balance_formatted% | الرصيد |
%luckperms_prefix% | بادئة المجموعة |
%worldguard_region_name% | المنطقة التي يقف فيها اللاعب |
الاختبار
papi parse me %vault_eco_balance%
يعرض الأمر ما يتم استبداله فعليًا. إذا ظهر لك النص الحرفي %vault_eco_balance%، فهذا يعني:
- أن الامتداد غير مثبّت؛
- أن مصدر البيانات مفقود (لا توجد إضافة اقتصاد)؛
- أن الإضافة التي أدرجت فيها العنصر النائب لا تدعم PlaceholderAPI.
السبب الأخير هو الأكثر شيوعًا: ليست كل إضافة تدعم العناصر النائبة الخارجية، حتى لو كانت لديها عناصرها النائبة الخاصة.
الأداء
تُحسب العناصر النائبة عند كل تحديث. لوحة نتائج بعشرة قيم، تُحدَّث كل tick، تعني 200 عملية حساب في الثانية لكل لاعب: لوحة النتائج.
