{{{#!wiki style="margin: -0px -10px -5px; min-height:calc(1.5em + 5px)" {{{#!folding [ 펼치기 · 접기 ] {{{#!wiki style="margin: -5px -1px -11px; word-break:keep-all" | <colbgcolor=darkgreen><colcolor=#fff> 기본 플레이 | |
시스템 | 세계 (시드) · 게임 모드 · 난이도 · 게임 규칙 · 엔딩 · 죽음 메시지 · 스플래시 · 명령어 · NBT · 런처 | |
인게임 | 아이템 · 몹 (플레이어) · 개체 · 날씨 · 차원 · 생물군계 · 구조물 · 마법 부여 · 상태 효과 · 조작법 · 피해 · 업적 | |
도움말 | 튜토리얼 · 팁 (탐험 · 파밍 · 회로) · 재생 가능한 자원 · 브릿징 · PVP · 파쿠르 · 스피드런 · 건축 (맵아트) | |
시리즈 및 매체 | ||
출시 에디션 | 자바 에디션 (업데이트 · 거리 효과) · 베드락 에디션 (업데이트) · 포켓 에디션* · 콘솔 에디션* · 파이 에디션* | |
파생 게임 | 마인크래프트 던전스* · 마인크래프트 레전드* · 마인크래프트 에듀케이션 · 마인크래프트: 스토리 모드* · 마인크래프트 어스* | |
미디어 | OST · 관련 서적 · 레고 · 영화 · 애니메이션 · Minecraft Live · Minecraft Now · Minecraft Monthly | |
유저 콘텐츠 | ||
창작 요소 | 2차 창작 · 망토 · 맵 · 모드 (개발 · 팁 · 모드팩) · 애드온 · 팩 (리소스 팩 · 데이터 팩) · 외부 프로그램 · 핵 | |
멀티 콘텐츠 | 멀티플레이 · 서버 · 플러그인 · Realms · EULA | |
개발 | 개발 기초 · 모드 개발 · 플러그인 개발 | |
기타 | ||
이야깃거리 | 여담 · 커뮤니티 · 사건 사고 · 문제점 · 용어 · 지원 언어 · 머나먼 땅 · 이미테이션 게임 · 히로빈 | |
관련 문서 | 나무위키 마인크래프트 프로젝트 · 마인크래프트로 분류된 문서 · 마인크래프트의 하위 문서 | |
* 표시는 서비스가 종료되었거나 개발이 중단되었다는 표시이다. | }}}}}}}}} |
1. 개요
server.properties는 마인크래프트 서버의 특성을 설정할 수 있는 파일이다. UTF-8 인코딩이며, 메모장 등으로 열어 손쉽게 수정이 가능하다. 등호 뒤에 있는 값만 수정할 수 있고, 등호 앞을 수정하면 작동하지 않는다.#으로 뒤에 있는 텍스트를 인식하지 못하게 주석 처리시킬 수 있으며, 이를 이용해서 기본값을 백업할 수도 있다. 기본값이 문제 해결의 열쇠가 되는 경우가 있기에 특히 초보자라면 #을 이용해서 기본값들을 백업하는 것을 추천한다.
서버가 실행중이어도 변경 할 수 있으며, 서버를 재시작하거나 콘솔에 /reload 명령어를 입력해 변경 사항을 적용할 수 있다.
아래의 내용 중 일부 또는 대부분은 마인크래프트 위키에서 번역돼 수정된 내용이다.
2. Minecraft server properties
2.1. 자바 에디션
Minecraft Java Edition | ||
<rowcolor=white> 이름 타입 기본값 | 설명 | |
accepts-transfers 참과 거짓 false | 전송 패킷이나 transfer 명령어를 통해 서버에 들어올 수 있을지 여부. | |
allow-flight 참과 거짓 false | 크리에이티브 및 관전자 이외의 게임 모드에서 비행 허용 여부. 5초 이상 공중에 떠있을 경우 추방당한다. | |
allow-nether 참과 거짓 true | 네더 이동 가능 여부. false로 설정하면 네더 포탈이 생성돼도 이동 할 수 없다. | |
broadcast-console-to-ops 참과 거짓 true | 콘솔의 명령어 출력을 온라인 상태의 관리자에게로 전송할지의 여부. | |
broadcast-rcon-to-ops 참과 거짓 true | rcon 콘솔의 명령어 출력을 온라인 상태의 관리자에게로 전송할지의 여부. | |
difficulty 문자열 easy | 서버의 기본 난이도. peaceful - 평화로움 easy - 쉬움 normal - 보통 hard - 어려움 | |
enable-command-block 참과 거짓 false | 명령 블록을 사용할 수 있는지 여부. | |
enable-jmx-monitoring 참과 거짓 false | JMX을 통한 모니터링 가능 여부. [1] | |
enable-status 참과 거짓 true | 서버 목록에 온라인이라고 뜰지 여부. false로 설정하면 서버가 꺼진 것으로 표시된다. 단 서버 연결은 막지 않는다. | |
enable-query 참과 거짓 false | GameSpy4 프로토콜 허용 여부. 서버의 정보를 가져올 때 사용한다. | |
enable-rcon 참과 거짓 false | 원격에서 서버 콘솔에 접근하는 것을 허용할지에 대한 여부. | |
enforce-secure-profile 참과 거짓 true | 보안 프로파일 강제 여부. false로 설정하면 Mojang이 서명한 보안 프로파일이 없는 플레이어도 서버에 접속할 수 있다. | |
enforce-whitelist 참과 거짓 false | 이 설정이 활성화 되면 유저가 화이트리스트의 유저를 건드릴 수 없다. 또한 서버에 /reload 명령어를 입력하여 수정된 화이트 리스트를 불러오기 전까지 기존의 화이트리스트에 등록된 유저만 접속할 수 있다. true - 적용 false - 적용 하지 않음 | |
entity-broadcast-range-percentage 정수(0~1000) 100 | 클라이언트에게 엔티티가 렌더링되는 거리. 값이 높을수록 더 먼 곳에서 렌더링되어 더 많은 지연이 발생할 수 있다. | |
sync-chunk-writes 참과 거짓 true | 맵을 쓸 때 동기식으로 쓴다. 충돌시 청크가 손상되는 것을 방지하나 일부 서버에서는 렉을 유발할 수 있다. | |
force-gamemode 참과 거짓 false | 플레이어가 서버에 접속시 지정된 게임모드로 변경할 것인지 여부. | |
function-permission-level 정수(1~4) 2 | 마인크래프트 함수의 권한 레벨을 지정한다. 세부 사항은 권한 레벨와 같다. | |
gamemode 문자열 survival | 게임모드 설정 survival - 서바이벌 모드 creative - 크리에이티브 모드 adventure -모험 모드 spectator - 관전 모드 | |
generate-structures 참과 거짓 true | 구조물 생성 여부. false로 설정해도 근거지와 유사 구조물은 정상적으로 생성된다. | |
generator-settings 문자열 (비어있음) | 서버에서 생성할 세계를 마음대로 조정할 수 있다. 완전한 평지와 사용자 지정에서 예제를 볼 수 있다. 이곳에 세계 프리셋을 입력하면 된다. 다만 사용하려면 level-type 설정을 CUSTMIZED 로 설정하여야 한다. | |
hardcore 참과 거짓 false | 하드코어 모드 여부. 만약 true로 설정한다면 difficulty 설정은 무시되며 난이도는 hard 로 고정된다. 그리고 플레이어가 죽을시 관전(spectator) 모드로 설정된다.true - 하드코어 false - 일반 | |
hide-online-players 참과 거짓 false | 서버 목록에서 플레이어 목록을 숨길지 여부. true로 설정하면 플레이어 목록이 전송되지 않는다. | |
initial-disabled-packs 문자열 (비어있음) | 세계 생성 시 자동으로 활성화되지 않을 데이터팩 목록이다. 쉼표(,)로 구분된다. | |
initial-enabled-packs 문자열 vanilla | 세계 생성 시 자동으로 활성화할 데이터팩 목록이다. 쉼표(,)로 구분된다. 1.21.4 기준 실험적 데이터 팩 모두 활성화 하기: vanilla,trade_rebalance,minecart_improvements,redstone_experiments | |
level-name 문자열 world | 맵 파일 이름 설정 world 대신 다른 이름으로 설정이 가능하다. 특수문자는 지원하지 않는다. | |
level-seed 문자열 (비어있음) | 맵의 시드를 설정한다. 비어있는 경우 랜덤으로 설정 된다. | |
level-type 문자열 default | 월드가 어떤 방식으로 생성될 지 설정한다. default - 기본 월드. 언덕, 계곡, 물 등이 생성된다. flat - 평지. 마을 밖에 없고, 주로 건축용으로 이용된다. largeBiomes - 기본 월드와 같으나 생물 군계의 구역 기본보다 더 커진다. amplified - 기본 월드와 같으나 높이가 더 증가한다. buffet - 뷔페. 1.15 또는 그 이전 버전에만 가능하다. generator-settings를 설정하지 않으면 기본값과 같다. default_1_1 - 1.15 이전 버전에만 사용 가능하다. customized - generator-settings에서 설정한 프리셋을 사용한다. | |
log-ips 참과 거짓 true | 서버에 들어올 때 ip가 기록되는지 여부. false로 설정하면 서버에 접속할 때 로그에 ip가 기록되지 않는다. | |
max-players 정수(0~(231-1)) 20 | 동시에 접속이 가능한 최대 유저 수를 설정한다. | |
max-tick-time 정수(0~(263-1)) 60000 | 서버가 행아웃에 빠졌다고 판단하기 까지의 제한 시간을 밀리초 단위로 설정한다. 서버의 1틱이 설정값을 초과할 경우 모든 서버 작업을 중단하고 크래시로 판단하여 강제로 서버가 종료된다. -1 로 설정할 경우 행아웃 체크를 진행하지 않는다. | |
max-world-size 정수(1~29999984) 29999984 | 세계 경계의 반지름. | |
motd 문자열 A Minecraft Server | 서버의 메시지를 적을 수 있으며 60자 미만으로 설정 가능하다. 또한 글자에 색깔을 입히려면 [[https://minecraft.wiki/w/Formatting_codes | §와 같은 포매팅 코드]]를 사용하여야 한다. |
network-compression-threshold 정수 256 | 마인크래프트가 보내는 패킷의 값이 여기에서 입력한 n보다 적으면 그냥 보내지만 n이상이라면 압축하여 전송한다. n의 값이 작을수록 압축률이 높아지지만, 적은양의 바이트를 압축한다면 결과 값이 기존보다 더 커질 수 있다. -1 패킷을 전혀 압축하지 않는다. 0 모든 패킷을 압축한다. 주의 인터넷 통신 규격상 64Bytes 미만의 패킷도 64bytes로 취급되어 전송 될수 밖에 없다. 따라서 64Bytes 미만으로 설정하는 것은 아무런 이득이 없다. 또한 일반적으로 1500Bytes를 넘지 않는 것을 추천한다. | |
online-mode 참과 거짓 true | 서버가 마인크래프트의 계정 데이터베이스(Minecraft's account database)에 연결 되지 않은 플레이어를 확인 후 연결이 되어 있지 않은 플레이어의 접속을 차단한다. 이때 인터넷에 연결되어 있지 않다면 참, 거짓에 여부에 상관없이 모두 접속이 가능하다. | |
op-permission-level 정수(1~4) 4 | 관리자 승인을 받은 유저(op유저)의 권한 레벨을 지정한다. 세부 사항은 권한 레벨과 같다. | |
pause-when-empty-seconds 정수 60 | 접속 중인 플레이어가 없다면 서버를 일시 중지한다.(tick freeze와 같음) 초 단위로 조절한다. 0으로 설정하면 접속 중인 플레이어가 없어도 서버는 계속 돌아간다. | |
player-idle-timeout 정수 0 | 일정 시간동안 활동하지 않으면 자동으로 강퇴된다. 분 단위로 조절한다. 0 - 비활성화 | |
prevent-proxy-connections 참과 거짓 false | 서버에서 보낸 ISP / AS가 Mojang의 인증 서버와 다른 경우 플레이어가 강퇴처리 된다. true - 사용자가 VPN 또는 프록시를 사용하지 못하게 한다. false - 사용자가 VPN 또는 프록시를 사용할 수 있게 한다. | |
pvp 참과 거짓 true | 플레이어간의 직접적인 공격을 허용하며 서로 죽이는 것에 대한 가능 여부. false로 설정하여도 PVE(Player versus Entity)[2]는 가능하다. | |
query.port 정수(1~65534) 25565 | query 서버의 접속 포트를 설정한다.(enable-query=true로 하여야 볼 수 있다.) | |
rate-limit 정수 0 | 한 유저가 최대로 보낼수 있는 패킷의 양이다. 이 값을 넘으면 강제 퇴장 당한다. 0 - 비활성화. | |
rcon.password 문자열 (비어있음) | rcon의 패스워드를 설정한다. | |
rcon.port 정수(1~65534) 25575 | rcon의 접속 포트를 설정한다. | |
region-file-compression 문자열 deflate | region 파일(=청크 데이터)의 압축 알고리즘을 정한다. deflate - 기본값. Deflate 알고리즘을 사용한다. lz4 - LZ4 알고리즘을 사용한다. Deflate 대비 압축 및 압축 해제 시 CPU 부하가 적지만, 더 많은 디스크 공간을 사용한다. none - 압축하지 않는다. CPU 부하는 lz4보다 더 적지만, 엄청난 디스크 공간을 사용한다. | |
resource-pack 문자열 (비어있음) | (선택 옵션) 리소스 팩의 다운로드 URL을 적는다. 유저는 입력한 URL의 리소스 팩을 서버 리소스팩 형태로 다운로드 받아 사용 할 수 있다. | |
resource-pack-id UUID (비어있음) | (선택 옵션) 리소스 팩의 UUID. 적을 경우 이 리소스팩은 클라이언트에 저장된다. 예: 01234567-89ab-4def-0123-456789abcdef | |
resource-pack-prompt 문자열 (비어있음) | (선택 옵션) 리소스팩을 적용시킬때 사용자 지정 메시지. | |
resource-pack-sha1 문자열 (비어있음) | (선택 옵션) SHA-1로 암호화된 리소스팩 데이터를 입력한다.(여기에서 변환[3]) 이것을 사용하기 위해선 위의 "resource-pack" 칸에 다운로드 URL을 입력하여야 하며, SHA-1 해시 함수로 암호화된 리소스팩은 소문자 16진수로 이루어진 64자리 코드로 되어있다. "resource-pack-sha1" 칸을 작성하는 것을 추천하는데, 그 이유는 리소스팩의 무결성을 검증하는 데에 해시 함수로 암호화된 리소스팩 데이터를 사용하기 때문이다. 이 칸이 비어 있지 않다면 서버가 열릴 때 서버 리소스팩을 다운로드하여 SHA-1으로 암호화한 다음 작성된 데이터와 비교하여 다를 경우 노란색 글씨로 Invalid sha1 for ressource-pack-sha1라는 오류메세지를 띄우고 서버가 열린다. | |
require-resource-pack 참과 거짓 false | 이 옵션을 true로 설정하면, 플레이어가 리소스 팩 다운로드를 거부하면 강제 퇴장한다. | |
server-ip 문자열 (비어있음) | 이곳에 ip를 적으면 서버가 자신이 원하는 특정한 ip로 고정되어 열린다. 비워 둔다면 자동으로 검색하여 ip를 할당 받는다. | |
server-port 정수(1~65534) 25565 | 서버의 접속 포트를 설정한다. 기본 포트 외에 다른 포트로 변경을 하였다면 서버에 접속할 때 (공인or사설 ip):(설정한 포트)로 접속을 하여야 한다. | |
simulation-distance 정수(3~32) 10 | 시뮬레이션 거리를 조정한다. | |
snooper-enabled 참과 거짓 true | 서버가 지속적으로 감시데이터를 http://snoop.minecraft.net로 보낼지 여부를 결정한다. | |
spawn-monsters 참과 거짓 true | 적대적 생명체의 생성 여부. | |
spawn-protection 정수 16 | 스폰 보호 지점의 정사각형. 지점의 크기는 2n+1로 결정한다. 1은 3x3, 2는 5x5로 이런식이다. 만약 서버에 관리자가 한 명도 없다면 이 설정은 비활성화 된다. 0 - 비활성화 | |
sync-chunk-writes 참과 거짓 true | 동기로 청크를 작성할지의 여부. false로 설정할 경우, 비동기로 청크를 작성 | |
text-filtering-config 알 수 없음 (비어있음) | 알 수 없음 | |
use-native-transport 참과 거짓 true | 리눅스에서 최적화 된 패킷을 송수신하도록 개선한다. true- 리눅스 패킷 송수신 최적화 활성화 false- 리눅스 패킷 송수신 최적화 비활성화 | |
view-distance 정수(3~32) 10 | 서버 렌더 거리 수. 클라이언트 렌더 거리 수가 서버가 설정한 값보다 높을 경우 강제로 내려간다.[4] 값이 높을수록 더 먼 곳에서 렌더링되어 더 많은 지연이 발생할 수 있다. | |
white-list 참과 거짓 false | 화이트 리스트 활성 여부, 화이트리스트에 등록되지 않은 유저는 서버에 접속할 수 없다. 주로 실제 친구들 간의 멀티플레이나 선택된 외부인들과 플레이하기 위하여 사용한다. true 적용 false 적용 하지 않음 참고: 관리자(OP)는 자동으로 화이트리스트에 등록된다. |
2.1.1. 제거된 설정
announce-player-achievements 참과 거짓 true | 플레이어가 도전 과제를 달성 할 때 서버 전체에 알릴지의 여부. 1.11.2 이후 gamerule announceAdvancements로 대체가 가능해 제거되었다. |
max-build-height 정수 256 | 건설이 가능한 최대 높이를 설정한다. 1.17 이후 높이 제한이 자유롭게 풀면서 삭제되었다. |
previews-chat 참과 거짓 false | 채팅 미리보기 사용 여부를 설정한다. 보안상 이유로 제거되었다. |
spawn-animals 참과 거짓 true | 친화적 생명체의 존재 여부. 1.21.2 이후 대체 가능한 설정이 있어 제거되었다. |
spawn-npcs 참과 거짓 true | 주민 존재 여부. 1.21.2 이후 대체 가능한 설정이 있어 제거되었다. |
2.2. 베드락 에디션
Minecraft Bedrock Edition | |||||
<rowcolor=white> 설정 이름 | 유효값 | 기본값 | 사용시기 | 설명 | 기타 |
gamemode | 서바이벌(0), 크리에이티브(1), 모험(2) | 서바이벌 | 항상 또는 새 플레이어 접속 | 새로운 플레이어에 대한 게임 모드 설정 | |
difficulty | 평화로움(peaceful), 쉬움(easy), 보통(normal), 어려움(hard) | 쉬움 | 항상 | 월드의 난이도를 설정한다. | |
level-type | FLAT, LEGACY, DEFAULT | DEFAULT | 월드 생성시 | 생성할 맵의 타입을 결정한다. | |
server-name | 아무 문자열 | Dedicated Server | 항상 | 사용할 서버 이름을 지정한다. | 게임 내의 서버 리스트에서 보여지는 이름이다. |
max-player | 양의 정수 | 10 | 항상 | 최대로 서버에 참여가능한 인원을 결정한다. | 서버가 꽉차는 경우가 많음으로 많은 인원으로 설정하면 수준 높은 연출을 할 수 있다.[5] |
server-port | 모든 정수 | 19132 | 항상 | IPv4로 접속하는 포트 | |
server-portv6 | 모든 정수 | 19133 | 항상 | IPv6로 접속하는 포트, 우리나라는 IPv4를 사용하여 사실상 쓸일이 없는 옵션이지만 외국 같은 경우는 IPv6를 사용하기에 신경써주어야 하는 옵션이다. 그 이유에 대해서는 IP문서 참조 | |
level-name | 아무 문자열[6] | level | 항상 | 이것은 월드의 이름과 월드의 폴더 이름으로 쓰인다. 싱글 플레이맵을 카피해서 적용하는 것도 가능하다. | 생성된 맵은 /worlds위치에 저장된다. |
level-seed | 아무 문자열 | 비어있음(th34f1ju34facjn5f871df312h) | 월드 생성시 | 랜덤한 시드를 부여받는다. | 시드를 지정하면 랜덤한 월드중 하나를 선택하는 것이 가능하며, 만약 비어있다면 랜덤한 시드를 부여받는다. |
online-mode | true, false | true | 항상 | Xbox live의 인증을 받은 플레이어들과 함께할 수 있다. | true로 설정하면 정품만, false로 설정하면 복돌도 가능하다. |
white-list | true, false | false | 항상 | 화이트 리스트의 활성 여부 | |
allow-cheats | true, false | false | 항상 | 채팅으로 커맨드를 사용 가능 여부 | |
view-distance | 모든 정수 | 10 | 항상 | 플레이어 개인에게 허락된 최대 청크 로딩 갯수 | 높은 값으로 설정하면 연출을 하기에 유리하다. |
player-idle-timeout | 모든 정수 | 30 | 항상 | 단위는 분이며 지정 값보다 오랫동안 아무 활동도 하지 않으면 강퇴된다. | |
max-thread | 모든 정수 | 8 | 항상 | 최대 사용가능한 쓰레드의 갯수를 설정한다. 만약 이 값을 지우거나 0으로 설정한다면 자동으로 자신의 최대 쓰레드 갯수 만큼 지정한다. | |
tick-distance | 4~12범위의 정수 | 4 | 항상 | 틱당 유저가 로딩하는 청크의 수를 결정한다. | 한 틱 당 유저는 지정한 값 만큼 청크를 불러오며 높은 값은 효과적인 연출을 보여주기 유리하다. |
default-player-permission-level | visitor, member, operator | member | 항상 | 처음 접속하는 플레이어의 펄미션 레벨을 지정한다. | |
texturepack-required | true, false | false | 항상 | 클라이언트에서 서버의 텍스쳐팩을 강제로 적용받도록 한다. | 만약 아무 텍스쳐팩이 없어도 서버에 들어가면 텍스쳐팩을 강제 적용받게 된다. |
3. Minecraft Classic server properties
Minecraft Classic | |||
<rowcolor=white> Key | 성격 | 기본값 | 설명 |
verify-names | 참과 거짓 | true | 이 옵션을 활성화 한다면 Minecraft.net에 접속한 아이피와 서버에 접속한 아이피가 동일함을 보장해 주지만 같은 아이피로[7] 서버에 접속 할때 문제를 일으킨다. 서버를 여는 컴퓨터와 접속하는 컴퓨터가 같지 않는 이상 사용하지 않는 것을 추천한다. |
admin-slot | 참과 거짓 | false | 서버가 가득찼을 때 오피의 접속 가능여부[8] |
public | 참과 거짓 | 서버가 서버 목록에 표시될지 안될지 여부를 결정한다. | |
server-name | 문자열 | 서버가 표시되는 이름을 결정한다. | |
max-players | 정수 ](0~256) | 접속 가능한 최대 플레이어를 설정한다. | |
max-connections | 정수 (1~3) | 같은 아이피로 동시 접속 가능한 최대 수를 결정한다.[9] | |
motd | 문자열 | 플레이어가 서버에 접속할 때의 메세지를 결정한다. | |
grow-trees | 참과 거짓 | 나무 묘목이 나무로 성장하는 여부를 결정한다. |
4. 여담
https://server.properties의 웹사이트가 있다. 모장이 공식적으로 만든 것은 아니며, 현존하는 server.properties의 최신 내용을 바로 받아 수정 할 수도 있다.예) curl을 이용하여 server.properties 파일 내용 생성:
curl https://server.properties > server.properties |
[1] 개발자가 실행 중인 서버의 상태를 모니터링할 수 있다.[2] 플레이어를 제외한 개체를 이용한 공격. EX) TNT폭발, 모래/자갈에 깔리는 경우, 낙사, 즉시 데미지 포션, 용암[3] 다운로드 받은 리소스팩 파일을 Input에다가 드레그하여 놓고 Hash 버튼을 누르면 바로 아래쪽에 SHA-1으로 암호화된 리소스팩 파일이 나온다.[4] 즉, 만약 이 값이 3이라면, 플레이어가 설정에서 렌더 거리를 32청크로 설정해도 실제로는 3청크만 보이게 된다.[5] 외국 서버 이야기이다.[6] 단 영어만 가능[7] 공인 아이피 기준이므로 같은 공유기를 사용한다면 동시 접속이 불가능하다.[8] true로 설정하면 서버가 가득차도 오피가 접속 가능하다.[9] 3이상을 적어도 3으로 설정된다.