ProtocolLib: لماذا نحتاجه
مكتبة للتعامل مع حزم الشبكة: أي إضافات تحتاجها، ولماذا تتعطل أولًا عند تحديث الإصدار، وكيفية إصلاحها.
آخر تحديث 13 أغسطس 2026
ProtocolLib يمنح المودات (الإضافات) إمكانية الوصول إلى حزم الشبكة المتبادلة بين العميل والخادم. بمفرده، لا يفعل شيئًا، لكن العديد من الإضافات الشائعة لن تعمل بدونه.
من يحتاجه
الهولوغرامات من الجيل القديم، وبعض مضادات الغش، وإضافات السكن والشخصيات غير اللاعبة (NPC)، والواجهات المخصصة، والإضافات التي تتجاوز عرض الكتل.
الميزة الأساسية
يرتبط ProtocolLib بالبنية الداخلية لإصدار معين من Minecraft ارتباطًا أوثق من أي إضافة عادية. لهذا السبب، بعد تحديث الخادم، يكون أول ما يتعطل:
[ProtocolLib] Unsupported server version
الحل الوحيد هو تحديث ProtocolLib إلى إصدار متوافق مع إصدارك. أحيانًا يلزم استخدام إصدار تطويري: إذ يصدر الإصدار المستقر لاحقًا.
ما يحدث عند تعطله
الإضافات التي تعتمد عليه لن تُحمَّل: سيظهر في السجل NoClassDefFoundError أو فشل في التحميل يشير إلى الاعتماد — اعتماد مفقود.
التحميل
اعتراض الحزم ليس مجانيًا. إذا كانت إضافة واحدة فقط تحتاج ProtocolLib وكنت لا تستخدم تلك الإضافة، فأزل كليهما. على خادم يضم العديد من اللاعبين، يظهر هذا بوضوح في تحليل الأداء — Spark.
التحقق
/protocol dump
سيعرض الإصدار والحالة. إذا اشتكت الإضافة من عدم التوافق لكن الخادم يبدو يعمل، فبعض الميزات تكون قد عُطِّلت بصمت بالفعل.
