최근 수정 시각 : 2024-12-30 05:55:27

server.properties

파일:관련 문서 아이콘.svg   관련 문서: 마인크래프트/자바 에디션/서버
, 마인크래프트/베드락 에디션/서버
,
,
,
,


{{{#!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. 개요2. Minecraft server properties
2.1. 자바 에디션
2.1.1. 제거된 설정
2.2. 베드락 에디션
3. Minecraft Classic server properties4. 여담

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의 최신 내용을 바로 받아 수정 할 수도 있다. 이름이 properties인 최상위 도메인이 존재할줄은 몰랐는데

예) curl을 이용하여 server.properties 파일 내용 생성:
curl https://server.properties > server.properties



파일:CC-white.svg 이 문서의 내용 중 전체 또는 일부는 문서의 r432에서 가져왔습니다. 이전 역사 보러 가기
파일:CC-white.svg 이 문서의 내용 중 전체 또는 일부는 다른 문서에서 가져왔습니다.
[ 펼치기 · 접기 ]
문서의 r432 ( 이전 역사)
문서의 r11 ( 이전 역사)


[1] 개발자가 실행 중인 서버의 상태를 모니터링할 수 있다. [2] 플레이어를 제외한 개체를 이용한 공격. EX) TNT폭발, 모래/자갈에 깔리는 경우, 낙사, 즉시 데미지 포션, 용암 [3] 다운로드 받은 리소스팩 파일을 Input에다가 드레그하여 놓고 Hash 버튼을 누르면 바로 아래쪽에 SHA-1으로 암호화된 리소스팩 파일이 나온다. [4] 즉, 만약 이 값이 3이라면, 플레이어가 설정에서 렌더 거리를 32청크로 설정해도 실제로는 3청크만 보이게 된다. [5] 외국 서버 이야기이다. [6] 단 영어만 가능 [7] 공인 아이피 기준이므로 같은 공유기를 사용한다면 동시 접속이 불가능하다. [8] true로 설정하면 서버가 가득차도 오피가 접속 가능하다. [9] 3이상을 적어도 3으로 설정된다.