server.properties 는 멀티플레이(Minecraft 또는 Minecraft 클래식) 서버 에 필요한 설정이 들어있는 파일입니다.
만약 당신이 server.properties를 편집하려는 경우 설정의 순서는 상관없으나 원래 사용하던 것과 동일한 구조를 사용하는 것이 중요합니다. 설정 파일의 등호(=) 앞의 텍스트를 수정해선 안됩니다. 당신이 수정할수 있는 것은 등호(=) 뒤에 있는 값입니다.
줄 첫번째 문자가 #
으로 된 것은 주석입니다. 이것을 지우거나 수정하여도 게임에 영향을 주지 않습니다.
server.properties를 수정했다면 서버를 재시작하거나 /reload
명령어를 이용해서 변경된 사항을 서버에 적용시켜야 합니다. 그전 까지는 기존의 설정이 유지됩니다.
만약 server.properties에 모든 설정이 다 없을 경우(새로운 버전으로 업데이트되어 properties에 새로운 사항을 적용해야되는 경우나 있어야 될 위치에 파일이 존재하지 않을 경우), 서버가 다시시작 되면 server properties는 기본값으로 바뀝니다.
파일 위치
이 파일은 자동으로 생성되는 기본값 입니다.(파일이 없거나 처음 시작할 때)
OS (운영 체제) | 파일 위치 | 비고 |
---|---|---|
윈도우즈 | Minecraft_Server.exe 와 동일한 폴더 | |
리눅스
유닉스 맥OS |
파일을 실행한 위치 (pwd (Path of Working Directory)) |
만약 당신이 홈 디렉토리(/home/yourname)에서 서버를 실행시켰을 경우 설정 파일은 /home/yourname에 생성됩니다. 당신은 서버 파일이 올바른 위치에 생성되는 것을 보장하기 위해 다음을 따르십시오.
|
server.properties
Minecraft 서버를 새로 설치하면 나오는 기본 설정값입니다.
Java Edition
#Minecraft server properties
#(File creation timestamp)
spawn-protection=16
max-tick-time=60000
query.port=25565
generator-settings=
sync-chunk-writes=true
force-gamemode=false
allow-nether=true
enforce-whitelist=false
gamemode=survival
broadcast-console-to-ops=true
enable-query=false
player-idle-timeout=0
difficulty=easy
broadcast-rcon-to-ops=true
spawn-monsters=true
op-permission-level=4
pvp=true
snooper-enabled=true
level-type=default
hardcore=false
enable-command-block=false
network-compression-threshold=256
max-players=20
max-world-size=29999984
resource-pack-sha1=
function-permission-level=2
rcon.port=25575
server-port=25565
server-ip=
spawn-npcs=true
allow-flight=false
level-name=world
view-distance=10
resource-pack=
spawn-animals=true
white-list=false
rcon.password=
generate-structures=true
online-mode=true
max-build-height=256
level-seed=
prevent-proxy-connections=false
use-native-transport=true
motd=A Minecraft Server
enable-rcon=false
Default as of 20w14a.
Bedrock Edition
server-name=Dedicated Server
# Used as the server name
# Allowed values: Any string
gamemode=survival
# Sets the game mode for new players.
# Allowed values: "survival", "creative", or "adventure"
difficulty=easy
# Sets the difficulty of the world.
# Allowed values: "peaceful", "easy", "normal", or "hard"
allow-cheats=false
# If true then cheats like commands can be used.
# Allowed values: "true" or "false"
max-players=10
# The maximum number of players that can play on the server.
# Allowed values: Any positive integer
online-mode=true
# If true then all connected players must be authenticated to Xbox Live.
# Clients connecting to remote (non-LAN) servers will always require Xbox Live authentication regardless of this setting.
# If the server accepts connections from the Internet, then it's highly recommended to enable online-mode.
# Allowed values: "true" or "false"
white-list=false
# If true then all connected players must be listed in the separate whitelist.json file.
# Allowed values: "true" or "false"
server-port=19132
# Which IPv4 port the server should listen to.
# Allowed values: Integers in the range [1, 65535]
server-portv6=19133
# Which IPv6 port the server should listen to.
# Allowed values: Integers in the range [1, 65535]
view-distance=32
# The maximum allowed view distance in number of chunks.
# Allowed values: Any positive integer.
tick-distance=4
# The world will be ticked this many chunks away from any player.
# Allowed values: Integers in the range [4, 12]
player-idle-timeout=30
# After a player has idled for this many minutes they will be kicked. If set to 0 then players can idle indefinitely.
# Allowed values: Any non-negative integer.
max-threads=8
# Maximum number of threads the server will try to use. If set to 0 or removed then it will use as many as possible.
# Allowed values: Any positive integer.
level-name=Bedrock level
# Allowed values: Any string
level-seed=
# Use to randomize the world
# Allowed values: Any string
default-player-permission-level=member
# Permission level for new players joining for the first time.
# Allowed values: "visitor", "member", "operator"
texturepack-required=false
# Force clients to use texture packs in the current world
# Allowed values: "true" or "false"
content-log-file-enabled=false
# Enables logging content errors to a file
# Allowed values: "true" or "false"
compression-threshold=1
# Determines the smallest size of raw network payload to compress
# Allowed values: 0-65535
server-authoritative-movement=true
# Enables server authoritative movement. If true, the server will replay local user input on
# the server and send down corrections when the client's position doesn't match the server's.
# Corrections will only happen if correct-player-movement is set to true.
player-movement-score-threshold=20
# The number of incongruent time intervals needed before abnormal behavior is reported.
# Disabled by server-authoritative-movement.
player-movement-distance-threshold=0.3
# The difference between server and client positions that needs to be exceeded before abnormal behavior is detected.
# Disabled by server-authoritative-movement.
player-movement-duration-threshold-in-ms=500
# The duration of time the server and client positions can be out of sync (as defined by player-movement-distance-threshold)
# before the abnormal movement score is incremented. This value is defined in milliseconds.
# Disabled by server-authoritative-movement.
correct-player-movement=false
# If true, the client position will get corrected to the server position if the movement score exceeds the threshold.
Minecraft server properties
Java Edition
키 | 타입 | 기본값 | 설명 |
---|---|---|---|
allow-flight | boolean | false | 이 설정을 켜두면 크리에이티브, 관전자모드를 제외한 게임모드를 가진 플레이어가 하늘을 날아도 별 다른 조치를 하지 않게 할 수 있습니다. 예를 들어 모드를 사용하여 날아다니거나 핵 사용자가 날아다닐 수 있게됩니다.
|
allow-nether | boolean | true | 네더에 들어갈 수 있게 할지 안할지 설정합니다.
|
broadcast-console-to-ops | boolean | true | 콘솔의 커맨드 출력을 온라인 상태의 관리자에게 전송합니다. |
broadcast-rcon-to-ops | boolean | true | rcon콘솔의 커맨드 출력을 온라인 상태의 관리자에게 전송합니다. |
difficulty | integer (0-3) | 1 | 서버의 난이도를 설정합니다. (난이도에 따라 몬스터가 입히는 데미지의 양이 증가하고, 배고픔과 독 효과가 달라집니다)
|
enable-command-block | boolean | false | 커맨드 블록의 사용을 허용합니다. |
enable-jmx-monitoring[차기 버전용: JE 1.16] | boolean | false | Exposes an MBean with the Object name net.minecraft.server:type=Server and two attributes averageTickTime and tickTimes exposing the tick times in milliseconds.
In order for enabling JMX on the Java runtime you also need to add a couple of JVM flags to the startup as documented here. |
enable-rcon | boolean | false | 원격에서 서버 콘솔에 접근하는 것을 허용합니다. |
sync-chunk-writes | boolean | true | Enables synchronous chunk writes. |
enable-status[차기 버전용: JE 1.16] | boolean | true | 서버 목록에서 서버의 상태가 "온라인" 이라고 표시되게 합니다.
만약 false로 설정했다면, 클라이언트로부터 오는 응답을 차단합니다. 이것의 의미는 오프라인으로 표시된다는 것 이지만 여전히 서버에 접속하는 것이 가능합니다. |
enable-query | boolean | false | GameSpy4 프로토콜을 허용합니다. 서버의 정보를 가져올 때 사용합니다. |
entity-broadcast-range-percentage[차기 버전용: JE 1.16] | integer (0-100) | 100 | 엔티티가 얼마나 가깝게있을 필요가 있는지 클라이언트에 먼저 전송해옵니다. 높은 값의 의미는 그만큼 엔티티가 멀리서 렌더링 되고 잠재적인 렉 유발 요소로 부터 멀어지는 것을 의미합니다. 이것은 퍼센테이지로 표현됩니다. 예를 들자면 50이라고 설정했다면 몹 스폰률이 반이 된다는 것을 의미합니다. |
force-gamemode | boolean | false | 서버에 접속시 지정된 게임모드로 변경할 것인지 설정합니다.
|
function-permission-level | integer (1-4) | 2 | Minecraft 함수의 기본 펄미션 레벨을 설정합니다.
#op-permission-level에서 각 레벨에 대한 설명을 참조하세요. |
gamemode | integer (0-3) | 0 | 게임 플레이시 게임모드를 정합니다.
|
generate-structures | boolean | true | 구조물의 생성 여부를 정합니다. (예를 들어 마을)
노트: false로 설정하여도 던전은 생성됩니다. |
generator-settings | string | 비어 있음 | 서버에서 생성할 월드를 마음대로 조정할 수 있습니다. 완전한 평지 와 사용자 지정 에서 예제를 보실 수 있습니다. |
hardcore | boolean | false | true로 설정 시, 플레이어가 죽으면 그 플레이어는 영구적으로 밴 됩니다. |
level-name | string | world | 생성될 월드 폴더의 이름을 지정합니다. 만약 저장된 게임을 불러오고 싶다면 이 설정을 폴더의 이름과 동일하게 바꾸면 됩니다.
|
level-seed | string | 비어 있음 | 월드를 생성 할 때 사용할 시드를 설정합니다.
|
level-type | string | DEFAULT | 월드가 어떤 방식으로 생성될 지 설정합니다.
|
max-build-height | integer | 256 | 플레이어가 블록을 설치할 수 있는 최고 높이를 설정합니다. |
max-players | integer (0-2147483647) | 20 | 서버에 접속 가능한 최대 플레이어 수를 설정합니다. 많은 플레이어를 수용할 시 그만큼 더 많은 리소스를 사용하게 됩니다. 관리자(op)는 최대 플레이어에 관계없이 접속이 가능합니다. 그러나 관리자도 접속하지 못할 정도가 되면 클라이언트에서 유저 리스트가 손상됩니다. |
max-tick-time |
integer (0–(2^63 - 1)) | 60000 | 설정된 값의 틱을 넘어서면(렉의 발생 등) 서버가 다음 메세지를 출력하면서 정지됩니다: A single server tick took 60.00 seconds (should be max 0.05); Considering it to be crashed, server will forcibly shutdown. 또한 System.exit(1)를 호출합니다.
|
max-world-size |
integer (1-29999984) | 29999984 | This sets the maximum possible size in blocks, expressed as a radius, that the world border can obtain. Setting the world border bigger causes the commands to complete successfully but the actual border will not move past this block limit. Setting the max-world-size higher than the default doesn't appear to do anything.
Examples:
|
motd | string | A Minecraft Server | This is the message that is displayed in the server list of the client, below the name.
|
network-compression-threshold |
integer | 256 | By default it allows packets that are n-1 bytes big to go normally, but a packet that n bytes or more will be compressed down. So, lower number means more compression but compressing small amounts of bytes might actually end up with a larger result than what went in.
Note: The Ethernet spec requires that packets less than 64 bytes become padded to 64 bytes. Thus, setting a value lower than 64 may not be beneficial. It is also not recommended to exceed the MTU, typically 1500 bytes. |
online-mode | boolean | true | Server checks connecting players against minecraft's account database. Only set this to false if your server is not connected to the Internet. Hackers with fake accounts can connect if this is set to false! If minecraft.net is down or inaccessible, no players will be able to connect if this is set to true. Setting this variable to off purposely is called "cracking" a server, and servers that are presently with online mode off are called "cracked" servers, allowing players with unlicensed copies of Minecraft to join.
|
op-permission-level | integer (1-4) | 4 | 서버 OP의 권한의 정도를 설정합니다.
|
player-idle-timeout | integer | 0 | If non-zero, players are kicked from the server if they are idle for more than that many minutes.
|
pvp | boolean | true | Enable PvP on the server. Players shooting themselves with arrows will only receive damage if PvP is enabled.
Note: Indirect damage sources spawned by players (such as lava, fire, TNT and to some extent water, sand and gravel) will still deal damage to other players. |
query.port | integer (1-65534) | 25565 | Sets the port for the query server (see enable-query). |
rcon.password | string | blank | Sets the password to rcon. |
rcon.port | integer (1-65534) | 25575 | Sets the port to rcon. |
resource-pack | string | blank | (선택사항) 리소스팩의 다운로드 URL을 입력하여 유저가 서버리소스팩으로 다운로드합니다. 서버 리소스팩은 유저가 사용 여부를 결정 할 수 있으며 다운로드 성공 여부는 서버에 처음 로그인 할 때 알려줍니다. 하지만 실패하더라도 서버에서 활동하는 것은 가능합니다. 리소스팩의 용량이 약 50MB(50.4MB)보다 크면 안됩니다. |
resource-pack-sha1 |
string | blank | (선택사항) SHA-1 함수로 암호화 된 리소스팩을 입력합니다. 이것은 소문자로 된 16진수로 구성되어 있으며, 리소스팩의 무결성을 검증하는데 사용하기 때문에 정확하게 입력해야 합니다.
Note: 리소스팩이 조금이라도 이곳에 입력한 데이터와 다르다면 서버를 시작 할때 노란 글씨로 "Invalid sha1 for resource-pack-sha1" 라고 서버 콘솔에서 나타납니다. 해시함수의 특성 상 아주 낮은 확률로 충돌이 일어나기 때문에 위 결과가 서버 실행에 영향을 미치지 않습니다. |
server-ip | string | blank | 당신이 원하는 특정한 아이피로 서버에 접근할 수 있도록 고정합니다. 이 칸을 비워두는 것을 강력하게 추천합니다.
|
server-port | integer (1-65534) | 25565 | Changes the port the server is hosting (listening) on. This port must be forwarded if the server is hosted in a network using NAT (If you have a home router/firewall). |
snooper-enabled | boolean | true | Sets whether the server sends snoop data regularly to http://snoop.minecraft.net.
|
spawn-animals | boolean | true | Determines if animals will be able to spawn.
Tip: if you have major lag, turn this off/set to false. |
spawn-monsters | boolean | true | Determines if monsters will be spawned.
This does nothing if difficulty = 0 (peaceful) Unless your difficulty is not set to 0, when a monster can still spawn from a Monster Spawner. Tip: if you have major lag, turn this off/set to false. |
spawn-npcs | boolean | true | Determines if villagers will be spawned.
|
spawn-protection | integer | 16 | Determines the radius of the spawn protection. Setting this to 0 will not disable spawn protection. 0 will protect the single block at the spawn point. 1 will protect a 3x3 area centered on the spawn point. 2 will protect 5x5, 3 will protect 7x7, etc. This option is not generated on the first server start and appears when the first player joins. If there are no ops set on the server, the spawn protection will be disabled automatically. |
use-native-transport | boolean | true | Linux server performance improvements: optimized packet sending/receiving on Linux
|
view-distance | integer (3-15) | 10 | Sets the amount of world data the server sends the client, measured in chunks in each direction of the player (radius, not diameter). It determines the server-side viewing distance. (see Render distance)
10 is the default/recommended. If you have major lag, reduce this value. |
white-list | boolean | false | Enables a whitelist on the server.
With a whitelist enabled, users not on the whitelist will be unable to connect. Intended for private servers, such as those for real-life friends or strangers carefully selected via an application process, for example.
Note: Ops are automatically white listed, and there is no need to add them to the whitelist. |
enforce-whitelist | boolean | false | Enforces the whitelist on the server.
When this option is enabled, users who are not present on the whitelist (if it's enabled) get kicked from the server after the server reloads the whitelist file.
|
Java Edition 1.12에서는 announce-player-achievements이 문자열의 형태로 존재하였으며 그 기능은 플레이어가 도전 과제를 달성하였을 때 서버 전체에 대한 알람의 전송 여부를 결정하였습니다. 하지만 이 설정은 /gamerule announceAdvancements
로 이동하여 더이상 볼 수 없습니다.
Bedrock Edition
Option name | Possible values | Default value | When is it used | Use | Notes |
---|---|---|---|---|---|
gamemode | survival (0), creative (1), adventure (2) | survival | Always or only for new players | Sets the game mode for new players. | |
difficulty | peaceful (0), easy (1), normal (2), hard (3) | easy | Always | Sets the difficulty of the world. | |
level-type | FLAT, LEGACY, DEFAULT | DEFAULT | World creation | Determines the type of map that is generated. | |
server-name | Any string | Dedicated Server | Always | Used as the server name | This is the server name shown in the in-game server list. |
max-players | Positive integer | 10 | Always | The maximum number of players that can play on the server. | The maximum numbers of players that should be able to play on the server. Higher values have performance impact. |
server-port | Any integer | 19132 | Always | Which IPv4 port the server should listen to. | |
server-portv6 | Any integer | 19133 | Always | Which IPv6 port the server should listen to. | |
level-name | Any string | level | Always | The "level-name" value is used as the world name and its folder name. The player may also copy their saved game folder here, and change the name to the same as that folder's to load it instead. | The name of level to be used/generated. Each level has its own folder in /worlds .
|
level-seed | Any string | Defaults to empty (th34f1ju34facjn5f871df312h) | World creation | Use to randomize the world | The seed to be used for randomizing the world. If left empty, a seed is chosen at random. |
online-mode | true, false | true | Always | If true then all connected players must be authenticated to Xbox Live. | If true then all connected players must be authenticated to Xbox Live. |
white-list | true, false | false | Always | If true then all connected players must be listed in the separate whitelist.json file. | If true then all connected players must be listed in the separate whitelist.json file.
|
allow-cheats | true, false | false | Always | If true then cheats like commands can be used. | |
view-distance | Any integer | 10 | Always | The maximum allowed view distance in number of chunks. | The maximum allowed view distance. Higher values have performance impact. |
player-idle-timeout | Any integer | 30 | Always | After a player has idled for this many minutes they get kicked. | After a player has idled for this many minutes they get kicked. |
max-threads | Any integer | 8 | Always | Maximum number of threads the server tries to use. If set to 0 or removed then it uses as many as possible. | Maximum number of threads the server tries to use. |
tick-distance | An integer in the range [4, 12] | 4 | Always | The world is ticked this many chunks away from any player. | The world is ticked this many chunks away from any player. Higher values have performance impact. |
default-player-permission-level | visitor, member, operator | member | Always | Permission level for new players joining for the first time. | Permission level that new players have when they join for the first time. |
texturepack-required | true, false | false | Always | Force clients to use texture packs in the current world | If the world uses any specific texture packs then this setting forces the client to use it. |
Minecraft Classic server properties
Key | Type | Default Value | Description |
---|---|---|---|
verify-names | boolean | true | If enabled the server will make sure that the client is logged in with the same IP on Minecraft.net. This has caused problems for people trying to play on the same computer they are hosting the server on as the server will see the local IP (127.0.0.1) while Minecraft.net will see the external IP. It is recommended that this is enabled unless you want to play on your server from the same computer you are hosting it on
|
admin-slot | boolean | false | Allow ops to join even if the server is full. |
public | boolean | Whether the server should be displayed in the server list, or not.
| |
server-name | string | The name of the server. This is displayed in the server list and when someone is joining the server
| |
max-players | integer (0-256) | The max numbers of players that can play on the server at the same time. Note that if more players are on the server it will use more resources. Note also, admin connections are not counted against the max players. | |
max-connections | integer (1-3) | The max number of connections the server will accept from the same IP.
Note: If you try to set it higher than 3 it will be changed back to 3. | |
motd | string | MOTD is short for Message of the day, though you do not need to change it every day. The MOTD is displayed when people join the server. | |
grow-trees | boolean | Whether or not the server will allow planted saplings to grow into trees.
|
개발 주기 |
| ||||||||
---|---|---|---|---|---|---|---|---|---|
게임 모드 | 크리에이티브 • 서바이벌 • 하드코어 • 모험 • 관전 • 체험판 • (예정: 깃발 빼앗기) | ||||||||
도움 | 조작법 • 옵션 • 튜토리얼 • 자주 묻는 질문 | ||||||||
기술적 | 알려진 버그 • 크래시 • 디버그 화면 • 시드 • 통계 • Minecraft.jar • 서버 (서버 리스트 • .properties) • 데이터 값 | ||||||||
게임플레이 | 조합 • 도전 과제 • 방어 • 교배 • 포션 양조 • 치명타 • 전리품 • 마법부여 • 경험치 • 거래 • 생명력 • 배고픔 • 보관함 • 멀티플레이어 • 난이도 • 레드스톤 회로 • 농사 • 웅크리기 • 이동 • 스폰 • 프로그램과 에디터 • 리소스 팩 | ||||||||
버전 | PC용 (4k • 체험판) • 엑스박스 360 에디션 • 엑스박스 원 에디션 • 플레이스테이션 3 에디션 • 플레이스테이션 4 에디션 • 플레이스테이션 비타 에디션 • 포켓 에디션 • 파이 에디션 | ||||||||
영화 | Story of Mojang |