플러그인 설정: 오류 없는 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 ':' 같은 오류에는 줄 번호가 포함돼요 — 구성을 불러올 수 없음.

인코딩

러시아어 텍스트가 포함된 파일은 BOM 없는 UTF-8이어야 해요. 그렇지 않으면 채팅에 깨진 문자가 나타나요 — 현지화.

구성 백업

큰 수정을 하기 전에 파일을 같은 위치에 복사해 두세요(config.yml.bak). 제어판에서는 "복사" 버튼 하나로 할 수 있어요. 무엇을 바꿨는지 기억해내는 것보다 작동하는 구성을 복원하는 게 더 쉬워요.

수정 후

구성은 시작할 때 읽혀요. 일부 플러그인은 /plugin reload를 지원하지만, 실행 중인 서버에서 플러그인을 리로드하는 것은 원인을 추적하기 어려운 오류의 원인이 돼요. 재시작이 더 안정적이에요.