Cấu hình plugin: YAML không lỗi

Phần lớn các trường hợp "máy chủ không khởi động sau khi chỉnh sửa" là do YAML bị hỏng.

Năm quy tắc

1. Chỉ dùng dấu cách. Dấu tab bị cấm trong YAML. Trình soạn thảo của bảng điều khiển sẽ đánh dấu chúng là lỗi.
2. Thụt lề nghĩa là lồng nhau. Dịch một dòng đi một dấu cách là bạn đã thay đổi cấu trúc.
3. Một dấu cách sau dấu hai chấm. key:value là sai, key: value mới đúng.
4. Dùng dấu ngoặc kép cho ký tự đặc biệt. Bọc trong dấu ngoặc kép mọi chuỗi chứa :, #, &, % hoặc bắt đầu bằng chữ số: motd: "Server: survival".
5. Danh sách dùng dấu gạch ngang theo sau là một dấu cách.

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

Cách kiểm tra

• Trình soạn thảo của bảng điều khiển có thể mở .yml dưới dạng form: kiểu trường được suy ra từ các giá trị, và cấu trúc không thể bị phá vỡ — đây là lựa chọn an toàn nhất.
• Bất kỳ trình kiểm tra YAML trực tuyến nào.
• Log: lỗi như while scanning ... could not find expected ':' có kèm số dòng — Cannot load configuration.

Mã hóa

Các tệp chứa văn bản tiếng Nga phải ở định dạng UTF-8 không có BOM. Nếu không, bạn sẽ gặp ký tự lỗi trong chat — Localization.

Sao lưu config

Trước khi chỉnh sửa lớn, hãy sao chép tệp ngay bên cạnh (config.yml.bak) — trong bảng điều khiển đó chỉ là một nút "Copy". Khôi phục một config đang hoạt động tốt vẫn dễ hơn là cố nhớ xem bạn đã thay đổi những gì.

Sau khi chỉnh sửa

Config được đọc khi khởi động. Một số plugin hỗ trợ /plugin reload, nhưng reload plugin trên máy chủ đang chạy là nguồn gốc của những lỗi khó truy vết. Khởi động lại đáng tin cậy hơn.