Minecraft Servers HQ

إضافة Minecraft ProtocolLib

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

🔌 حول ProtocolLib

ProtocolLib هي مكتبة إضافة Minecraft تتيح بروتوكول الشبكة لإضافات أخرى. وهي توفر واجهة برمجة تطبيقات لقراءة الحِزم الخام وتعديلها وإلغائها وإرسالها بين الخادم والعميل، من دون أن تحتاج الإضافات إلى الاعتماد على الأجزاء الداخلية المبهمة من الخادم.

🎯 الهدف

يهدف ProtocolLib إلى جعل العمل على مستوى الحِزم أكثر موثوقية وأسهل في الصيانة لمطوري الإضافات. فهو يركّز الوصول إلى الحِزم خلف واجهة برمجة تطبيقات مستقرة، بحيث يمكن لعدة إضافات فحص حركة الحِزم وتغييرها من دون الارتباط مباشرةً بالفئات الداخلية للخادم.

⚙️ المميزات

  • واجهة برمجة تطبيقات بأسلوب الأحداث لاعتراض الحِزم الواردة والصادرة.
  • أدوات قراءة/كتابة للحقول الشائعة في الحِزم (strings و ints و vectors وما إلى ذلك).
  • القدرة على إلغاء الحِزم أو تعديل محتواها قبل وصولها إلى وجهتها.
  • أداة لإنشاء الحِزم وإرسالها من جانب الخادم.
  • إخفاء فئات الخادم المبهمة خلف نظام قراءة/كتابة قائم على الفهرس لتحسين الاستقرار بين الإصدارات.
  • يُوزَّع كملف jar على جانب الخادم ويمكن استخدامه كاعتماد وقت الترجمة عند بناء الإضافات.

🧩 لمن هو مخصص

  • مطورو الإضافات الذين يحتاجون إلى تحكم على مستوى الحِزم (التجميلات، التنكر، تأثيرات العميل المخصصة، أدوات الشبكة).
  • مشغلو الخوادم الذين يشغّلون إضافات تعتمد على الوصول المباشر إلى البروتوكول.

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

  • الاستماع إلى حِزم الدردشة لتطبيق فلترة على جانب الخادم قبل اعتماد الرسائل.
  • إرسال حزمة انفجار مُصمَّمة خصيصًا إلى لاعب لإظهار تأثير على جانب العميل من دون تغيير حالة العالم.
  • تنفيذ التنكر، أو الحركات المخصصة، أو المؤثرات البصرية الأخرى الخاصة بالعميل والتي تتطلب التلاعب بالحِزم.

⌨️ الأوامر

لا يوفّر ProtocolLib بحد ذاته أي أوامر موجهة للمستخدم؛ فهو مكتبة للمطورين وليس إضافة ميزات.

⚙️ التثبيت

📥 الإعداد

  • حمّل ملف jar الرسمي لـ ProtocolLib وضعه في مجلد plugins/ الخاص بالخادم.
  • أعد تشغيل الخادم وتحقق من وحدة تحكم الخادم للتأكد من أن الإضافة تعمل من دون أخطاء.
  • عند تطوير إضافة تستخدم ProtocolLib، أضفه كاعتماد وقت الترجمة واذكره (أو اجعله soft-depend) في ملف manifest الخاص بإضافتك.

📦 الاعتمادات

  • لا يحتاج ProtocolLib إلى أي إضافات خادم أخرى ليعمل؛ فهو مخصص ليُستخدم من قِبل إضافات أخرى كمكتبة.

🧾 الإعدادات

  • ينشئ ProtocolLib ملفات الإعدادات الخاصة به عند التشغيل لأول مرة. أما الإعدادات الخاصة بكل إضافة فتتولاها الإضافات التي تستخدم ProtocolLib.

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

  • يوفّر ProtocolLib نقطة دخول ProtocolManager لتسجيل مستمعي الحِزم وإرسالها برمجيًا.
  • يُوزَّع المشروع تحت رخصة GPL-2.0.
  • يتم نشر إعدادات Maven/Gradle لاستخدامها كاعتماد وقت الترجمة.
  • تتم صيانة ProtocolLib مع مراعاة التوافق مع نطاق واسع من إصدارات خوادم Minecraft؛ وهو موجَّه أساسًا إلى برمجيات الخادم المشتقة من Bukkit.

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

إذا كان مشروعك يحتاج إلى فحص بروتوكول Minecraft الخام أو تعديله (للتأثيرات على جانب العميل، أو المؤثرات البصرية المخصصة، أو الخطافات على مستوى الشبكة)، فإن ProtocolLib يركّز هذا العمل ويجعله أكثر استقرارًا بحيث يمكن لعدة إضافات التعامل مع الحِزم بأمان.

خوادم تستخدم ProtocolLib

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

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

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

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