server.properties
덤프버전 :
관련 문서: 마인크래프트/자바 에디션/서버  | ||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
1. 개요[편집]
server.properties는 마인크래프트 서버의 특성을 설정할 수 있는 파일이다. UTF-8 인코딩이며, 메모장 등으로 열어 손쉽게 수정이 가능하다. 등호 뒤에 있는 값만 수정할 수 있고, 등호 앞을 수정하면 작동하지 않는다.
#으로 뒤에 있는 텍스트를 인식하지 못하게 주석 처리시킬 수 있으며, 이를 이용해서 기본값을 백업할 수도 있다. 기본값이 문제 해결의 열쇠가 되는 경우가 있기에 특히 초보자라면 #을 이용해서 기본값들을 백업하는 것을 추천한다.
서버가 실행중이어도 변경 할 수 있으며, 서버를 재시작하거나 콘솔에 /reload 명령어를 입력해 변경 사항을 적용할 수 있다.
아래의 내용 중 일부 또는 대부분은 마인크래프트 위키에서 번역돼 수정된 내용이다.
2. Minecraft server properties[편집]
2.1. 자바 에디션[편집]
| Minecraft Java Edtion | ||
| 이름 타입 기본값 | 설명 | |
| 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-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 문자열 (비어있음) | 서버에서 생성할 월드를 마음대로 조정할 수 있다. 완전한 평지와 사용자 지정에서 예제를 볼 수 있다. 이곳에 월드 프리셋을 입력하면 된다. 다만 사용하려면 | |
| hardcore 참과 거짓 false | 만약 true로 설정한다면 true 하드코어 false 일반 | |
| initial-disabled-packs 문자열 (비어있음) | 세계 생성 시 자동으로 활성화되지 않을 데이터팩 목록이다. 쉼표(,)로 구분된다. | |
| initial-enabled-packs 문자열 vanilla | 세계 생성 시 자동으로 활성화할 데이터팩 목록이다. 쉼표(,)로 구분된다. | |
| level-name 문자열 world | 맵 파일 이름 설정 world 대신 다른 이름으로 설정이 가능하다. 특수문자는 지원하지 않는다. | |
| 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틱[2] 1tick의 최소 단위는 1/20초, 즉 0.05초이다. -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유저)의 권한 레벨을 지정한다. 세부 사항은 권한 레벨과 같다. | |
| player-idle-timeout 정수 0 | 일정 시간동안 활동하지 않으면 자동으로 강퇴된다. 분 단위로 조절한다. 0 - 비활성화 | |
| prevent-proxy-connections 참과 거짓 false | 서버에서 보낸 ISP / AS가 Mojang의 인증 서버와 다른 경우 플레이어가 강퇴처리 된다. true - 사용자가 VPN 또는 프록시를 사용하지 못하게 한다. false - 사용자가 VPN 또는 프록시를 사용할 수 있게 한다. | |
| pvp 참과 거짓 true | 플레이어간의 직접적인 공격을 허용하며 서로 죽이는 것에 대한 가능 여부. false로 설정하여도 PVE(Player versus Entity)[3] 플레이어를 제외한 엔티티를 이용한 공격. EX) TNT폭발, 모래/자갈에 깔리는 경우, 낙사, 즉시 데미지 포션, 용암 | |
| query.port 정수(1~65534) 25565 | query 서버의 접속 포트를 설정한다.(enable-query=true로 하여야 볼 수 있다.) | |
| rate-limit 정수 0 | 한 유저가 최대로 보낼수 있는 패킷의 양이다. 이 값을 넘으면 강제 퇴장 당한다. 0으로 설정하면 비활성화 된다. | |
| rcon.password 문자열 (비어있음) | rcon의 패스워드를 설정한다. | |
| rcon.port 정수(1~65534) 25575 | rcon의 접속 포트를 설정한다. | |
| resource-pack 문자열 (비어있음) | (선택 옵션)resource pack의 다운로드URL을 적는다. 유저는 입력한 URL의 리소스 팩을 서버 리소스팩 형태로 다운로드 받아 사용 할 수 있다.[4] 네이버 클라우드 파일공유나 구글 드라이브 파일공유등 페이지로 공유되는 것은 안되며 직접 올릴경우 네이버 블로그에 파일을 올리거나 HTTP서버 기능을 활용하자 이때 다운로드 URL을 확인하는 방법은 크롬 브라우저 기준으로 ctrl+J를 누르고(또는 우측 상단에 맨 오른쪽에 있는 Chorme 맞춤설정 및 제어에서 다운로드 탭을 선택) 그곳에서 리소스팩을 찾은 다음 우클릭을 하여 링크주소 복사하기를 선택하면 된다. | |
| resource-pack-prompt 문자열 (비어있음) | | |
| resource-pack-sha1 문자열 (비어있음) | (선택 옵션) SHA-1함수로 암호화된 리소스팩 데이터를 입력한다.이곳에서 변환[6] 다운로드 받은 리소스팩 파일을 Drop File here에다가 드레그하여 놓고 hash버튼을 누르면 바로 아랫쪽에 sha-1으로 암호화시킨 리소스팩 데이터가 출력된다. 이것을 사용하기 위해선 resource-pack에 다운로드 URL을 입력하여야 하며, SHA-1해시 함수로 암호화된 리소스팩은 소문자 16진수로 이루어진 64자리 코드로 되어있다. 이것을 작성하는 것을 추천하는데 이는 리소스팩의 무결성을 검증하는데 해시 함수로 암호화된 리소스팩 데이터를 사용하기 때문이다. 이칸이 비어있지 않다면 서버가 열릴때 서버리소스팩을 다운로드하여 sha-1으로 암호화 시킨 다음 작성된 데이터와 비교하여 다를 경우 노란색 글씨로 Invalid sha1 for ressource-pack-sha1라는 오류메세지를 띄우고 서버가 열린다.[7] SHA-1의 특성상 비둘기집의 원리에 의하여 아주 아주 낮은 확률로 충돌이 발생한다. 그렇기 때문에 오류 메세지가 떠도 서버는 정상적으로 열리는 것이다. | |
| 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-animals 참과 거짓 true | 친화적 생명체의 소환 여부 | |
| spawn-monsters 참과 거짓 true | 적대적 생명체의 소환 여부 | |
| spawn-npcs 참과 거짓 true | 주민 소환 여부 | |
| spawn-protection 정수 16 | 스폰 보호 지점의 반지름. 만약 서버에 관리자가 한 명도 없다면 자동으로 이 설정은 비활성화 된다. | |
| sync-chunk-writes 참과 거짓 true | 동기로 청크를 작성할지의 여부. false로 설정할 경우, 비동기로 청크를 작성 | |
| text-filtering-config JSON (비어있음) | 아직 완성되지 않은 기능이다. 서버가 플레이어의 채팅을 필터링 하도록 설정할 수 있다. | |
| use-native-transport 참과 거짓 true | 리눅스에서 최적화 된 패킷을 송수신하도록 개선한다. true- 리눅스 패킷 송수신 최적화 활성화 false- 리눅스 패킷 송수신 최적화 비활성화 | |
| view-distance 정수(3~32) 10 | 서버 렌더 거리 수. 클라이언트 렌더 거리 수가 서버가 설정한 값보다 높을 경우 강제로 내려간다.[8] 즉, 만약 이 값이 3이라면, 플레이어가 설정에서 렌더 거리를 32청크로 설정해도 실제로는 3청크만 보이게 된다. | |
| white-list 참과 거짓 false | 화이트 리스트 활성 여부, 화이트리스트에 등록되지 않은 유저는 서버에 접속할 수 없다. 주로 실제 친구들 간의 멀티플레이나 선택된 외부인들과 플레이하기 위하여 사용한다. true 적용 false 적용 하지 않음 참고: 관리자(OP)는 자동으로 화이트 리스트에 등록된다. | |
2.1.1. 제거된 설정[편집]
| announce-player-achievements | 참과 거짓 | true | 플레이어가 도전 과제를 달성 할 때 서버 전체에 알릴지의 여부. gamerule announceAdvancements로 대체가 가능해 제거되었다. |
| level-seed | 문자열 | (비어있음) | 맵의 시드를 설정한다. 비어있는 경우 랜덤으로 설정 된다. |
| max-build-height | 정수 | 256 | 건설이 가능한 최대 높이를 설정한다. |
| previews-chat | 참과 거짓 | false | 채팅 미리보기 사용 여부를 설정한다. |
2.2. 베드락 에디션[편집]
| Minecraft Bedrock Edtion | |||||
| 설정 이름 | 유효값 | 기본값 | 사용시기 | 설명 | 기타 |
| gamemode | 서바이벌(0), 크리에이티브(1), 모험(2) | 서바이벌 | 항상 또는 새 플레이어 접속 | 새로운 플레이어에 대한 게임 모드 설정 | |
| difficulty | 평화로움(peaceful), 쉬움(easy), 보통(normal), 어려움(hard) | 쉬움 | 항상 | 월드의 난이도를 설정한다. | |
| level-type | FLAT, LEGACY, DEFAULT | DEFAULT | 월드 생성시 | 생성할 맵의 타입을 결정한다. | |
| server-name | 아무 문자열 | Dedicated Server | 항상 | 사용할 서버 이름을 지정한다. | 게임 내의 서버 리스트에서 보여지는 이름이다. |
| max-player | 양의 정수 | 10 | 항상 | 최대로 서버에 참여가능한 인원을 결정한다. | 서버가 꽉차는 경우가 많음으로 많은 인원으로 설정하면 수준 높은 연출을 할 수 있다.[9] 외국 서버 이야기이다. |
| server-port | 모든 정수 | 19132 | 항상 | IPv4로 접속하는 포트 | |
| server-portv6 | 모든 정수 | 19133 | 항상 | IPv6로 접속하는 포트, 우리나라는 IPv4를 사용하여 사실상 쓸일이 없는 옵션이지만 외국 같은 경우는 IPv6를 사용하기에 신경써주어야 하는 옵션이다. 그 이유에 대해서는 IP문서 참조 | |
| level-name | 아무 문자열[10] 단 영어만 가능 | 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 | |||
| Key | 성격 | 기본값 | 설명 |
| verify-names | 참과 거짓 | true | 이 옵션을 활성화 한다면 Minecraft.net에 접속한 아이피와 서버에 접속한 아이피가 동일함을 보장해 주지만 같은 아이피로[11] 공인 아이피 기준이므로 같은 공유기를 사용한다면 동시 접속이 불가능하다. |
| admin-slot | 참과 거짓 | false | 서버가 가득찼을 때 오피의 접속 가능여부[12] true로 설정하면 서버가 가득차도 오피가 접속 가능하다. |
| public | 참과 거짓 | | 서버가 서버 목록에 표시될지 안될지 여부를 결정한다. |
| server-name | 문자열 | | 서버가 표시되는 이름을 결정한다. |
| max-players | 정수 ](0~256) | | 접속 가능한 최대 플레이어를 설정한다. |
| max-connections | 정수 (1~3) | | 같은 아이피로 동시 접속 가능한 최대 수를 결정한다.[13] 3이상을 적어도 3으로 설정된다. |
| motd | 문자열 | | 플레이어가 서버에 접속할 때의 메세지를 결정한다. |
| grow-trees | 참과 거짓 | | 나무 묘목이 나무로 성장하는 여부를 결정한다. |
4. 여담[편집]
https://server.properties의 웹사이트가 있다. 모장이 공식적으로 만든 것은 아니며, 현존하는 server.properties의 최신 내용을 바로 받아 수정 할 수도 있다.
예) curl을 이용하여 server.properties 파일 내용 생성:
| curl https://server.properties > server.properties |
이 문서의 내용 중 전체 또는 일부는 문서의 r432 판{{{#!wiki style="display: inline; display: 4.1;"
, 4.1번 문단}}}에서 가져왔습니다. 이전 역사 보러 가기[1] 개발자가 실행 중인 서버의 상태를 모니터링할 수 있다.[2] 1tick의 최소 단위는 1/20초, 즉 0.05초이다.[3] 플레이어를 제외한 엔티티를 이용한 공격. EX) TNT폭발, 모래/자갈에 깔리는 경우, 낙사, 즉시 데미지 포션, 용암[4] 네이버 클라우드 파일공유나 구글 드라이브 파일공유등 페이지로 공유되는 것은 안되며 직접 올릴경우 네이버 블로그에 파일을 올리거나 HTTP서버 기능을 활용하자[5] 이때 다운로드 URL을 확인하는 방법은 크롬 브라우저 기준으로 ctrl+J를 누르고(또는 우측 상단에 맨 오른쪽에 있는 Chorme 맞춤설정 및 제어에서 다운로드 탭을 선택) 그곳에서 리소스팩을 찾은 다음 우클릭을 하여 링크주소 복사하기를 선택하면 된다.[6] 다운로드 받은 리소스팩 파일을 Drop File here에다가 드레그하여 놓고 hash버튼을 누르면 바로 아랫쪽에 sha-1으로 암호화시킨 리소스팩 데이터가 출력된다.[7] SHA-1의 특성상 비둘기집의 원리에 의하여 아주 아주 낮은 확률로 충돌이 발생한다. 그렇기 때문에 오류 메세지가 떠도 서버는 정상적으로 열리는 것이다.[8] 즉, 만약 이 값이 3이라면, 플레이어가 설정에서 렌더 거리를 32청크로 설정해도 실제로는 3청크만 보이게 된다.[9] 외국 서버 이야기이다.[10] 단 영어만 가능[11] 공인 아이피 기준이므로 같은 공유기를 사용한다면 동시 접속이 불가능하다.[12] true로 설정하면 서버가 가득차도 오피가 접속 가능하다.[13] 3이상을 적어도 3으로 설정된다.
이 문서의 내용 중 전체 또는 일부는 2023-11-06 21:20:58에 나무위키 server.properties 문서에서 가져왔습니다.