إعدادات الإضافات: YAML بدون أخطاء

أكثر من نصف حالات "الخادم لا يبدأ بعد التعديل" سببها ملف YAML معطوب.

خمس قواعد

1. مسافات فقط. تُمنع علامات الجدولة (Tabs) في YAML. وترصدها محرّرة لوحة التحكم كخطأ.
2. الإزاحة تعني التداخل. أزح سطرًا بمقدار مسافة واحدة فتصبح قد غيّرت البنية.
3. مسافة بعد النقطتين الرأسيتين. key:value خطأ، وkey: value صحيح.
4. علامات اقتباس للمحارف الخاصة. ضع بين علامات اقتباس أي نص يحتوي على : أو # أو & أو % أو يبدأ برقم: motd: "Server: survival".
5. القوائم تستخدم شرطة متبوعة بمسافة.

kits:
  start:
    delay: -1
    items:
      - "stone_sword 1"
      - "bread 16"

كيف تتحقق

• تستطيع محرّرة لوحة التحكم فتح ملف .yml على هيئة نموذج: إذ تُستنتج أنواع الحقول من القيم، ولا يمكن إفساد البنية — وهو الخيار الأكثر أمانًا.
• أي أداة تحقق من YAML عبر الإنترنت.
• السجل: خطأ مثل while scanning ... could not find expected ':' يتضمن رقم السطر — Cannot load configuration.

الترميز

يجب أن تكون الملفات التي تحتوي على نص روسي بترميز UTF-8 دون BOM. وإلا ظهرت محارف مشوّهة في الدردشة — Localization.

نسخة احتياطية من الإعدادات

قبل تعديل كبير، انسخ الملف بجانبه (config.yml.bak) — وفي لوحة التحكم يكفي زر "Copy" واحد. فاستعادة إعدادات عاملة أسهل من محاولة تذكّر ما غيّرته.

بعد التعديل

تُقرأ الإعدادات عند بدء التشغيل. وبعض الإضافات تدعم /plugin reload، لكن إعادة تحميل الإضافات على خادم قيد التشغيل مصدر لأخطاء يصعب تتبعها. وإعادة التشغيل أكثر موثوقية.