화이트리스트·관리자(OP) 설정
허용한 사람만 들어오게 막고, 관리자 권한을 주고 빼는 방법
마지막 수정 2026.10.22
화이트리스트는 허용한 사람만 서버에 들어오게 하는 기능이에요. OP 는 명령어를 쓸 수 있는 관리자 권한이에요.
도움말
아래 명령은 서버 창(콘솔) 에 입력할 때는 / 없이, 게임 안 채팅에서는 / 를 붙여 입력해요. 게임 안에서는 OP 권한이 있어야 쓸 수 있어요.
자바 에디션 화이트리스트
켜기
서버 창에 아래를 입력해요.
whitelist on들어올 사람을 추가해요. 닉네임은 정확히 입력해 주세요.
whitelist add 닉네임
자주 쓰는 명령
| 명령 | 하는 일 |
|---|---|
whitelist add 닉네임 | 허용 목록에 추가 |
whitelist remove 닉네임 | 허용 목록에서 빼기 |
whitelist list | 허용 목록 보기 |
whitelist off | 화이트리스트 끄기 |
whitelist reload | whitelist.json 을 직접 고친 뒤 다시 읽기 |
이미 접속한 사람도 바로 내보내려면
server.properties 에서 아래 두 줄을 true 로 바꾸고 서버를 재시작해요.
white-list=true
enforce-whitelist=true
enforce-whitelist=true 이면 목록에서 뺀 사람이 접속 중일 때 바로 나가게 돼요.
자바 에디션 관리자(OP)
op 닉네임
deop 닉네임
op로 권한을 주고,deop로 빼요.- 권한 목록은 서버 폴더의
ops.json에 저장돼요. - 새로 준 OP 의 권한 단계는
server.properties의op-permission-level값(기본 4)을 따라요.
주의
OP 는 월드를 지우거나 다른 사람을 내보낼 수 있는 강한 권한이에요. 믿을 수 있는 사람에게만 주세요.
베드락 에디션
베드락 서버(베드락 서버 열기)는 명령 이름이 조금 달라요.
server.properties에서allow-list=true로 바꾸고 서버를 재시작해요.서버 창에서 아래처럼 관리해요.
allowlist add 닉네임 allowlist remove 닉네임 allowlist list op 닉네임 deop 닉네임
목록은 allowlist.json, 권한은 permissions.json 에 저장돼요.
잘 안 될 때
- "You are not white-listed on this server!" 가 나오면 그 닉네임이 목록에 없는 거예요. 철자를 확인하고 다시
add해 주세요. - 닉네임을 바꾼 사람은 새 닉네임으로 다시 추가해야 할 수 있어요.
online-mode=false면 화이트리스트가 제대로 동작하지 않을 수 있어요. 이유는 server.properties 주요 설정을 봐 주세요.
해결이 안 되면 문의게시판에 서버 이름과 오류 메시지를 남겨 주세요.
문제가 해결되지 않았나요?
서버 이름과 증상, 오류 화면을 문의게시판에 남겨 주시면 순서대로 확인해 답변드려요.
