إضافة Minecraft WorldGuardExtraFlagsPlus

🔌 حول WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus هو امتداد لإضافة WorldGuard يوفّر أعلام مناطق وسلوكيات إضافية. يوسّع نظام المناطق في WorldGuard بأكثر من 40 علمًا مؤكّدًا للتحكم في استخدام العناصر، والانتقال السريع، وحدود الدخول، والصنع، واصطدام اللاعبين، وتجارة القرويين، وغيرها من القواعد الخاصة بالمناطق.

🎯 الهدف

يملأ هذا الإضافة الفجوات في الأعلام المدمجة في WorldGuard من خلال توفير تحكّم دقيق في أفعال اللاعبين وسياسات المناطق. وهو مخصّص لمديري الخوادم الذين يحتاجون إلى تخصيص على مستوى المنطقة يتجاوز WorldGuard الأساسي، مثل إنشاء ساحات PvP محمية، واللوبي، وسلوك الـ hub، أو مناطق اللعب المقيّدة.

⚙️ الميزات

• يضيف أكثر من 40 علمًا إضافيًا (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• أعلام جديدة خاصة بـ plus: disable-completely, disable-throw, entry-min-level, entry-max-level, player-count-limit, villager-trade, lightning-damage, disable-collision, inventory-craft, permit-workbenches, deny-item-drops, deny-item-pickup, allow-block-place, deny-block-place, allow-block-break, deny-block-break.
• رسائل قابلة للتخصيص محفوظة في messages-wgefp.yml (مهلة تبريد للرسائل لمنع الإزعاج).
• روابط تكامل اختيارية: دعم PlaceholderAPI للمتغيرات الرقمية، وروابط حزم اختيارية من PacketEvents أو ProtocolLib لتحسين تغطية الحظر لبعض العناصر/الهجمات.
• تكامل EssentialsX: تحسينات أعلام godmode و fly تعطّل godmode/fly في EssentialsX عندما يتم رفض تلك الأعلام.
• دعم Folia ومعالجات آمنة مع async حيثما ينطبق ذلك.
• أداة التحقق من التحديثات وعلم تجريبي hide-players وسلوك تجريبي chambered-enderpearl.
• علم console-command-repeat لتشغيل أمر في console بشكل متكرر بينما يبقى اللاعب داخل منطقة (معطّل افتراضيًا).

🧩 لمن هذا مناسب

• مالكو الخوادم والمديرون الذين يشغّلون WorldGuard ويحتاجون إلى تحكم أدق في المناطق.
• خوادم Survival وSMP وhub/lobby وPvP التي تتطلب تخصيصًا للسلوك حسب المنطقة.
• الخوادم التي تستخدم Paper أو Folia وتحتاج إلى دعم async أو دعم خاص بالنسخة الفرعية.

🏗️ أمثلة على الاستخدام

• تحديد عدد اللاعبين في منطقة ساحة باستخدام player-count-limit.
• حظر استخدام ورمي عناصر معيّنة (mace, trident, ender pearls) داخل مناطق الفعاليات باستخدام disable-completely و disable-throw.
• منع الصنع داخل المخزون (2x2) في المناطق الآمنة باستخدام inventory-craft أو حظر استخدام طاولة العمل باستخدام permit-workbenches.
• تقييد دخول المنطقة حسب مستوى XP للاعب أو قيمة رقمية من PlaceholderAPI باستخدام entry-min-level / entry-max-level.
• تشغيل أمر في console بشكل متكرر بينما يبقى اللاعب داخل المنطقة باستخدام console-command-repeat.

⌨️ الأوامر

⚙️ التثبيت

📥 الإعداد

• حمّل ملف JAR الرسمي وضعه في مجلد plugins/ الخاص بخادمك إلى جانب WorldGuard.
• إذا كنت تقوم بالترقية من WorldGuardExtraFlags الأقدم: احذف WorldGuardExtraFlags.jar القديم قبل البدء — فلا يمكن أن يتواجدا معًا.
• أعد تشغيل الخادم وتحقق من وحدة تحكم الخادم للتأكد من أن الإضافة وأعلامها تم تحميلها بشكل صحيح.

📦 المتطلبات

• مطلوب: WorldGuard (هذا المشروع امتداد لـ WorldGuard).
• اختياري / تكاملات: PlaceholderAPI (دعم المتغيرات الرقمية)، PacketEvents أو ProtocolLib (حظر محسّن يعتمد على الحزم)، EssentialsX (تكامل لسلوك godmode/fly).

🧾 الإعدادات

• تُخزَّن رسائل الإضافة في plugins/WorldGuard/messages-wgefp.yml وهي قابلة للتخصيص بالكامل؛ ويوجد نظام مهلة تبريد للرسائل يمكن ضبطه عبر إعدادات الإضافة.

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

• يعلن المشروع api-version: 1.21 ويستهدف أصول Paper API الحديثة؛ وتم تنفيذ توافق Folia والتأكد منه.
• يتوافق Java bytecode واستهداف API مع بيئات الخوادم الحديثة من حقبة 1.21.
• تستبدل الإضافة السلوك القديم permit-completely بـ disable-completely لتوسيع دلالات حظر العناصر.
• بعض الميزات (مثل الحظر الكامل لآليات اندفاع الرمح في حالات معيّنة) تكون أكثر موثوقية عند توفر PacketEvents أو ProtocolLib.
• تعرض الإضافة العديد من الأعلام عبر أوامر الأعلام القياسية في WorldGuard (يتم ضبط الأعلام باستخدام واجهة أعلام المنطقة في WorldGuard).

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

إذا كنت تشغّل WorldGuard وتحتاج إلى أعلام مناطق إضافية ومؤكدة للتحكم في استخدام العناصر، وقواعد دخول اللاعبين، والصنع، وغيرها من السلوكيات الخاصة بكل منطقة — خاصةً على خوادم Paper أو Folia — فإن WorldGuard ExtraFlags Plus يجمع هذه الإمكانيات داخل نظام الأعلام في WorldGuard دون الحاجة إلى إضافات منفصلة لإدارة المناطق.