마인크래프트 server.properties란? 서버 설정의 핵심 파일
마인크래프트 서버를 운영하기 위한 핵심 설정파일인 server.properties는 서버의 다양한 동작 방식을 세밀하게 제어하는 텍스트 파일입니다. 이 파일을 통해 게임 모드, 난이도, 접속 제한, 월드 생성 방식 등 서버 전반적인 환경을 직접 조절할 수 있습니다. 2026년 10월 기준, 최신 버킷 서버에서도 동일하게 활용되는 중요한 파일로, 효율적인 서버 운영을 위해 필수적으로 이해해야 합니다.
server.properties 파일 위치 및 기본 수정 방법
버킷(Bukkit), 스피곳(Spigot) 등 마인크래프트 서버용 소프트웨어를 설치하고 최초 실행하면 서버 폴더 내에 server.properties 파일이 자동 생성됩니다. 윈도우 환경에서는 해당 파일을 마우스 우클릭 후 ‘연결 프로그램’ → ‘메모장’을 선택해 열 수 있습니다. 수정 시 중요한 점은 서버가 완전히 종료된 상태에서만 변경해야 하며, 변경 후에는 서버를 재시작해야 설정이 정상적으로 반영됩니다.
파일 내 설정은 대부분 true/false(활성/비활성) 또는 특정 키워드 값으로 입력하며, 오타나 잘못된 값 기입 시 서버 실행 오류가 발생할 수 있으니 주의해야 합니다.
마인크래프트 server.properties 주요 설정 옵션 완벽 정리
아래 표는 2026년 현재 서버 운영에 가장 필수적이며 자주 조정되는 주요 옵션들입니다. 각 옵션별 기본값과 기능 설명을 상세히 기술하여, 초보자부터 고급 운영자까지 이해하기 쉽도록 했습니다.
| 옵션명 | 기본값 | 기능 설명 |
|---|---|---|
| allow-flight | false | 서바이벌 모드에서 플라잉 허용 여부. false면 5초 이상 공중 체류 시 자동 킥. |
| allow-nether | true | 지옥(네더) 차원 이동 허용 여부. |
| enable-command-block | false | 커맨드 블록 사용 가능 여부. 서버 내 고급 명령어 실행에 필수. |
| difficulty | easy | 서버 난이도 설정. peaceful, easy, normal, hard 중 선택 가능. |
| gamemode | survival | 기본 게임 모드. survival, creative, adventure, spectator 중 선택. |
| max-players | 20 | 동시 접속 가능한 최대 플레이어 수 설정. |
| white-list | false | 화이트리스트 활성화 여부. 활성 시 등록된 유저만 접속 가능. |
| motd | A Minecraft Server | 서버 접속 시 표시되는 메시지(최대 60자). 한글은 유니코드 변환 필요. |
| online-mode | true | 정품 서버 인증 여부. false로 하면 비정품 유저도 접속 가능. |
| level-seed | (빈값) | 월드 시드 값 입력. 미입력 시 랜덤 시드로 생성. |
server.properties 옵션별 상세 설명
기본적인 설정 외에 서버 운영에 영향을 미치는 주요 옵션들을 더 깊이 해석합니다.
- broadcast-console-to-ops: 서버 콘솔에서 명령어 입력 시, 운영자(OP)에게 해당 명령이 채팅으로 전달됩니다. 기본값 true로 서버 관리 편의성을 높임.
- enforce-secure-profile: 채팅 신고 시스템과 연관된 보안 설정입니다. 기본값 true이나 1.19 버전 이후 신고 시스템의 헛점 문제로 false로 전환해 원활한 서버 운영을 권장합니다.
- force-gamemode: 플레이어가 접속할 때 항상 서버 기본 모드로 게임 모드를 강제 적용합니다. false이면 접속 시 저장된 모드를 유지.
- spawn-protection: 스폰 지역 보호 반경 설정(반지름). 값 x2+1이 보호되는 영역 크기입니다. 예를 들어 16이면 33×33 블록 보호.
- resource-pack: 접속 시 자동 다운로드할 리소스팩 URL 입력. HTTP로 직접 접근 가능한 서버에 호스팅되어야 함.
server.properties 설정 예시와 추천 조합
서버 목적에 따른 설정 예시를 정리했습니다. 상황에 맞게 원하는 부분만 참고하여 적용하세요.
| 목적 | 핵심 설정 | 설명 |
|---|---|---|
| 서바이벌 기본 서버 | allow-flight=false gamemode=survival difficulty=normal white-list=false |
정상적인 서바이벌 플레이 환경에 적합합니다. |
| 창작 및 테스트 서버 | allow-flight=true enable-command-block=true gamemode=creative white-list=true |
비행 허용과 명령 블록 활성화로 다양한 실험 가능. |
| 하드코어 모드 | hardcore=true difficulty=hard force-gamemode=true gamemode=survival |
죽으면 관전 모드 전환, 난이도 극한 설정. |
| 아이디별 접속 제한 강화 | white-list=true enforce-whitelist=true online-mode=true |
화이트리스트 강제 적용 및 정품 인증 필수. |
평지맵 및 사용자 지정 월드 생성 설정법
server.properties 파일을 통해 평지맵(Flat World)이나 사용자 지정 월드 설정이 가능합니다. 핵심 옵션은 level-type과 generator-settings입니다.
level-type 기본값은 minecraft:normal이며, 평지맵을 생성하려면 minecraft:flat으로 변경하면 됩니다. 더 세밀한 커스텀을 위해 level-type을 customized로 설정 후 generator-settings에 원하는 월드 프리셋을 JSON 형식으로 입력할 수 있습니다.
예를 들어 완전 평지에 베드락과 흙, 잔디 블록으로만 이루어진 월드를 만들고 싶다면 다음과 같이 작성합니다.
level-type=customized
generator-settings={minecraft:bedrock,2*minecraft:dirt,minecraft:grass_block;minecraft:plains}
단, 커스텀 프리셋은 마인크래프트 버전과 호환성에 따라 다소 차이가 있으므로 공식 문서 또는 최신 커뮤니티 자료를 참고하는 것이 안전합니다.
server.properties 수정 시 꼭 알아야 할 주의사항과 팁
- 서버가 완전히 종료된 상태에서만 파일을 수정하고, 저장 후 반드시 서버를 재시작해야 변경 내용이 적용됩니다.
- 파일 내 특수문자(예: 한글 MOTD)는 유니코드 변환 후 입력해야 정상 출력됩니다.
- 포트 번호(server-port)를 변경하면 접속 시 IP 뒤에 포트번호를 반드시 입력해야 합니다. 예: 123.45.67.89:25570
- online-mode를 false로 설정하면 비정품 유저도 접속 가능하지만, 보안 및 운영상의 문제가 발생할 수 있으므로 주의하세요.
- 리소스팩 URL은 직접 다운로드 가능한 HTTP 서버 주소를 입력해야 하며, 클라우드 저장소 URL은 작동하지 않습니다.
서버 최적화를 위한 주요 옵션과 권장 세팅
서버 퍼포먼스를 위해 조절할 수 있는 옵션들을 소개합니다.
| 옵션명 | 기본값 | 최적화 권장값 | 설명 |
|---|---|---|---|
| view-distance | 10 | 8~12 | 클라이언트에 보여지는 렌더링 거리. 너무 높으면 랙 유발, 너무 낮으면 게임 몰입감 저하. |
| simulation-distance | 10 | 6~10 | 서버가 처리하는 시뮬레이션 범위. 낮출수록 서버 부하 감소. |
| max-tick-time | 60000 | 60000 이상 유지 | 서버 치명적 오류 판단 시간. 너무 낮게 설정 시 불필요한 재시작 발생 가능. |
| entity-broadcast-range-percentage | 100 | 50~100 | 엔티티 동기화 범위. 낮춰서 렉 감소 가능하지만 멀리 있는 엔티티가 안 보일 수 있음. |
server.properties 변경 후 적용 방법 및 문제 해결
- 서버를 완전히 종료합니다.
- 메모장 등 텍스트 편집기로
server.properties파일을 엽니다. - 원하는 설정을 변경합니다.
- 파일을 저장하고 닫습니다.
- 서버를 다시 실행합니다.
만약 설정이 적용되지 않거나 서버가 실행되지 않는다면 아래 사항을 점검하세요.
- 파일 인코딩이 UTF-8인지 확인(특히 한글 포함 시 중요).
- 잘못된 옵션 이름이나 값이 없는지 점검.
- 서버 로그에서 에러 메시지 확인.
마무리 및 최신 정보 확인법
server.properties는 마인크래프트 서버 운영의 중추를 담당하는 설정 파일입니다. 이 가이드를 통해 2026년 10월 현재 가장 중요한 옵션과 활용법을 자세히 안내해드렸습니다. 앞으로도 버킷과 스피곳 등 서버 소프트웨어 업데이트 시 변경 사항을 꼼꼼히 확인하며 최적의 환경을 유지하세요.
최신 정보와 커스텀 월드 프리셋, 문제 해결법 등은 공식 마인크래프트 위키와 서버 운영자 커뮤니티(포럼, 디스코드 등)를 주기적으로 방문하여 확인하는 것을 권장합니다.
작성 · 정리 기준
- 작성 황금게임코드모아 편집팀 · 게임 코드·공략 정보 정리
- 정리 기준 공개된 게임 코드 자료와 공식 게임 채널 정보를 참고해 정리하고 월 단위로 갱신합니다.
- 이용 안내 코드·수치는 업데이트 시점에 따라 달라질 수 있으니 게임 내에서 최종 확인하시기 바랍니다.