새로 오신 분들은 길라잡이를 꼭 읽어주세요.

문서의 정리·작성번역을 도와주시면 마인크래프트 위키에 큰 힘이 됩니다.

server.properties

Minecraft Wiki
이동: 둘러보기, 검색
Notepad++로 읽어들인 server.properties

server.properties 는 멀티플레이(마인크래프트 또는 마인크래프트 클래식) 서버 에 필요한 설정이 들어있는 파일입니다.

만약 당신이 server.properties를 편집하려는 경우 설정의 순서는 상관없으나 원래 사용하던 것과 동일한 구조를 사용하는 것이 중요합니다. 설정 파일의 등호(=) 앞의 텍스트를 수정해선 안됩니다. 당신이 수정할수 있는 것은 등호(=) 뒤에 있는 값입니다. 줄 첫번째 문자가 #으로 된 것은 주석입니다. 이것은 지워도 게임에 영향을 미치치 않습니다.

server.properties를 수정 한 후, 설정은 서버를 재시작 한 후에 적용됩니다.

만약 server.properties에 모든 설정이 다 없을 경우(새로운 버전으로 업데이트를 했거나 파일이 존재하지 않을 경우), 서버를 시작하면 server.properties에 새로운 설정이 기본값으로 추가됩니다.

파일 위치[편집 | 원본 편집]

이 파일은 서버를 처음 시작할 때 자동으로 생성됩니다. (파일이 없을 시)

OS (운영 체제) 파일 위치 비고
윈도우즈 Minecraft_Server.exe 와 동일한 폴더
리눅스

유닉스 맥OS

파일을 실행한 위치 (pwd (Path of Working Directory))

만약 당신이 홈 디렉토리(/home/yourname)에서 서버를 실행시켰을 경우 설정 파일은 /home/yourname에 생성됩니다. 당신은 서버 파일이 올바른 위치에 생성되는 것을 보장하기 위해 다음을 따르십시오.

  • 서버를 구동하기 위한 폴더를 새롭게 생성하십시오. (그렇게 하지 않을 경우 많은 파일이 생성되어 혼란스러워질 것입니다)
    • 새롭게 생성한 폴더에 minecraft_server.jar 파일을 넣으십시오.
  • 마인크래프트 서버 실행 스크립트를 설정하기 위한 이 스크립트를 사용하십시오.
    • $PATH 에 스크립트를 넣으세요.
    • 파일에 실행 권한을 부여합니다 (chmod +x 파일명, 또는 파일 관리자를 사용합니다)
      • minecraft_server(.sh)

Server.properties[편집 | 원본 편집]

버전 1.8.1서버의 기본 설정입니다:

#Minecraft server properties
#(File modification datestamp)
spawn-protection=16
max-tick-time=60000
generator-settings=
force-gamemode=false
allow-nether=true
gamemode=0
enable-query=false
player-idle-timeout=0
difficulty=1
spawn-monsters=true
op-permission-level=4
resource-pack-hash=
announce-player-achievements=true
pvp=true
snooper-enabled=true
level-type=DEFAULT
hardcore=false
enable-command-block=false
max-players=20
network-compression-threshold=256
max-world-size=29999984
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
generate-structures=true
online-mode=true
max-build-height=256
level-seed=
use-native-transport=true
motd=A Minecraft Server
enable-rcon=false

Minecraft server properties[편집 | 원본 편집]

타입 기본값 설명
allow-flight boolean false 이 설정을 켜두면 크리에이티브, 관전자모드를 제외한 게임모드를 가진 플레이어가 하늘을 날아도 별 다른 조치를 하지 않게 할 수 있습니다. 예를 들어 모드를 사용하여 날아다니거나 핵 사용자가 날아다닐 수 있게됩니다.
true - 서바이벌 모드에서 날아다니는 것이 허용됩니다.
false - 서바이벌 모드에서 날아다니는 것이 허용되지 않습니다. (플레이어가 5초 이상 공중에 떠있을 경우 킥 처리됩니다)
allow-nether boolean true 지옥에 들어갈 수 있게 할지 안할지 설정합니다.
true - 서버의 지옥 포탈 이 작동하게 됩니다.
false - 지옥 포탈이 작동하지 않게 됩니다.
announce-player-achievements boolean true 플레이어가 도전 과제를 달성 할 때 서버 전체에 알릴지 설정합니다.
true - 도전 과제 달성시 서버 전체에 알립니다.
false - 도전 과제를 달성하여도 서버 전체에 알리지 않습니다.
difficulty integer (0-3) 1 서버의 난이도를 설정합니다. (난이도에 따라 몬스터가 입히는 데미지의 양이 증가하고, 배고픔과 독 효과가 달라집니다)
0 - 평화로움
1 - 쉬움
2 - 보통
3 - 어려움
enable-query boolean false GameSpy4 프로토콜을 허용합니다. 서버의 정보를 가져올 때 사용합니다.
enable-rcon boolean false 원격에서 서버 콘솔에 접근하는 것을 허용합니다.
enable-command-block boolean false 커맨드 블럭의 사용을 허용합니다.
force-gamemode boolean false 서버에 접속시 지정된 게임모드로 변경할 것인지 설정합니다.
true - 플레이어가 접속하면 설정된 게임모드로 변경됩니다.
false - 플레이어가 서버에서 퇴장하기 전의 게임모드가 그대로 유지됩니다.
gamemode integer (0-3) 0 게임 플레이시 게임모드를 정합니다.
0 - 서바이벌
1 - 크리에이티브
2 - 모험
3 - 관전
generate-structures boolean true 구조물의 생성 여부를 정합니다. (예를 들어 마을)
true - 새로운 청크에 구조물을 생성합니다
false - 새로운 청크에 구조물을 생성하지 않습니다.

노트: false로 설정하여도 던전은 생성됩니다.

generator-settings string 비어 있음 서버에서 생성할 월드를 마음대로 조정할 수 있습니다. 완전한 평지사용자 지정 에서 예제를 보실 수 있습니다.
hardcore boolean false true로 설정 시, 플레이어가 죽으면 그 플레이어는 영구적으로 밴 됩니다.
level-name string world 생성될 월드 폴더의 이름을 지정합니다. 만약 저장된 게임을 불러오고 싶다면 이 설정을 폴더의 이름과 동일하게 바꾸면 됩니다.
문자 ' (작은 따옴표)는 앞에 \ (백슬래시)를 붙여서 오류를 방지해야 합니다.
level-seed string 비어 있음 월드를 생성 할 때 사용할 시드를 설정합니다.
예를 들어: minecraft, 404, 1a2b3c.
level-type string DEFAULT 월드가 어떤 방식으로 생성될 지 설정합니다.
DEFAULT - 기본 월드. 언덕, 계곡, 물 등이 생성됩니다.
FLAT - 평지 세계. 아무것도 없고, 건축을 위한 것입니다
LARGEBIOMES - 기본 월드와 같으나 모든 바이옴의 구역이 기본 바이옴보다 커집니다.
AMPLIFIED - 기본 월드와 같으나 높이가 더 증가합니다.
CUSTOMIZED - generator-settings에서 설정한 프리셋을 사용합니다.
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)를 호출합니다.
-1 - 비활성화 (14w32a에서 추가됨)
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:

  • Setting max-world-size to 1000 will allow you to have a 2000x2000 world border.
  • Setting max-world-size to 4000 will give you an 8000 x 8000 world border.
motd string A Minecraft Server This is the message that is displayed in the server list of the client, below the name.
  • The MOTD does support color and formatting codes.
  • If the MOTD is over 59 characters, the server list will likely report a communication error.
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.
-1 - disable compression entirely
0 - compress everything

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.
true - Enabled. The server will assume it has an Internet connection and check every connecting player.
false - Disabled. The server will not attempt to check connecting players.
op-permission-level integer (1-4) 4 서버 OP의 권한의 정도를 설정합니다.
1 - 이 권한 이상으로 설정하면 서버 OP는 스폰의 보호를 무시할 수 있습니다.
2 - 이 권한 이상으로 설정하면 서버 OP는 /clear, /difficulty, /effect, /gamemode, /gamerule, /give, /tp 명령어를 사용할 수 있고,
커맨드 블럭을 수정할 수 있습니다.
3 - 이 권한 이상으로 설정하면 서버 OP는 /ban, /kick, /op 명령어를 사용할 수 있습니다.
4 - 이 권한으로 설정하면 서버 OP는 /stop 명령어를 사용할 수 있습니다.
player-idle-timeout integer 0 If non-zero, players are kicked from the server if they are idle for more than that many minutes.
Note: Idle time is reset when the server receives one of the following packets:
  • 102 (0x66) WindowClick
  • 108 (0x6c) ButtonClick
  • 130 (0x82) UpdateSign
  • 14 (0xe) BlockDig
  • 15 (0xf) Place
  • 16 (0x10) BlockItemSwitch
  • 18 (0x12) ArmAnimation
  • 19 (0x13) EntityAction
  • 205 (0xcd) ClientCommand
  • 3 (0x3) Chat
  • 7 (0x7) UseEntity
pvp boolean true Enable PvP on the server. Players shooting themselves with arrows will only receive damage if PvP is enabled.
true - Players will be able to kill each other.
false - Players cannot kill other players (also known as Player versus Environment (PvE)).

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 Optional URI to a resource pack. The player may choose to use it.
resource-pack-hash
string blank Optional SHA-1 digest of the resource pack, in lowercase hexadecimal. It's recommended to specify this. This is not yet used to verify the integrity of the resource pack, but improves the effectiveness and reliability of caching.
server-ip string blank Set this if you want the server to bind to a particular IP. It is strongly recommended that you leave server-ip blank!
Set to blank, or the IP you want your server to run (listen) on.
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.
false - disable snooping.
true - enable snooping.
spawn-animals boolean true Determines if animals will be able to spawn.
true - Animals spawn as normal.
false - Animals will immediately vanish.

Tip: if you have major lag, turn this off/set to false.

spawn-monsters boolean true Determines if monsters will be spawned.
true - Enabled. Monsters will appear at night and in the dark.
false - Disabled. No monsters.

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.
true - Enabled. Villagers will spawn.
false - Disabled. No villagers.
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
true - Enabled. Enable Linux packet sending/receiving optimization
false - Disabled. Disable Linux packet sending/receiving optimization
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.

false - No white list is used.
true - The file whitelist.json is used to generate the white list.

Note: Ops are automatically white listed, and there is no need to add them to the whitelist.

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
true - Enabled. The server will check all names with Minecraft.net
false - Disabled. The server will make sure the IP matches
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.
true - The server will be displayed in the server list - anyone can see it.
false - Only people with the URL which can be found in externalurl.txt and people who know the IP and port can join the server
server-name string The name of the server. This is displayed in the server list and when someone is joining the server
  • A single line of text. Characters such as ' (apostrophe) may need to be escaped by adding a backslash before them.
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.
true - the server will allow saplings to grow into trees.
false - the server will not allow saplings to grow into trees.