server.properties

1. 개요2. Minecraft server properties

2.1. 자바 에디션2.2. 베드락 에디션

3. Minecaraft Classic server properties

1. 개요[편집]

properties는 한글로 속성이란 뜻으로 서버의 특성을 결정하는 여러가지 설정들을 여기서 편집할 수 있다. UTF-8인코딩이며 메모장등으로 열어 손쉽게 수정 가능하다.
수정 할 수 있는 것은 등호 뒤에 있는 값이며 등호 앞을 수정해선 안된다.
또한 #을 입력 하면 그 뒤에는 무효 처리 되는데 이를 이용해서 기본값을 백업하는 용도로 쓸 수 있다. 기본값이 문제 해결의 열쇠가 되는 경우가 있기에 특히 초보자라면 #을 이용해서 기본값들을 백업하는 것을 추천한다. 서버가 실행중이어도 변경 할 수 있으며, 변경 사항은 서버를 재시작하거나 콘솔에 /reload 명령어를 입력하여야 적용된다. 아래 내용은 영문 위키를 번역한 것으로 원문은 링크 [1]

server properties는 최신 버전을 기준으로 서술한다.

2. Minecraft server properties[편집]

2.1. 자바 에디션[편집]

Minecraft Java Edtion
이름	성격	기본값	설명
allow-flight	참과 거짓	false	비행 허용 여부(크리에이티브 제외) 모드중 이 설정을 true로 해야하는 경우도 있다.[2][3] false - 비행이 허용되지 않음. (5초동안 떠있다면 강퇴) true- 비행이 허용되며 모드에 비행 기능이 내장된 경우 사용합니다.
allow-nether	참과 거짓	true	네더 포탈로 이동 가능여부[4] false - 네더로 이동이 불가능하다. true - 네더로 이동이 가능하다.
broadcast-console-to-ops	참과 거짓	true	콘솔의 명령어 출력을 모든 온라인 상태의 관리자에게로 전송합니다.
broadcast-rcon-to-ops	참과 거짓	true	rcon 콘솔의 명령어 출력을 모든 온라인 상태의 관리자에게로 전송합니다.
announce-player-achievements	참과 거짓	true	플레이어가 도전 과제를 달성 할 때 서버 전체에 알릴지 설정합니다. true - 도전 과제 달성시 서버 전체에 알립니다. false - 도전 과제를 달성하여도 서버 전체에 알리지 않습니다.
difficulty	문자열[구버전]	easy	서버의 난이도를 정합니다. peaceful(0)평화로움 easy(1)쉬움 normal(2)보통 hard(3)어려움
enable-command-block	참과 거짓	false	명령 블록을 사용할 수 있는지 여부
enable-jmx-monitoring	참과 거짓	false
enable-query	참과 거짓	false	GameSpy4 프로토콜을 허용합니다. 서버의 정보를 가져올 때 사용합니다.
enable-rcon	참과 거짓	false	원격에서 서버 콘솔에 접근하는 것을 허용합니다.
entity-broadcast-range-percentage	정수 (0~500)	100	엔터티를 클라이언트에 보내기 전에 얼마나 가까이 있어야하는지 제어한다. 값이 높을수록 더 먼 곳에서 렌더링되어 더 많은 지연이 발생할 수 있다.
sync-chunk-writes	참과 거짓	true	synchronous chunk writes를 활성화 합니다.
force-gamemode	참과 거짓	false	플레이어가 서버에 접속시 지정된 게임모드로 변경할 것인지 설정합니다. true - 플레이어가 접속할시 gamemode에서 지정한 모드로 교체할지 여부 false - 플레이어가 서버에서 퇴장하기 전의 게임모드가 그대로 유지됩니다.
function-permission-level	정수 (1~4)	2	마인크래프트 함수의[6] 펄미션 레벨을 지정한다. 세부 사항은 op-permission-level과 같다.
gamemode	문자열[7]	survival	게임모드 설정 survival(0)서바이벌 모드 creative(1)크리에이티브 모드 adventure(2)모험 모드 spectator(3)관전 모드
generate-structures	참과 거짓	true	구조물 생성 여부 true생성 false생성하지 않음 false로 설정해도 유적은 정상적으로 생성된다.
generator-settings	문자열	(비어있음)	서버에서 생성할 월드를 마음대로 조정할 수 있습니다. 완전한 평지 와 사용자 지정 에서 예제를 볼 수 있다. 이곳에 월드 프리셋을 입력하면 된다. 다만 사용하려면 밑에 설정을 level-type=CUSTMIZED로 설정하여야 한다.
hardcore	참과 거짓	false	만약 true로 설정한다면 server-difficulty설정은 무시되며 난이도는 hard로 고정된다. 그리고 플레이어가 죽을시 관전자(spector)모드로 고정된다. 관전자 모드 고정은 관리자가 치트를 씀으로써 풀려날 수 있다. true 하드코어 false 일반
level-name	문자열	world	맵 파일 이름 설정 world대신 다른 이름으로 설정이 가능하며 한글은 미지원
level-seed	문자열	(비어있음)	맵의 시드를 설정한다. 비어있는 경우 랜덤으로 설정 된다.
level-type	문자열	default	월드가 어떤 방식으로 생성될 지 설정합니다. DEFAULT - 기본 월드. 언덕, 계곡, 물 등이 생성됩니다. FLAT - 평지 세계. 아무것도 없고, 건축을 위한 것입니다 LARGEBIOMES - 기본 월드와 같으나 모든 생물 군계의 구역이 기본 생물 군계보다 커집니다. AMPLIFIED - 기본 월드와 같으나 높이가 더 증가합니다. CUSTOMIZED - generator-settings에서 설정한 프리셋을 사용합니다.
max-build-height^{(1.17 제거 예정)}	정수	256	건설할 수 있는 최대 높이를 설정한다.
max-players	정수 (0~2147483647)	20	동시에 접속이 가능한 최대 유저 수를 설정합니다. 램이 유저 수를 못버틴다면 서버 파일이 손상될 수 있습니다.
max-tick-time	정수 {0~(2^63 - 1) }	60000	하루의 시간(tick)을 설정한다. 1tick=1/20초
max-world-size	정수 (1~29999984)	29999984	월드에서 블럭을 놓을 수 있는 최대 크기를 결정한다. 이것은 반지름의 값이며 설정된 반지름의 값 만큼 월드에 경계가 생긴다. 만약 기본값 보다 크게 값을 바꾸어도 확장된 공간에 추가로 무언가가 더 나타나지는 않는다.[8]
motd	문자열	A Minecraft Server	서버의 메시지를 적을 수 있으며 60자 미만으로 설정[9] 가능하다.[10] 또한 글자에 색깔을 입히려면 포매팅 코드를[11] 사용하여야 하며, 한글을 포함해서 영어가 아닌 특별한 문자는[12] 유니코드 문자열로 풀어써야 된다.여기에서 변환이 가능하다.포매팅 코드 영문 게임피디아 위키
network-compression-threshold	정수	256	마인크래프트가 보내는 패킷의 값이 여기에서 입력한 n보다 적으면 그냥 보내지만 n이상이라면 압축하여 전송한다. n의 값이 작을수록 압축률이 높아지지만, 적은양의 바이트를 압축한다면 결과 값이 기존보다 더 커질 수 있습니다. -1 패킷을 전혀 압축하지 않는다. 0 모든 패킷을 압축한다. 주의 인터넷 통신 규격상 64Bytes 미만의 패킷도 64bytes로 취급되어 전송 될수 밖에 없다. 따라서 64Bytes 미만으로 설정하는 것은 아무런 이득이 없다. 또한 일반적으로 1500Bytes를 넘지 않는 것을 추천한다.
online-mode	참과 거짓	true	서버가 마인크래프트의 계정 데이터베이스(Minecraft's account database)에 연결 되지 않은 플레이어를 확인 후 연결이 되어 있지 않은 플레이어의 접속을 차단한다. 이때 인터넷에 연결되어 있지 않다면 참, 거짓에 여부에 상관없이 모두 접속이 가능하다.[13]
op-permission-level	정수 (1~4)	4	관리자 승인을 받은 유저(op유저)의 펄미션 레벨을 지정한다. 1 - 스폰 지점의 보호를 무시 할 수 있다. 이 레벨에서는 사용 가능한 명령어가 없다.[14] 2 - /clear, /difficulty, /effect, /gamemode, /gamerule, /give, /summon, /setblock, /tp 등 싱글 플레이의 모든 치트를 사용가능하고, 커맨드 블럭을 수정 할 수 있다. 3 - /ban, /deop, /kick, /op, /debug등 서버 운영과 관리에 필요한 전반적인 명령어를 사용 가능 4 모든 명령어 사용 가능, /stop, /save-all, /save-on, /save-off등[15]
player-idle-timeout	정수	0	일정 시간동안 활동하지 않으면 자동으로 강퇴된다. 분 단위로 조절한다. 비활성화는 0이다.
prevent-proxy-connections	참과 거짓	false	서버에서 보낸 ISP / AS가 Mojang의 인증 서버와 다른 경우 플레이어가 강퇴처리 됩니다. True - 사용자가 VPN 또는 프록시를 사용하지 못하게 한다. false - 사용자가 VPN 또는 프록시를 사용할 수 있게 한다.
pvp	참과 거짓	true	플레이어간의 직접적인 공격을 허용하며 서로 죽이는 것에 대한 가능 여부. false로 설정하여도 PVE(Player versus Entity)[16]는 가능하다.
query.port	정수 (1~65534)	25565	query 서버의 접속 포트를 설정한다.(enable-query=true로 하여야 볼 수 있다.)
rate-limit	정수	0	Sets the maximum amount of packets a user can send before getting kicked. 0으로 설정하면 비활성화 된다.
rcon.password	문자열	(비어있음)	rcon의 패스워드를 설정한다.
rcon.port	정수 (1~65534)	25575	rcon의 접속 포트를 설정한다.
resource-pack	문자열	(비어있음)	(선택 옵션)resource pack의 다운로드URL을 적는다. 유저는 입력한 URL의 리소스 팩을 서버 리소스팩 형태로 다운로드 받아 사용 할 수 있다.[17][18]
resource-pack-sha1[19]	문자열	(비어있음)	(선택 옵션) SHA-1함수로 암호화된 리소스팩 데이터를 입력한다.이곳에서 변환 [20] 이것을 사용하기 위해선 resource-pack에 다운로드 URL을 입력하여야 하며, SHA-1해시 함수로 암호화된 리소스팩은 소문자 16진수로 이루어진 64자리 코드로 되어있다. 이것을 작성하는 것을 추천하는데 이는 리소스팩의 무결성을 검증하는데 해시 함수로 암호화된 리소스팩 데이터를 사용하기 때문이다. 이칸이 비어있지 않다면 서버가 열릴때 서버리소스팩을 다운로드하여 sha-1으로 암호화 시킨 다음 작성된 데이터와 비교하여 다를 경우 노란색 글씨로 Invalid sha1 for ressource-pack-sha1라는 오류메세지를 띄우고 서버가 열린다.[21]
server-ip	문자열	(비어있음)	이곳에 아이피를 적으면 서버가 자신이 원하는 특정한 아이피로 고정되어 열린다. 비워 둔다면 자동으로 검색하여 아이피를 할당 받는다. 비워두는 것을 강력하게 추천한다.[22][23]
server-port	정수 (1~65534)	25565	서버의 접속 포트를 설정한다. 기본 포트 외에 다른 포트로 변경을 하였다면 서버에 접속할 때 (공인or사설 아이피):(설정한 포트)로 접속을 하여야 한다.
snooper-enabled	참과 거짓	true	서버가 지속적으로 감시데이터를 http://snoop.minecraft.net로 보낼지 여부를 결정합니다.
spawn-animals	참과 거짓	true	친화적 생명체의 소환 여부
spawn-monsters	참과 거짓	true	적대적 생명체의 소환 여부
spawn-npcs	참과 거짓	true	주민 소환 여부
spawn-protection	정수	16	스폰 보호 지점의 반지름[24]단 이 설정은 아무 플러그인이 없을 때 설정해야 합니다. 만약 서버에 오피가 한 명도 없다면 자동으로 이 설정은 비활성화 된다. 웬만하면 이 설정을 0으로 설정하는 것을 권장합니다[25]
use-native-transport	참과 거짓	true	리눅스에서 최적화 된 패킷을 송수신하도록 개선합니다. true- 리눅스 패킷 송수신 최적화 활성화 false- 리눅스 패킷 송수신 최적화 비활성화
view-distance	정수 (3~15)	10	유저가 랜더링하는 청크의 수
white-list	참과 거짓	false	화이트 리스트 활성 여부, 화이트리스트에 등록되지 않은 유저는 서버에 접속할 수 없습니다. 주로 실제 친구들 간의 멀티플레이나 선택된 외부인들과 플레이하기 위하여 사용합니다. true 적용 false 적용 하지 않음 참고: 오피는 자동적으로 화이트 리스트에 등록됩니다.
enforce-whitelist	참과 거짓	false	이 설정이 활성화 되면 유저가 화이트리스트에 유저를 건드릴 수 없습니다. 또한 서버에 /reload명령어를 입력하여 수정된 화이트 리스트를 불러오기 전까지 기존의 화이트리스트에 등록된 유저만 접속할 수 있습니다. true 적용 false 적용 하지 않음

2.2. 베드락 에디션[편집]

Minecraft Bedrock Edtion
설정 이름	유효값	기본값	사용시기	설명	기타
gamemode	서바이벌(0), 크리에디티브(1), 모험(2)	서바이벌	항상 또는 새 플레이어 접속	새로운 플레이어에 대한 게임 모드 설정
difficulty	평화로움(0), 쉬움(1), 보통(2), 어려움(3)	쉬움	항상	월드의 난이도를 설정한다.
level-type	FLAT, LEGACY, DEFAULT	DEFAULT	월드 생성시	생성할 맵의 타입을 결정한다.
server-name	아무 문자열	Dedicated Server	항상	사용할 서버 이름을 지정한다.	게임 내의 서버 리스트에서 보여지는 이름이다.
max-player	양의 정수	10	항상	최대로 서버에 참여가능한 인원을 결정한다.	서버가 꽉차는 경우가 많음으로 많은 인원으로 설정하면 수준 높은 연출을 할 수 있다.[26]
server-port	모든 정수	19132	항상	IPv4로 접속하는 포트
server-portv6	모든 정수	19133	항상	IPv6로 접속하는 포트, 우리나라는 IPv4를 사용하여 사실상 쓸일이 없는 옵션이지만 외국 같은 경우는 IPv6를 사용하기에 신경써주어야 하는 옵션이다. 그 이유에 대해서는 IP문서 참조
level-name	아무 문자열[27]	level	항상	이것은 월드의 이름과 월드의 폴더 이름으로 쓰인다. 싱글 플레이맵을 카피해서 적용하는 것도 가능하다.	생성된 맵은 /worlds위치에 저장된다.
levle-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. Minecaraft Classic server properties[편집]

Minecraft Classic
Key	성격	기본값	설명
verify-names	참과 거짓	true	이 옵션을 활성화 한다면 Minecraft.net에 접속한 아이피와 서버에 접속한 아이피가 동일함을 보장해 주지만 같은 아이피로[28] 서버에 접속 할때 문제를 일으킵니다. 서버를 여는 컴퓨터와 접속하는 컴퓨터가 같지 않는 이상 사용하지 않는 것을 추천합니다.
admin-slot	참과 거짓	false	서버가 가득찼을 때 오피의 접속 가능여부[29]
public	참과 거짓		서버가 서버 목록에 표시될지 안될지 여부를 결정합니다.
server-name	문자열		서버가 표시되는 이름을 결정합니다.
max-players	정수 ](0~256)		접속 가능한 최대 플레이어를 설정합니다.
max-connections	정수 (1~3)		같은 아이피로 동시 접속 가능한 최대 수를 결정합니다.[30]
motd	문자열		플레이어가 서버에 접속할 때의 메세지를 결정합니다.
grow-trees	참과 거짓		나무 묘목이 나무로 성장하는 여부를 결정합니다.

[1] 한글 버전 위키는 모두 변역이 되어있지 않을 뿐만이 아니라 1.8.1버전때 문서를 만들었는지 원문과 내용이 다른 부분이 존재한다. 영문 위키에서는 보다 많은 정보와 최신 정보를 접할 수 있으니 영어실력이 된다면 영문 위키를 읽는 것을 추천한다.

[2] 아스매지카는 버프의 형식으로 이를 회피하였고 인더스트리얼크래프트 2의 제트팩은 비행이긴 하지만 5초 타이머를 계속 0으로 되돌리는 식으로 코딩되어 있기 때문에 문제없다. 사움크래프트도 중력의 영향을 안받겠금 한 것이기 때문에 문제없다. 모드들이 이 설정을 회피하도록 코딩을 하는 것이 보통이다.

[3] 다만 커맨드를 이용하여 공중부양하는 보트를 만들었다면 보트 바로 밑에 블럭이 없어지는 즉시 비행으로 간주되며 5초후에 강퇴된다.

[4] 만약 false로 설정을 한다면 포탈을 만들 순 있어도 포탈이 네더로 데려다 주지는 않는다.

[구버전] 구버전 에서는 정수(0~3)

[6] 마인크래프트 1.12버전 부터 함수기능을 추가하였다. 영문위키

[7] 구버전 구버전에서는 정수(0~3)

[8] 만약 1000이라고 설정했다면 월드의 크기는 2000*2000이 된다.

[9] 59자를 초과해 버리면 에러가 발생한다고 한다.

[10] 한글을 적을려면 유니코드 문자열로 풀어써야 한다.

[11] §5같은 것을 사용하여야 하며 여기에 쓸때는 §를 u00A7로 써야된다. 다만 아래 유니코드 변환 링크에서 색깔까지 편하게 설정하고 미리보기가 가능하기에 링크의 사이트를 추천한다.

[12] 다만 키보드에 있는 특수문자는 예외

[13] false로 설정하면 정품유저나 복돌유저 상관없이 스킨이 스티브나 알렉스로 보이게 된다.

[14] 여기는 능력이 없는 거나 다름없다.

[15] /stop명령어는 서버를 강제 종료 시키는 메우 위험한 명령어로 이외에도 많은 위험한 명령어가 있으니 서버를 운영한다면 3레벨 이하를 추천한다.

[16] 플레이어를 제외한 엔티티를 이용한 공격. EX) TNT폭발, 모래/자갈에 깔리는 경우, 낙사, 즉시 데미지 포션, 용암

[17] 네이버 클라우드 파일공유나 구글 드라이브 파일공유등 페이지로 공유되는 것은 안되며 직접 올릴경우 네이버 블로그에 파일을 올리거나 HTTP서버 기능을 활용하자

[18] 이때 다운로드 URL을 확인하는 방법은 크롬 브라우저 기준으로 ctrl+J를 누르고(또는 우측 상단에 맨 오른쪽에 있는 Chorme 맞춤설정 및 제어에서 다운로드 탭을 선택) 그곳에서 리소스팩을 찾은 다음 우클릭을 하여 링크주소 복사하기를 선택하면 된다.

[19] 구버전은 resource-pack-hash

[20] 다운로드 받은 리소스팩 파일을 Drop File here에다가 드레그하여 놓고 hash버튼을 누르면 바로 아랫쪽에 sha-1으로 암호화시킨 리소스팩 데이터가 출력된다.

[21] SHA-1의 특성상 비둘기집의 원리에 의하여 아주 아주 낮은 확률로 충돌이 발생한다. 그렇기 때문에 오류 메세지가 떠도 서버는 정상적으로 열리는 것이다.

[22] 우리는 유동ip를 사용함으로 ip가 봐뀔경우 다시 ip를 설정해 주어야 하며 이외에도 많은 수고가 뒤따르기 때문이다.

[23] 하마치일 경우 입력하여야 한다.

[24] 1로 설정한다면 3x3, 2로 설정한다면 5x5이다.

[25] 이 설정은 월드가드 플러그인으로 대체할 수 있으며, 서버에서 오피가 아닌 경우 블록 설치, 삭제 등이 안되기에 영역을 줄이거나 없애야 한다.

[26] 외국 서버 이야기이다.

[27] 단 영어만 가능

[28] 공인 아이피 기준이므로 같은 공유기를 사용한다면 동시 접속이 불가능하다.

[29] true로 설정하면 서버가 가득차도 오피가 접속 가능하다.

[30] 3이상을 적어도 3으로 설정된다.