NBT-API (Item-NBT-API) هي مكتبة إضافات Minecraft تتيح للمطوّرين قراءة وكتابة وإرفاق وسوم NBT بالعناصر والكيانات وكيانات الكتل دون استخدام NMS. يوفّر المشروع غلافًا مستقرًا للتعامل مع NBT عبر إصدارات الخوادم، كما يقدّم أدوات لتسلسل بيانات NBT وحفظها بشكل دائم.

🎯 الهدف

توفير واجهة برمجة تطبيقات موجّهة للمطوّرين لمعالجة بيانات Named Binary Tag (NBT) حتى يتمكّن مؤلفو الإضافات من تخزين البيانات الوصفية وبيانات العناصر المخصصة ووسوم الكيانات أو بيانات كيانات الكتل دون الاعتماد مباشرةً على داخليات الخادم.

⚙️ الميزات

قراءة وكتابة NBT للعناصر والكيانات وكيانات الكتل.
إنشاء وتعديل الحاويات المركبة المتداخلة في NBT وأنواع الوسوم البدائية.
أدوات لتخزين NBT كنص أو في حاويات أخرى.
دعم تسلسل NBT إلى ملفات أو كسلاسل نصية للتخزين في YAML/JSON/SQL/Redis.
يهدف إلى توفير طبقة تجريد مستقرة عبر تغييرات إصدارات الخادم.

🧩 لمن هو مخصص

مطورو الإضافات الذين يحتاجون إلى وصول موثوق إلى NBT دون كتابة NMS.
الخوادم التي تتطلب بيانات وصفية مخصصة للعناصر أو بيانات دائمة للكيانات/كيانات الكتل تديرها الإضافات.

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

إرفاق بيانات وصفية مخصصة إلى item stack تبقى محفوظة عبر عمليات الحفظ.
تخزين خصائص إضافية على الكيانات (مثل المعرّفات المخصصة) دون تغيير كود الخادم.
تسلسل NBT الخاص بالعناصر أو البلوك إلى قاعدة بيانات أو ملف إعدادات لاستعادته لاحقًا.

⚙️ التثبيت

📥 الإعداد

حمّل ملف JAR الرسمي للإضافة و/أو أضف API كاعتماد في نظام البناء لديك.
ضع ملف JAR الخاص بالإضافة في مجلد الخادم plugins/ (إذا كنت تستخدم بناء الإضافة) أو أضف API كاعتماد compile/runtime لإضافتك.
أعد تشغيل الخادم وتحقق من وحدة تحكم الخادم للتأكد من أن المكتبة/الإضافة تم تحميلها بشكل صحيح.

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

يتم نشر المشروع وصيانته على GitHub ويُوزَّع تحت رخصة MIT.
تشير المصادر الرسمية إلى دعم بيئات خوادم Bukkit/Spigot/Paper.
تتضمن المكتبة وحدات للاستخدام المباشر في مشاريع الإضافات ووحدة إضافية لاستخدام الخادم.

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

إذا كنت تحتاج إلى وصول موثوق ومتوافق مع الإصدارات إلى NBT للعناصر أو الكيانات أو كيانات الكتل دون لمس NMS، فإن NBT-API توفّر مكتبة مركزة تبسّط قراءة هذه البيانات وكتابتها وحفظها لمطوري الإضافات.

خوادم تستخدم NBTAPI