إضافة Minecraft SkBee

🔌 حول SkBee

SkBee هو إضافة لـ Skript توسّع لغة Skript بمجموعة واسعة من العناصر التي تكشف تفاصيل داخلية للسيرفر وميزات Minecraft الحديثة أمام كتّاب السكربتات. يوفّر صيغًا وأدوات للعمل مع NBT، ومكوّنات نصية متقدمة، ولوحات النتائج، والوصفات، وبيانات البلوكات، والهياكل، وإنشاء العوالم، وregions/bounds بسيطة — مما يتيح لمديري السيرفرات تنفيذ آليات معقدة باستخدام Skript بدلًا من Java.

🎯 الهدف

الهدف الأساسي من SkBee هو منح مستخدمي Skript وصولًا مباشرًا إلى ميزات Bukkit/Paper APIs وداخلية Minecraft التي يصعب أو يستحيل تحقيقها عادةً باستخدام Skript القياسي. وهو مخصص لأصحاب السيرفرات ومطوري السكربتات الذين يحتاجون إلى تحكم أدق في العناصر، والكيانات، وتنسيق النص، والتعامل مع العالم، وإدارة الهياكل داخل سكربتات Skript.

⚙️ الميزات

• عناصر NBT: جلب/تعيين NBT للعناصر وكيانات البلوكات (tile entities) والكيانات، مع ملاحظة توفرها للإصدارات الأقدم حتى 1.8.8+ حيثما كانت مدعومة.
• FastBoards: تنفيذ للوحة النتائج مصمم لتقليل الوميض (متاح في إصدارات Minecraft الأحدث حيثما كان مدعومًا).
• Recipes: إضافة وصفات مخصصة وإزالة وصفات vanilla (وتُذكر هذه الميزات بأنها متاحة من الإصدارات الأحدث، مثل 1.13+ لواجهات recipe).
• BlockData: وصول مبسّط لجلب/تعيين بيانات البلوكات لحالات البلوكات الحديثة (متاح في الإصدارات المدعومة).
• Structures: حفظ ولصق هياكل Minecraft vanilla باستخدام نظام الهياكل في اللعبة.
• TextComponents: إنشاء رسائل بنمط JSON/TextComponent والتعامل معها مع أحداث hover وclick ودعم hover على العناصر.
• WorldCreator: إنشاء عوالم مخصصة بخيارات قابلة للضبط ومكشوفة لـ Skript.
• Bounds: إنشاء bounds/regions بسيطة تشبه حماية المناطق الخفيفة للاستخدام في Skript.
• GameEvents: الربط مع نظام GameEvent في Minecraft (يُستخدم بواسطة skulk sensors والآليات المرتبطة بها).

🧩 لمن هذا المكوّن؟

• مديري السيرفرات الذين يستخدمون Skript ويحتاجون إلى وصول أعمق إلى الـ API دون كتابة إضافات Java.
• مطوري Skript الذين يبنون واجهات GUI متقدمة، أو عناصر مخصصة، أو رسائل منظمة، أو أدوات للعالم/الهياكل.
• سيرفرات Survival وSMP والسيرفرات المخصصة التي تعتمد على Skript في آليات اللعب وتريد توسيع الوظائف.

🏗️ أمثلة على الاستخدام

• يقرأ أحد مطوري السكربتات NBT الخاص بالعنصر ويعدّله لتطبيق سلوك وخصائص عنصر مخصص داخل Skript.
• ينشئ مدير السيرفر وصفات crafting مخصصة ويزيل وصفات vanilla غير المرغوب فيها باستخدام صياغة Skript.
• يحفظ المصممون الهياكل الجاهزة ويلصقونها أثناء توليد العالم أو باستخدام أدوات البناء داخل اللعبة.
• أنظمة الدردشة أو واجهات GUI التي تحتاج إلى مكوّنات نصية JSON مع إجراءات hover/click ومعاينات العناصر.

⚙️ التثبيت

📥 الإعداد

• احصل على ملف SkBee .jar من مصدر تنزيل رسمي وضعه في مجلد plugins/ الخاص بالسيرفر إلى جانب Skript.
• أعد تشغيل السيرفر لكي يتم تحميل Skript وإضافاته بشكل سليم.
• افحص سجلات وحدة تحكم السيرفر للتأكد من أن SkBee تم تحميله بنجاح وأنه اكتشف إصدار Skript المثبت.

📦 المتطلبات

• Skript (SkBee هو إضافة لـ Skript؛ والإصدارات الحديثة من SkBee تتطلب إصدارات حديثة من Skript — راجع ملاحظات إصدار الإضافة لمعرفة إصدار Skript المطلوب بدقة).

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

• تتم صيانة SkBee كمشروع مفتوح المصدر بموجب رخصة GPL-3.0.
• قد تكون بعض الميزات مرتبطة بالإصدار: بعض العناصر (مثل التعامل مع NBT) لديها ملاحظات توافق مع إصدارات Minecraft الأقدم (تشير الأمثلة في الوثائق الأصلية إلى التوفر من 1.8.8+ لبعض الميزات و1.13+ لغيرها).
• يوفر SkBee مستندات JavaDocs وويكي للصيغ؛ راجع هذه المراجع عند كتابة ملفات Skript التي تستخدم ميزات SkBee.
• يهدف SkBee إلى دعم إصدارات Skript الحديثة وإصدارات Minecraft الحديثة؛ وتختلف النسخ المطلوبة من Skript أو Minecraft حسب إصدار SkBee — تحقق من ملاحظات الإصدار للبنية التي تقوم بتنزيلها.

🤝 متى يكون هذا المكوّن مفيدًا

إذا كنت تعتمد على Skript كنظام كتابة السكربتات في السيرفر وتحتاج إلى الوصول إلى NBT، أو رسائل نصية منظمة، أو وصفات مخصصة، أو حفظ/لصق الهياكل، أو أدوات بسيطة لإنشاء المناطق والعوالم دون كتابة Java، فإن SkBee يوفّر مجموعة واسعة من الصيغ والأدوات المؤكدة لتوسيع ما يمكنك تنفيذه باستخدام Skript فقط.