إضافة Minecraft InteractionVisualizer

🔌 حول InteractionVisualizer

InteractionVisualizer هو إضافة Minecraft تعرض تمثيلات مرئية ورسومات متحركة على جانب العميل للبلوكات الوظيفية والكيانات ذات الصلة (على سبيل المثال: crafting table، furnace، enchantment table). يتم إرسال المؤثرات البصرية إلى اللاعبين عبر packets ولا تنشئ بلوكات أو كيانات على جانب السيرفر — إنها مجرد عروض على جانب العميل ولا تؤثر في حالة العالم.

🎯 الهدف

تجعل الإضافة تفاعلات اللاعبين مع البلوكات الوظيفية الشائعة مرئية للاعبين القريبين عبر عرض العناصر والتقدم والهولوجرامات والأنيميشن أثناء استخدامهم للـ GUI. وهي موجهة لأصحاب السيرفرات الذين يريدون ردود فعل بصرية أغنى وأكثر إفادة عندما يتفاعل اللاعبون مع الواجهات الموجودة في العالم.

⚙️ المميزات

• تعرض العديد من البلوكات الوظيفية والعناصر/الكيانات المرتبطة بها مع أنيميشن (crafting table، furnace، enchantment table وغيرها).
• عروض على جانب العميل فقط: المؤثرات البصرية لا تنشئ كيانات سيرفر دائمة أو قابلة للتفاعل.
• تبديل العرض لكل بلوك وتبديل وحدات عالمي.
• يتم حفظ حالة التبديل للاعب في قاعدة بيانات (SQLite افتراضيًا؛ وMySQL مدعوم).
• تتوفر placeholders الخاصة بـ PlaceholderAPI لعرض حالة التبديل الخاصة باللاعب.
• توفر API للمطورين / wiki للإضافات.
• تتعامل مع التكامل مع الإضافات الشائعة لتعطيل الأنيميشن أو تعديلها (إضافات vanish، OpenInv، إلخ.).

🧩 لمن هي مناسبة

• سيرفرات Survival وSMP التي تريد ردود فعل بصرية أكثر غمرًا عند التفاعل مع البلوكات.
• سيرفرات الزينة/التمثيل التي تفضل لمسة بصرية على جانب العميل دون تعديل بيانات العالم.
• مسؤولو السيرفر الذين يريدون تحكمًا اختياريًا لكل لاعب في المؤثرات البصرية.

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

• إظهار العناصر وهي تظهر على crafting table عندما يملأ اللاعب خانات الوصفة حتى يتمكن اللاعبون القريبون من رؤية التقدم.
• عرض هولوجرام للتقدم في furnace وعناصر تظهر بصريًا بينما يتفاعل اللاعب مع واجهة furnace.
• السماح للاعبين بتبديل وحدات العرض التي يرونها (itemstands، dropped items، holograms).

⌨️ الأوامر

🔐 Permissions

⚙️ التثبيت

📥 الإعداد

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

📦 الاعتماديات

• ProtocolLib (مطلوب لإصدارات السيرفر الأقدم / لمعالجة packets حيث يحدد ذلك).
• LightAPI Fork (مطلوب للإصدارات الأقدم التي يستخدمها).

التكاملات الخفيفة/الاختيارية التي ذكرها المشروع (تُستخدم لتعديل السلوك): EssentialsX، OpenInv، PlaceholderAPI، SuperVanish، PremiumVanish، CMI.

🧾 الإعدادات

• تحفظ الإضافة تبديلات كل لاعب في SQLite افتراضيًا وتدعم MySQL للتخزين الدائم عبر السيرفرات.
• يمكن تعطيل عرض كل بلوك وكل وحدة من خلال إعدادات الإضافة.

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

• مبنية على API الخاصة بـ Spigot؛ كما تُظهر التوافق مع Paper وعدة إصدارات حديثة من السيرفرات.
• العروض على جانب العميل فقط ولا تنشئ كيانات سيرفر قابلة للقتل أو دائمة.
• توفر الإضافة API للمطورين من أجل إضافات الطرف الثالث، كما أن الترجمات تتم صيانتها من المجتمع.
• يذكر المشروع قيدًا: قد لا يعمل على Minecraft 1.10.2 أو أقل.

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

إذا كنت تريد ردود فعل بصرية غير مزعجة وزخرفية لتفاعلات اللاعبين دون تغيير حالة السيرفر، فإن InteractionVisualizer يوفر أنيميشن قائمة على packets وتحكمًا لكل لاعب لتعزيز الإحساس بالانغماس مع إبقاء العالم دون تغيير.