SameOS ~/tools/minecraft-rcon-commands.md

마인크래프트 서버 RCON 설정과 자주 쓰는 명령어

작성일 2026-07-26 · SameOS Tools

서버 콘솔에 명령을 치려고 매번 화면 앞에 앉을 필요는 없습니다. 마인크래프트 서버에는 RCON(원격 콘솔 - 다른 프로그램이 네트워크로 서버 콘솔 명령을 보내는 표준 통로)이 내장되어 있어서, 백업 전에 저장을 걸거나 밤중에 공지를 보내는 일을 스크립트로 맡길 수 있습니다. 저희 모드 서버도 이 통로로 자동 백업이 돌아갑니다. 켜는 법 세 줄과, 실제로 손에 붙는 명령만 추려 정리했습니다.

RCON 켜기 - server.properties 세 줄

server.properties 에서 enable-rcon=true 로 바꾸고, rcon.password 에 비밀번호를 넣고, rcon.port(기본 25575)를 확인한 뒤 서버를 재시작하면 끝입니다. 단, 이 비밀번호는 파일에 그대로 적히고 통신도 암호화되지 않습니다 - 25575 포트는 공유기 포트포워딩에 올리면 안 되고, 같은 컴퓨터나 집 안 네트워크에서만 사용합니다. 저희 서버도 방화벽 안에서만 열어 둡니다.

보내는 도구 - mcrcon

명령을 보내는 쪽은 mcrcon 이라는 작은 프로그램 하나면 됩니다(우분투 기준 apt 로 설치됩니다). 터미널에서 바로 명령을 보내거나, 여러 명령을 이어 보낼 수 있어 백업 스크립트에 넣기 좋습니다.

# 설치 (Ubuntu)
sudo apt install mcrcon

# 명령 하나 보내기
mcrcon -H 127.0.0.1 -P 25575 -p 비밀번호 "list"

# 백업 직전의 정석 3연속 - 알리고, 저장 멈추고, 다 쓰게 하기
# (백업 후 save-on 으로 다시 켜는 것 잊지 마세요)
mcrcon -H 127.0.0.1 -P 25575 -p 비밀번호 \
       "say 1분 뒤 자동 백업이 시작됩니다" "save-off" "save-all"

실제로 자주 쓰는 명령

명령은 수백 개지만, 운영하면서 손에 붙는 건 이 정도입니다. 콘솔·RCON에서는 앞의 / 없이 씁니다.

상황명령설명
접속 관리 list 지금 누가 들어와 있는지
whitelist add 이름whitelist on 아는 사람만 들어오게 (신규 서버 필수)
kick 이름ban 이름pardon 이름 강퇴 · 밴 · 밴 해제
op 이름deop 이름 운영자 권한 주기/뺏기
저장·종료 save-all 지금 즉시 월드 저장
save-offsave-on 백업 중 저장 멈춤/재개 (파일 깨짐 방지)
stop 저장하고 안전하게 종료 (프로세스 강제 종료 금지)
월드 설정 gamerule keepInventory true 죽어도 아이템 유지 (친목 서버 인기 설정)
difficulty peaceful~hard 난이도 변경
time set dayweather clear 시간·날씨 즉시 변경
알림·이동 say 내용 전체 공지
tp 이름 대상 플레이어 이동
give 이름 아이템 수량 아이템 지급

stop 대신 프로세스를 강제로 끊으면 마지막 저장 이후 진행이 날아갑니다 - 도커로 운영한다면 2탄에서 다룬 "서버를 끄지 않는 백업"과 이 표의 save-off/save-all 조합이 그대로 이어집니다. 램·인원 설정은 최적화 글에 있습니다.

2탄 - Fabric 모드 서버와 Docker 운영 3탄 - 렉 없는 서버 설정과 적정 인원