إضافة Minecraft ProtocolLib
ProtocolLib هي مكتبة إضافات لـ Minecraft تمنح الإضافات الأخرى وصولاً مباشرًا للقراءة والكتابة إلى بروتوكول الشبكة، مما يتيح اعتراض الحزم وتعديلها.
ابحث عن خادم يستخدم ProtocolLib
خوادم أبلغت عن ProtocolLib: ١٦٥
- FRIENDS SMP ѕᴜʀᴠɪᴠᴀʟ | ᴘᴠᴘ | ʟɪꜰᴇѕᴛᴇᴀʟᴢ !! ٠ متصلJava
- 'A savage place! / as holy and enchanted / As e’er beneath a ٢٣ متصل
- J's Hideout SMP ٢٠ متصلJava + Bedrock
- play.vcraft.fr:23020 ٢٠ متصلJava + Bedrock
- LinkCraft ١٥ متصلJavaProgression
- ARUNIKA ٢١ متصلJavaSurvivalCustom
حول 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 يركّز هذا العمل ويجعله أكثر استقرارًا بحيث يمكن لعدة إضافات التعامل مع الحِزم بأمان.
التعليقات
لا توجد تعليقات بعد
كن أول من يعلّق.
لمشرفي الخوادم
- المؤلفون
- dmulloy2, aadnk
- الترخيص
- GPL-2.0
- المنصات المدعومة
- Bukkit, Spigot, Paper
- الإصدارات المدعومة
- 1.8–1.21
روابط
- تحميلspigotmc.org/resources/protocollib.1997
- الكود المصدريgithub.com/dmulloy2/ProtocolLib
- التوثيقprotocollib.org
- متتبع المشكلاتgithub.com/dmulloy2/ProtocolLib/issues
- الدعمgithub.com/dmulloy2/ProtocolLib/discussions
- protocollib.comprotocollib.com
- BukkitDev pagedev.bukkit.org/projects/protocollib
- GitHubgithub.com/sponsors/dmulloy2
- protocollib.comprotocollib.com
- protocollib.netprotocollib.net
ما تبلغ عنه الخوادم
منصات الخوادم
- Paper١١٢
- Purpur١٩
- CraftBukkit١٣
- Arclight٥
- Leaf٤
- Cauldron٣
- Mohist٢
- Spigot٢
- Yatopia١
- CatServer١
- Cauldron-MCPC-Plus١
- Reaper١
- Parchment١
إصدارات الإضافة
- 5.4.0٧٢
- 5.5.0٥٥
- 5.4.1٩
- 5.3.0٦
- 4.8.0٤
- 4.7.0٢
- 5.2.0٢
- 3.4.0٢
- 5.0.0٢
- 4.6.0٢
- 5.1.0٢
- 5.1.1٢
- 2.7.0١
- 3.7.0١
- 2.7.3١
- 4.4.0١
- 4.5.1١
الأعداد من الخوادم التي تعرض إضافاتها عند فحص MSHQ. كثير من الخوادم تخفي القائمة، لذا الاستخدام الفعلي أعلى.