پلگ ان کنفگز: بغیر غلطیوں کے YAML

"کوئی ترمیم کے بعد سرور اسٹارٹ نہیں ہوتا" کے آدھے سے زیادہ کیسز میں خراب YAML ہی وجہ ہوتی ہے۔

پانچ اصول

1. صرف اسپیسز۔ 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 ':' جیسا ایرر لائن نمبر کے ساتھ آتا ہے — کنفیگریشن لوڈ نہیں ہو سکتی.

انکوڈنگ

روسی متن والی فائلوں کا UTF-8 بغیر BOM ہونا لازمی ہے۔ ورنہ چیٹ میں حروف خراب نظر آئیں گے — لوکلائزیشن.

کنفگ کا بیک اپ

کسی بڑی ترمیم سے پہلے فائل کی کاپی اسی کے ساتھ بنا لیں (config.yml.bak) — پینل میں یہ صرف ایک "Copy" بٹن کا کام ہے۔ کام کرنے والی کنفگ بحال کرنا اس سے کہیں آسان ہے کہ آپ یاد کرنے کی کوشش کریں کہ کیا تبدیل کیا تھا۔

ترمیم کے بعد

کنفگ اسٹارٹ اپ پر پڑھی جاتی ہے۔ کچھ پلگ انز /plugin reload کو سپورٹ کرتے ہیں، لیکن لائیو سرور پر پلگ انز ری لوڈ کرنا ایسے ایررز کا سبب بنتا ہے جن کا سراغ لگانا مشکل ہوتا ہے۔ ری اسٹارٹ زیادہ قابلِ بھروسا ہے۔