إضافة Minecraft FastAsyncWorldEdit

🔌 حول FastAsyncWorldEdit

FastAsyncWorldEdit هو إضافة Minecraft مصممة لتنفيذ تعديلات العالم الكبيرة والمتكررة بشكل غير متزامن لتجنب حظر الخادم. وهو fork عالي الأداء من WorldEdit يركز على تحسينات الذاكرة ووحدة المعالجة، والتعديل الآمن لعدة مستخدمين، وميزات محرر إضافية مفيدة للبنّائين وصنّاع الخرائط ومديري الشبكات.

🎯 الغرض

الغرض الأساسي من الإضافة هو تمكين طاقم الخادم والمطورين من إجراء تعديلات ضخمة جدًا (schematics، الاستبدال الجماعي، تعبئة المناطق، copy/paste) وتوفير سجل دائم، وrollback، وخدمات clipboard مع تقليل التأثير على أداء ticks في الخادم.

⚙️ الميزات

• معالجة التعديلات بشكل غير متزامن مع عدة أوضاع وضع (blocks، chunk placement، world/CFI) لتقليل الحمل على الـ main thread.
• دعم التعديلات الكبيرة ووسائل الحماية لخوادم تعدد اللاعبين (حدود لكل لاعب للـ entities، وtiles، والذاكرة، والتغييرات، والتكرارات، والمناطق، والمخزون).
• تكامل clipboard عبر الويب وclipboard عبر عدة خوادم/بين الخوادم.
• سجل undo/redo غير محدود لكل عالم، وأدوات فحص وrollback للبحث عن التغييرات واستعادتها.
• واجهة API موسعة متوافقة مع WorldEdit وwrappers غير متزامنة للعمليات الشائعة.
• الكثير من الفرش والأدوات والأقنعة وصيغ الأنماط والتحويلات وصيغ schematic الإضافية (بما في ذلك إصلاح schematics المتضررة جزئيًا).
• ميزات التصور، وأوضاع التوجيه، وإجراءات التمرير، ومزج الأحياء الحيوية، والرسم داخل اللعبة، واستيراد الصور، وتصور schematic.
• عناصر تحكم في التسجيل (ضغط وتخزين مؤقت قابلان للتهيئة) وخيار تجاوز للتعديلات السريعة غير المسجلة.

🧩 لمن هذا مناسب

• مسؤولو الخوادم والمشرفون الذين ينفذون builds كبيرة أو يديرون مناطق creative/شبيهة بالـ creative.
• صنّاع الخرائط والبنّاؤون الذين يحتاجون إلى لصق وتحويل وإدارة schematics كبيرة جدًا.
• مشغلو الشبكات الذين يحتاجون إلى تعديل آمن وعالي الإنتاجية عبر عدة خوادم backend.
• المطورون الذين يحتاجون إلى سلوك API متوافق مع WorldEdit لكنهم يريدون عمليات غير متزامنة وغير حاجزة.

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

• لصق وتحويل schematic كبيرة جدًا دون التسبب في تأخير كبير في ticks للاعبين المتصلين.
• البحث في السجل الأخير وتنفيذ rollback موجّه بعد تغيير كبير غير مقصود.
• استخدام clipboards دائمة لمشاركة builds بين الخوادم أو بين أعضاء الفريق.

⚙️ التثبيت

📥 الإعداد

• نزّل ملف jar الرسمي للإضافة من صفحة إصدار موثوقة (Modrinth أو صفحة موارد الإضافة).
• ضع ملف jar في مجلد plugins/ الخاص بخادمك.
• أعد تشغيل الخادم وتحقق من سجلات console للتأكد من أن الإضافة تم تحميلها بشكل صحيح.

📦 التبعيات

• تتكامل FAWE مع إضافات الحماية؛ وتشمل التكاملات المدعومة المعروفة WorldGuard و PlotSquared (مذكورة كتکاملات مدعومة، وليست تبعيات أساسية مطلوبة).

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

• تحافظ FAWE على توافق API مع WorldEdit وتضيف wrappers غير متزامنة بحيث تعمل العديد من إضافات WorldEdit مع العمليات غير المتزامنة في FAWE.
• تشمل منصات الخادم المدعومة رسميًا Bukkit/Spigot/Paper/Purpur. أكّد التوافق الدقيق مع build خادمك قبل النشر.
• تغطي الإصدارات وملاحظات التوافق نسخ Minecraft الحديثة (تسلسلات متعددة 1.16.5+ و1.20/1.21 مدرجة من المشروع)؛ تحقق من الإصدار الذي تنزله لمعرفة النسخ المدعومة بدقة.
• تم نشر المشروع تحت رخصة GPL-3.0-only.

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

إذا كنت تنفذ بانتظام تعديلات واسعة النطاق، أو تدير خوادم creative أو خوادم للبنّائين الكبار، أو تحتاج إلى سلوك API الخاص بـ WorldEdit دون حظر main thread الخاص بالخادم، فإن FastAsyncWorldEdit يوفر عمليات غير متزامنة، وأدوات محسّنة، وميزات rollback/السجل التي تقلل الانقطاعات المرتبطة بالتعديل وتجعل التعديلات الكبيرة أكثر أمانًا على الخوادم الحية.