دليل
كيف تصنع plugin لوحة نقاط لـ Minecraft
حُدّث في 18 أكتوبر 2026
الشريط الجانبي على يمين الشاشة هو الجزء الأكثر ظهوراً في كثير من الخوادم: اسم الخادم، ورتبة اللاعب، والمال، وعمليات القتل، واللاعبون المتصلون. يرسمه الـ plugin عبر Scoreboard API في Bukkit. والجزءان الصعبان هما منح كل لاعب أسطره الخاصة وتحديثها بسلاسة.
غيّر الأسطر لتناسب خادمك.
ولّد هذا بـ Codexeخطوة بخطوة
1.اكتب الأسطر
العنوان وكل سطر من الأعلى إلى الأسفل، مع القيم التي يعرضها: "Rank: Admin"، و"Coins: 1,250"، و"Online: 34". يعرض الشريط الجانبي 15 سطراً على الأكثر.
2.امنح كل لاعب لوحة نقاط
الأسطر التي تختلف من لاعب لآخر تحتاج إلى لوحة نقاط لكل لاعب، من
Bukkit.getScoreboardManager().getNewScoreboard()، تُضبط بـplayer.setScoreboard(...)عند الانضمام.3.أنشئ هدف الشريط الجانبي
سجّل هدفاً من نوع dummy واضبط خانة عرضه على
DisplaySlot.SIDEBAR. كل سطر مُدخل بنقاط تحدد موضعه.4.حدّث القيم
مهمة متكررة، كل ثانية مثلاً، تحدّث الأسطر التي تغيّرت فقط. استخدم بادئات الفرق ولواحقها للنص حتى لا تومض الأسطر.
5.أضف العناصر النائبة
مع PlaceholderAPI، تعرض أسطر مثل
%vault_eco_balance%قيماً من plugins أخرى دون كود إضافي.6.ابنِها وشاهدها داخل اللعبة
دع Codexe يجمّعها، وانضم إلى الخادم التجريبي وتحقق من كل سطر، ثم غيّر قيمة وشاهدها تتحدث.
كيف يعمل الشريط الجانبي
- يُعرض هدف واحد فقط في الشريط الجانبي في كل مرة لكل لوحة نقاط. واسمه المعروض هو العنوان.
- تُرتَّب الأسطر حسب نقاطها، الأعلى أولاً، فالنقاط ليست إلا رقم السطر معكوساً.
- يجب أن يكون كل سطر مُدخلاً مختلفاً: السطران المتطابقان يحتاجان إلى اختلاف غير مرئي، مثل رموز ألوان مختلفة.
- يمكن إخفاء الأرقام الحمراء على اليمين منذ Minecraft 1.20.3، الذي أضاف تنسيقات أرقام للنقاط. أما الإصدارات الأقدم فتعرضها دائماً.
- يرى اللاعب لوحة نقاط واحدة: إذا ضبط plugin آخر لوحته الخاصة، فالأخيرة هي التي تبقى. استخدم plugin واحداً للشريط الجانبي، أو اذكر الـ plugins الأخرى التي تتشارك لوحة النقاط.
التحديث دون وميض
حذف سطر وإضافة سطر جديد يجعله يومض. الحل المعتاد هو منح كل سطر مُدخلاً ثابتاً غير مرئي، ووضع النص الظاهر في بادئة ولاحقة فريق يحتوي ذلك المُدخل؛ فتحديث الفريق يغيّر النص في مكانه. اطلب "بلا وميض" في الطلب وسيُكتب الـ plugin بهذه الطريقة.
plugin أم Skript أم datapack؟
| الخيار | يستطيع | الحد |
|---|---|---|
| Plugin | أسطر لكل لاعب، وأي قيمة، ورسوم متحركة، وعناصر نائبة | يحتاج إلى Spigot أو Paper أو أحد فروعهما |
| Skript مع SkBee | أشرطة جانبية لكل لاعب من سكربت | يحتاج إلى Skript والإضافة |
| Datapack | عرض هدف واحد، مثل الوفيات أو عمليات القتل، في الشريط الجانبي | الأرقام نفسها للجميع، ولا نص حر لكل لاعب |
مثال على وصف
"plugin لـ Paper 1.21.4 باسم Board. شريط جانبي لكل لاعب بعنوان ذهبي، ثم الرتبة (من LuckPerms)، والعملات (من Vault)، وعمليات القتل، والوفيات، واللاعبون المتصلون، وعنوان الخادم. يتحدث كل ثانية دون وميض، والأرقام الحمراء مخفية. الأسطر والعنوان وفترة التحديث في config.yml، مع السماح بعناصر PlaceholderAPI النائبة في أي سطر. الأمر /board toggle يخفيه لكل لاعب ويُحفظ الاختيار."
أسئلة
كم سطراً يمكن أن يحتوي الشريط الجانبي؟
يُعرض 15 سطراً. المحتوى الأطول يحتاج إلى مكان آخر، مثل قائمة Tab أو شريط الإجراءات أو شريط الزعيم.
هل يعمل على 1.8؟
نعم، واجهة Scoreboard API موجودة في 1.8، لكن طول النص في كل سطر محدود أكثر هناك. اذكر الإصدار ليُكتب الـ plugin له.
لماذا تختفي لوحة النقاط الخاصة بي؟
عادةً يضبط plugin آخر لوحة نقاطه الخاصة على اللاعب بعد لوحتك. احذف الشريط الجانبي الآخر، أو اجعل plugin واحداً يعرض كل شيء.
اصنع شريطك الجانبي
يُفتح هذا الوصف جاهزاً للإرسال:
“plugin لوحة نقاط جانبية لـ Paper 1.21.4 باسم Board: شريط جانبي لكل لاعب بعنوان ذهبي، والرتبة من LuckPerms، والعملات من Vault، وعمليات القتل، والوفيات، واللاعبون المتصلون، وعنوان الخادم، يتحدث كل ثانية دون وميض، والأرقام الحمراء مخفية، والأسطر والفترة في config.yml مع دعم PlaceholderAPI، و/board toggle محفوظ لكل لاعب.”
ولّد هذا بـ Codexe