Minecraft Servers HQ

إضافة Minecraft Citizens

معلومات عن Citizens والخوادم التي تم العثور عليها فيها

SurvivalRPGCosmeticsSpigotPaperAPIAdmin ToolsPermissionsRolePlayAdminUtilityChatWorldNPCDeveloper API

🔌 حول Citizens

Citizens هو إضافة Minecraft توفر نظامًا متكاملًا لإنشاء وإدارة NPCs على جانب الخادم. يدعم أنواعًا كثيرة من NPCs (شبيهة باللاعب، الموبات، أصحاب المتاجر، الحراس، التماثيل) ويُوفّر API بحيث يمكن للإضافات الأخرى والكود المخصص إضافة السلوكيات والـ traits والتكاملات.

🎯 الغرض

يحل Citizens الحاجة إلى شخصيات غير لاعبة دائمة وقابلة للإعداد على الخادم: يمكن أن تعمل NPCs كأصحاب متاجر تفاعليين، أو ممثلين بنصوص، أو حراس يتبعون نقاط المسار، أو أكشاك معلومات، أو تماثيل زخرفية. يُستخدم هذا الإضافة من قِبل مالكي الخوادم لبناء ميزات اللعب، وكذلك من قِبل المطورين لتوسيع الوظائف عبر Citizens API.

⚙️ المميزات

  • إنشاء NPCs وإزالتها بأوامر داخل اللعبة.
  • أنواع متعددة من NPCs (شبيهة باللاعب، مبنية على الموبات، القرويون، إلخ).
  • إسناد أوامر أو إجراءات نصية إلى NPCs (مشغلات النقر/التنفيذ، مرفقات الأوامر).
  • نقاط مسار وسلوك دوريات لـ NPCs المتحركة.
  • traits ومحررات لتخصيص سلوك NPC ومظهره.
  • قوالب واستمرارية بحيث تبقى NPCs بعد إعادة التشغيل.
  • API للمطورين للإضافات وtraits والتكاملات.

🧩 لمن هذا؟

  • مالكو الخوادم الذين يريدون NPCs تفاعلية للمتاجر أو الأدلة أو المناظر.
  • مطورو الإضافات الذين يحتاجون إلى API خاص بـ NPC لبناء تكاملات أو ألعاب صغيرة.
  • خوادم المجتمع التي تتطلب شخصيات غير لاعبة زخرفية أو وظيفية.

🏗️ حالات استخدام مثال

  • يستخدم خادم Survival أصحاب متاجر NPC لتبادل العناصر بدون إضافات اقتصاد.
  • يقوم خادم RPG ببرمجة NPCs لتقديم المهام والحوار.
  • يضع مسؤول الخادم NPCs حراسًا بدوريات تتبع نقاط المسار حول البلدة.
  • يضيف المطورون traits مخصصة إلى NPCs لتفاعلات minigame.

⌨️ الأوامر

الأمرالوصفالصلاحيةالوصول
/citizensعرض معلومات أساسية عن الإضافة ونظرة عامة على الإدارة.citizens.adminمسؤول
/npcالأمر الرئيسي لإنشاء NPCs وتحريرها وإدارتها (تتوفر العديد من الأوامر الفرعية).نودات صلاحية متنوعة citizens.npc.*مسؤول

(ملاحظة: يوفّر /npc العديد من الأوامر الفرعية ونودات صلاحية أكثر تفصيلًا لميزات محددة؛ راجع وثائق الإضافة للاطلاع على مجموعة الأوامر الكاملة.)

🔐 الصلاحيات

الصلاحيةالوصفالافتراضي
citizens.adminوصول إداري عالي المستوى إلى معلومات الإضافة وإدارتها.غير محدد
citizens.npc.talkيسمح للاعب بتفعيل تفاعلات التحدث مع NPC.غير محدد
citizens.npc.listيسمح بسرد NPCs.غير محدد
citizens.waypoints.disableteleportمثال لصلاحية مرتبطة بنقاط المسار موضح في الوثائق.غير محدد

(هناك العديد من نودات الصلاحيات الإضافية لأوامر وtraits محددة؛ يشرح مرجع الصلاحيات الخاص بالإضافة ذلك بالتفصيل.)

⚙️ التثبيت

📥 الإعداد

  • حمّل ملف JAR الرسمي لإضافة Citizens من التوزيع الرسمي للمشروع (كتالوج الإضافات أو تنزيلات المشروع).
  • ضع ملف JAR في مجلد plugins/ على الخادم لديك في خادم متوافق مع Spigot أو Paper.
  • أعد تشغيل الخادم وتحقق من console للتأكد من أن Citizens تم تحميله وأنه أنشأ مجلدات البيانات الخاصة به.

📦 التبعيات

  • لا توجد تبعيات خارجية مطلوبة بشكل افتراضي. غالبًا ما يتم توسيع Citizens بواسطة إضافات اختيارية (إضافات طرف ثالث أو إضافات أخرى)، لكن لا شيء منها إلزامي للتشغيل الأساسي.

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

  • يوفّر Citizens API موجهًا للمطورين بحيث يمكن للإضافات الأخرى إنشاء traits والتفاعل مع NPCs والربط بأحداث NPC.
  • يخزن الإضافة بيانات NPC بشكل دائم بحيث تبقى NPCs بعد إعادة التشغيل ويدعم traits/mحررات للتخصيص أثناء التشغيل.
  • تغطي الوثائق الرسمية والويكي المجتمعي الأوامر والصلاحيات والtraits والمحررات ونقاط التكامل.

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

إذا كنت تحتاج إلى NPCs دائمة وقابلة للبرمجة، وإلى API لدمج الشخصيات غير اللاعبة في أسلوب اللعب أو أنظمة الخادم، فإن Citizens يوفّر إدارة NPC الأساسية والاستمرارية ونقاط التوسعة المطلوبة من قبل مسؤولي الخوادم ومطوري الإضافات.

خوادم تستخدم Citizens

تعرض صفحة إضافة Citizens الخوادم التي وجد نظام المراقبة هذه الإضافة عليها، والمنصات والإصدارات التي تظهر معها.

قد تضيف الإضافات أوامر، اقتصادا، حماية، صلاحيات، ألعابا مصغرة، تكاملات أو آليات أخرى. يعتمد الدور الفعلي لـ Citizens على إعداد كل خادم.

تُنشأ البيانات تلقائيا من الردود التقنية للخوادم. إذا كان الخادم يخفي قائمة الإضافات، فقد لا يظهر في هذا القسم حتى إذا كان يستخدم Citizens.

استخدم قائمة الخوادم التي تحتوي على Citizens لمقارنة المشاريع، التحقق من الإصدارات المتوافقة أو العثور على أمثلة لاستخدام الإضافة في الخوادم العامة.