إضافة Minecraft ItemJoin

🔌 حول ItemJoin

ItemJoin هو إضافة Minecraft تمنح اللاعبين عناصر مخصصة قابلة للتخصيص بدرجة عالية بشكل تلقائي. يمكن منح العناصر عند أحداث مثل join وfirst-join وrespawn وworld-switch وregion-enter وregion-leave. يركّز هذا الـ plugin على تعريفات العناصر المرنة (itemflags) وأحداث التشغيل والأوامر المرتبطة بالعناصر، بحيث يمكن للسيرفر توفير قوائم اللوبي أو starter kits أو أدوات تعتمد على السياق دون الحاجة إلى mod مخصص على العميل.

🎯 الهدف

يحل ItemJoin مشكلة منح اللاعبين عناصر مخصصة أو تفاعلية بشكل موثوق ومربوطة بأحداث السيرفر والعوالم. وهو مفيد لسيرفرات hub/lobby، وسيرفرات minigame، وشبكات survival (حيث يجب تقييد العناصر لكل عالم)، والشبكات التي تحتاج إلى قوائم تعتمد على العناصر أو عناصر تشغّل أوامر.

⚙️ الميزات

• منح العناصر عبر محفزات قابلة للتخصيص: join وfirst-join وrespawn وworld-switch وregion-enter/exit وأحداث مشابهة.
• itemflags لكل عنصر لتغيير السلوك (slot، overwrite، قواعد stack، منع الحركة/الالتقاط، قيود gamemode، فرصة الحصول، cooldowns).
• ItemCommands: ربط أوامر بالعناصر وضبط سياق التنفيذ (console، player، server، message) وأنواع التفاعل (نقرة يسار/يمين، نقرة داخل المخزون، physical، multi-click).
• تكامل PlaceholderAPI لأسماء العناصر وlore الديناميكية ودعم placeholders.
• دعم الرؤوس المخصصة للاعبين (textures وowners مخصصة)، وصور map، وtipped arrows، والكتب، وbanners، والألعاب النارية، وتخصيص دروع الجلد، ومستويات enchant مخصصة.
• إمكانية حظر حركة العناصر أو التقاطها في عوالم محددة وتقييد العناصر حسب عنوان IP أو حالة first-join.
• منشئ GUI داخل اللعبة لبناء مجموعات العناصر، مع سير عمل مدمج للاستيراد/الإنشاء.
• API لإضافات أخرى: متاحة عبر me.RockinChaos.itemjoin.api.ItemJoinAPI.

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

• مالكو السيرفرات الذين يحتاجون عناصر لوبي/Hub أو starter kits تلقائية.
• مشغلو minigame والشبكات الذين يحتاجون عناصر خاصة بكل عالم أو بوصلة قائمة.
• المطورون الذين يريدون نظام عناصر يمكن ربطه عبر API.

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

• إعطاء اللاعبين بوصلة قائمة عند join وتشغيل أوامر مختلفة عند النقر عليها.
• توفير starter kits لمرة واحدة عند first-join مع منع نقل العناصر بين عوالم محددة.
• إنشاء عناصر تفاعلية تنفذ أوامر economy/shop مع cooldowns وتكاليف.

⌨️ الأوامر

ملاحظة: هذه الأوامر والأوامر الفرعية مأخوذة من مجموعة الأوامر الموثقة الخاصة بالإضافة. وتوفر الإضافة أوامر فرعية إضافية في الويكي ومخرجات المساعدة التي يتم توليدها.

🔐 الصلاحيات

يمكن ضبط سلوك الصلاحيات الخاصة بالعناصر؛ فحص صلاحيات العناصر معطّل افتراضيًا ويجب تفعيله في إعدادات الإضافة حتى يسري مفعوله.

⚙️ التثبيت

📥 الإعداد

• حمّل ملف jar الرسمي لـ ItemJoin وضعه في مجلد plugins/ الخاص بالسيرفر.
• تأكد من عدم وجود ملفات jar مكررة لـ ItemJoin داخل plugins/ (مثل ItemJoin(1).jar).
• أعد تشغيل السيرفر حتى تتمكن الإضافة من إنشاء إعداداتها وتسجيل الميزات الخاصة بإصدار السيرفر لديك.
• افحص سجلات الكونسول للتأكد من تحميل الإضافة، وراجع ويكي الإضافة للحصول على إعداد تفصيلي.

📦 التبعيات

لا تملك الإضافة متطلبات تشغيل إلزامية، لكنها تسرد عدة soft-dependencies وتكاملات شائعة (اختيارية وتُفعّل عند توفرها):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

فعّل التكاملات أو اضبطها حسب الحاجة؛ فالإضافة تعمل بدونها، لكن ميزات مثل placeholders والرؤوس/السكينات المخصصة وhooks الخاصة بالاقتصاد تعتمد على الإضافات المقابلة.

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

• المنصات: مؤكدة لخوادم بنمط Spigot (Spigot، Bukkit، Paper، Purpur، Folia).
• نطاق Minecraft المدعوم/المختبر: من 1.8 إلى 1.21.
• تم نشر الشيفرة المصدرية والإصدارات، ويوفّر المشروع API في me.RockinChaos.itemjoin.api.ItemJoinAPI لتتمكن الإضافات الأخرى من الربط معه.
• الترخيص: LGPL-3.0.

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

إذا كنت تحتاج نظامًا مرنًا وقابلًا للتخصيص لتزويد اللاعبين بعناصر تفاعلية ومراعية للسياق (قوائم، starter kits، أدوات خاصة بكل عالم) وتريد API للتكاملات، فإن ItemJoin يوفر هذه الميزات مع دعم إضافات placeholders والـ skins الشائعة.