ops.json, banned-players.json 및 기타 목록

서버 서비스 JSON 파일: 운영자, 밴, 화이트리스트, 닉네임 캐시 — 무엇이 들어 있는지, 언제 수동으로 편집하는지 다뤄요.

업데이트 2026년 8월 13일

서버는 플레이어 목록을 루트에 있는 JSON 파일로 저장해요. 보통은 명령어로 관리하지만, 파일을 직접 여는 편이 더 빠를 때도 있어요.

파일	내용
`ops.json`	운영자, 접근 레벨, `bypassesPlayerLimit`
`whitelist.json`	화이트리스트
`banned-players.json`	닉네임과 UUID 기준 차단
`banned-ips.json`	IP 기준 차단
`usercache.json`	닉네임 → UUID 매핑 캐시

ops.json 예시

[
  {
    "uuid": "8a1b...",
    "name": "Steve",
    "level": 4,
    "bypassesPlayerLimit": true
  }
]

서버가 중지된 상태에서만 편집하세요. 실행 중인 서버는 목록을 메모리에 보관하고 종료할 때 파일을 덮어쓰기 때문에, 편집한 내용이 사라져요.
형식이 엄격해요. 쉼표가 하나만 더 있어도 파일 전체가 깨지고, 서버는 빈 운영자 목록으로 시작해요.
UUID는 닉네임과 일치해야 해요. 정품 서버에서는 UUID가 영구적이지만, 닉네임 로그인을 사용하는 서버에서는 닉네임으로부터 계산되므로 online-mode를 변경하면 모든 목록이 사실상 일치하지 않게 돼요.

이것이 “운영자와 영역이 모두 사라졌다”는 상황의 가장 흔한 원인이에요. 플레이어 UUID가 바뀌면서 기존 항목이 더 이상 누구도 가리키지 않게 돼요. 자세한 내용은 닉네임 로그인을 참고하세요.

권한 및 차단 플러그인은 데이터를 별도로(파일 또는 MySQL) 저장하며 바닐라 목록을 무시해요 — LuckPerms, 차단과 음소거.

Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기