Minecraft Wiki
No edit summary
 
No edit summary
 
Line 1: Line 1:
  +
[[File:Server.properties.png|thumb|A server.properties file opened with Notepad++]]
{{Removedstillingame}}
 
{{Entity
 
|image=Zombie.png
 
|health={{hp|100}}
 
|damage={{hp|17}}
 
|spawn=Disabled
 
|firstver=SURVIVAL TEST 0.30
 
|id=53
 
|entityid=Giant
 
}}
 
'''Giants''' are enormous mobs that were added in the last version of [[Survival Test]]. It uses an six times enlarged [[Zombie]] model and the sounds of [[the Player]]. Like Zombies, Giants' only method of attack is to charge into the player.
 
Since Survival Test, Giants have not been used, and they do not spawn naturally. [[Mods]] are required to spawn them in more recent versions.
 
   
  +
'''Server.properties''' is the file which stores all the settings for a multiplayer (Minecraft or Minecraft Classic) server.
==Behavior==
 
Giants act almost identically to how Zombies acted in Survival test. If the player is not in sight, a Giant will look around and walk in seemingly random directions. If it sees the player, it will look down upon the player, slowly walking towards them in the hopes of hitting them. However, they have difficulty doing this, as they can only harm players that are directly below them, otherwise they will simply push the player.
 
   
  +
If you are going to edit server.properties it is important that you use the same structure as the original uses. The text before the equal sign is the key, which you shouldn't change. The text after the equal sign is the property's value, which you can edit. Lines that begin with <code>#</code> are comments - altering or removing these lines has no effect on the game.
Unlike Zombies, Giants are not set on fire by sunlight, and also do not have any idling sounds. They make the same sound as the player when hit, and drop nothing upon death.
 
   
  +
You need to restart your server if you change the server.properties file for the new changes to take effect.
== Trivia ==
 
* When a giant rides a minecart, it will appear to be sitting in mid air.
 
* Giant [[Monster Spawner|Spawner]]s will never spawn giants.
 
* Giants must be hit in the legs or lower middle part of the body to take damage.
 
* Using mods or editors to spawn a giant riding a spider results in a very effective enemy, often killing the player in as few as two hits, even if the player is wearing diamond armor.
 
* Despite the mob's enormous size, it cannot break any blocks.
 
* When tame wolves attack a giant, a Giant will get knocked back as usual, but will not take any actual damage.
 
* Arrows are massive when stuck to a Giant.
 
   
  +
If the server.properties file does not list all properties (such as if a new version of the server adds new properties, or if the file does not exist), then on startup the server will rewrite the server.properties file with the new properties listed, set to their default values. The lines of the file will be in an arbitrary order.
{{Entities}}
 
   
  +
== File Location ==
[[Category:Entity]]
 
   
  +
'''This file is automatically generated upon first start of the server (if it doesn't exist).'''
[[de:Riese]]
 
  +
[[fr:Géant]]
 
  +
{| class="wikitable"
[[hu:Óriás]]
 
  +
|-
[[pl:Gigant]]
 
  +
! OS
[[ru:Гигант]]
 
  +
! File Location
  +
! Notes
  +
|-
  +
! Windows
  +
| Same directory as Minecraft_Server.exe
  +
|
  +
|-
  +
! Linux
  +
Unix
  +
<span>*nix/Mac</span>
  +
| Present Working Directory (pwd)
  +
|
  +
If you start it from your home directory (/home/yourname) the server files will be created in /home/yourname. Follow these guidelines for ensuring that the server files are generated where you would expect them.
  +
* Set aside an entire directory for all of the server files. (''Things could get messy if you don't'').
  +
** Place your minecraft_server.jar here.
  +
* Use the [[Media:Minecraft server template.txt]] script as a guideline for setting up a startup script for your Minecraft server.
  +
** Make sure it's in your executable $PATH
  +
** be sure to rename the file to an acceptable executable name
  +
*** '''minecraft_server(.sh)'''
  +
|}
  +
  +
== Server.properties ==
  +
As of 18th November 2011 [1.0.0], these are the default settings for a newly installed Minecraft server:
  +
<pre>
  +
#Minecraft server properties
  +
#Date and time of creation of file
  +
allow-nether=true
  +
level-name=world
  +
allow-flight=false
  +
enable-query=false
  +
server-port=25565
  +
enable-rcon=false
  +
level-seed=
  +
server-ip=
  +
white-list=false
  +
spawn-animals=true
  +
online-mode=true
  +
pvp=true
  +
difficulty=1
  +
gamemode=0
  +
max-players=20
  +
spawn-monsters=true
  +
view-distance=10
  +
motd=A Minecraft Server
  +
</pre>
  +
  +
== Minecraft server properties ==
  +
  +
{| class="wikitable"
  +
|-
  +
! <span style="white-space:nowrap;">Key</span>
  +
! Type
  +
! Default Value
  +
! Description
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''allow-flight'''</span>
  +
| boolean
  +
| false
  +
| Will allow users to use flight on your server while in Survival mode, if they have a [[mod]] that provides flight installed.
  +
With allow-flight enabled griefers will possibly be more common, because it will make their work easier. In Creative mode this has no effect. This function was implemented by [[jeb]].
  +
:'''false''' - Flight is not allowed. [default]
  +
:'''true''' - Flight is allowed, and used if the player has a fly mod installed.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''allow-nether'''</span>
  +
| boolean
  +
| true
  +
| This option is introduced in Beta 1.6. Allows players to travel to the Nether.
  +
:'''false''' - [[Nether]] portals will not work.
  +
:'''true''' - The server will allow [[Portal]]s to send players to the [[Nether]]. [default]
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''difficulty'''</span>
  +
| number
  +
(0-3)
  +
| 1
  +
| Defines the difficulty (such as damage dealt by mobs and the way hunger and poison affects players) of the server.
  +
:'''0''' - Peaceful
  +
:'''1''' - Easy [default]
  +
:'''2''' - Normal
  +
:'''3''' - Hard
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''enable-query'''</span>
  +
| boolean
  +
| false
  +
| Enables GameSpy4 protocol server listener. Used to get information about server.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''enable-rcon'''</span>
  +
| boolean
  +
| false
  +
| Enables remote access to the server console.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''gamemode'''</span>
  +
| number
  +
(0 or 1)
  +
| 0
  +
| Defines the mode of gameplay.
  +
:'''0''' - Survival [default]
  +
:'''1''' - Creative
  +
  +
|-
  +
! <span style="white-space:nowrap;">level-name</span>
  +
| text
  +
| world
  +
| The "level-name" value will be used as world name and as folder name. You may also copy your saved game folder here, and change the name to the same as that folder's to load it instead.
  +
:Characters such as ' (apostrophe) may need to be escaped by adding a backslash before them.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''level-seed'''</span>
  +
| alphanumeric
  +
| ''blank''
  +
| Add a [[Seed (Level Generation)|seed]] for your world. Like in singleplayer.
  +
:Some examples are: 'minecraft', '404', '1a2b3c'
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''max-players'''</span>
  +
| number
  +
(0-999)
  +
| 20
  +
| 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, op player connections are not supposed to count against the max players, but ops currently cannot join a full server.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''motd'''</span>
  +
| text
  +
| ''A Minecraft Server''
  +
| This is the message that is displayed in the server list of the client, below the name. (''Introduced in Beta 1.8.'')
  +
* Note, motd does NOT support color codes.
  +
* If the MOTD is over 59 characters, the server list will likely report a communication error.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''online-mode'''</span>
  +
| 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.
  +
:'''true''' - Enabled. The server will assume it has an Internet connection and check every connecting player. [default]
  +
:'''false''' - Disabled. The server will not attempt to check connecting players.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''pvp'''</span>
  +
| boolean
  +
| true
  +
| Enable PvP on the server.
  +
:'''Note:''' ''Hitting a player while having PvP set to false and having tamed wolves will still cause the wolves to attack the player who was hit.''
  +
:'''true''' - Players will be able to kill each other. [default]
  +
:'''false''' - Players cannot kill other players (Also called PvE).
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''query.port'''</span>
  +
| numeric
  +
(1-65535)
  +
| 25565
  +
| Sets the port for the query server (see '''enable-query''').
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''rcon.password'''</span>
  +
| text
  +
| ''blank''
  +
| Sets the password to rcon.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''rcon.port'''</span>
  +
| numeric
  +
(1-65535)
  +
| 25575
  +
| Sets the port to rcon.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''server-ip'''</span>
  +
| text
  +
| ''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 on.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''server-port'''</span>
  +
| numeric
  +
(1-65535)
  +
| 25565
  +
| Changes the port the server is hosting on. This port must be forwarded if the server is going through a router.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''spawn-animals'''</span>
  +
| boolean
  +
| true
  +
| [[Animals]] will be able to spawn.
  +
''Tip: if you have major lag, turn this off/set to false.''
  +
:'''true''' - Animals spawn as normal. [default]
  +
:'''false''' - Animals will immediately vanish.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''spawn-monsters'''</span>
  +
| boolean
  +
| true
  +
| Set true if you want monsters to be spawned at night, false if you don't.
  +
''Tip: if you have major lag, turn this off/set to false.''
  +
:'''true''' - Enabled. Monsters will appear at night and in the dark [default]
  +
:'''false''' - Disabled. No monsters.
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''view-distance'''</span>
  +
| number
  +
(3-15)
  +
| 10
  +
| The amount of world data the server sends the client, measured in chunks in each direction of the player. The server-side viewing distance. The "Far" viewing distance is 9 chunks.
  +
''10 is the default/recommended. Tip: if you have major lag, reduce this value.''
  +
:''Introduced in Beta 1.6''
  +
  +
|-
  +
! <span style="white-space:nowrap;">'''white-list'''</span>
  +
| boolean
  +
| false
  +
| Enable a white list on the server.
  +
With a white list enabled, users not on the white list 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. [default]
  +
:'''true''' - The file white-list.txt is used to generate the white list.
  +
  +
|-
  +
|}
  +
  +
== Minecraft Classic server properties ==
  +
  +
{| class="wikitable"
  +
|-
  +
! <span style="white-space:nowrap;">Key</span>
  +
! Type
  +
! Default Value
  +
! Description
  +
|-
  +
! <span style="white-space:nowrap;">verify-names</span><!-- This is a guess -->
  +
| 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
  +
|-
  +
! <span style="white-space:nowrap;">admin-slot</span>
  +
| boolean
  +
| false
  +
| Allow ops to join even if the server is full.
  +
|-
  +
! <span style="white-space:nowrap;">public</span>
  +
| 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
  +
|-
  +
! <span style="white-space:nowrap;">server-name</span>
  +
| text
  +
|
  +
| 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.
  +
|-
  +
! <span style="white-space:nowrap;">max-players</span>
  +
| number
  +
(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.
  +
|-
  +
! <span style="white-space:nowrap;">max-connections</span>
  +
| 1-3
  +
|
  +
| The max number of connections the server will accept from the same IP.
  +
:If you try to set it higher than 3 it will be changed back to 3.
  +
|-
  +
! <span style="white-space:nowrap;">motd</span>
  +
| text
  +
|
  +
| [[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.
  +
|-
  +
! <span style="white-space:nowrap;">grow-trees</span>
  +
| 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.
  +
|}
  +
  +
== Other Features ==
  +
In 1.8, having spawn-monsters=false & difficulty=1 will allow mobs to spawn from spawners and do not instantly disappear. Mob will not spawn just because it is dark. Unconfirmed bug or feature.
  +
  +
{{minecraft}}
  +
  +
[[Category:Server]]
  +
  +
[[de:Server.properties]]

Revision as of 13:48, 1 January 2012

Server

A server.properties file opened with Notepad++

Server.properties is the file which stores all the settings for a multiplayer (Minecraft or Minecraft Classic) server.

If you are going to edit server.properties it is important that you use the same structure as the original uses. The text before the equal sign is the key, which you shouldn't change. The text after the equal sign is the property's value, which you can edit. Lines that begin with # are comments - altering or removing these lines has no effect on the game.

You need to restart your server if you change the server.properties file for the new changes to take effect.

If the server.properties file does not list all properties (such as if a new version of the server adds new properties, or if the file does not exist), then on startup the server will rewrite the server.properties file with the new properties listed, set to their default values. The lines of the file will be in an arbitrary order.

File Location

This file is automatically generated upon first start of the server (if it doesn't exist).

OS File Location Notes
Windows Same directory as Minecraft_Server.exe
Linux

Unix *nix/Mac

Present Working Directory (pwd)

If you start it from your home directory (/home/yourname) the server files will be created in /home/yourname. Follow these guidelines for ensuring that the server files are generated where you would expect them.

  • Set aside an entire directory for all of the server files. (Things could get messy if you don't).
    • Place your minecraft_server.jar here.
  • Use the Media:Minecraft server template.txt script as a guideline for setting up a startup script for your Minecraft server.
    • Make sure it's in your executable $PATH
    • be sure to rename the file to an acceptable executable name
      • minecraft_server(.sh)

Server.properties

As of 18th November 2011 [1.0.0], these are the default settings for a newly installed Minecraft server:

#Minecraft server properties
#Date and time of creation of file
allow-nether=true
level-name=world
allow-flight=false
enable-query=false
server-port=25565
enable-rcon=false
level-seed=
server-ip=
white-list=false
spawn-animals=true
online-mode=true
pvp=true
difficulty=1
gamemode=0
max-players=20
spawn-monsters=true
view-distance=10
motd=A Minecraft Server

Minecraft server properties

Key Type Default Value Description
allow-flight boolean false Will allow users to use flight on your server while in Survival mode, if they have a mod that provides flight installed.

With allow-flight enabled griefers will possibly be more common, because it will make their work easier. In Creative mode this has no effect. This function was implemented by jeb.

false - Flight is not allowed. [default]
true - Flight is allowed, and used if the player has a fly mod installed.
allow-nether boolean true This option is introduced in Beta 1.6. Allows players to travel to the Nether.
false - Nether portals will not work.
true - The server will allow Portals to send players to the Nether. [default]
difficulty number

(0-3)

1 Defines the difficulty (such as damage dealt by mobs and the way hunger and poison affects players) of the server.
0 - Peaceful
1 - Easy [default]
2 - Normal
3 - Hard
enable-query boolean false Enables GameSpy4 protocol server listener. Used to get information about server.
enable-rcon boolean false Enables remote access to the server console.
gamemode number

(0 or 1)

0 Defines the mode of gameplay.
0 - Survival [default]
1 - Creative
level-name text world The "level-name" value will be used as world name and as folder name. You may also copy your saved game folder here, and change the name to the same as that folder's to load it instead.
Characters such as ' (apostrophe) may need to be escaped by adding a backslash before them.
level-seed alphanumeric blank Add a seed for your world. Like in singleplayer.
Some examples are: 'minecraft', '404', '1a2b3c'
max-players number

(0-999)

20 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, op player connections are not supposed to count against the max players, but ops currently cannot join a full server.
motd text A Minecraft Server This is the message that is displayed in the server list of the client, below the name. (Introduced in Beta 1.8.)
  • Note, motd does NOT support color codes.
  • If the MOTD is over 59 characters, the server list will likely report a communication error.
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.
true - Enabled. The server will assume it has an Internet connection and check every connecting player. [default]
false - Disabled. The server will not attempt to check connecting players.
pvp boolean true Enable PvP on the server.
Note: Hitting a player while having PvP set to false and having tamed wolves will still cause the wolves to attack the player who was hit.
true - Players will be able to kill each other. [default]
false - Players cannot kill other players (Also called PvE).
query.port numeric

(1-65535)

25565 Sets the port for the query server (see enable-query).
rcon.password text blank Sets the password to rcon.
rcon.port numeric

(1-65535)

25575 Sets the port to rcon.
server-ip text 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 on.
server-port numeric

(1-65535)

25565 Changes the port the server is hosting on. This port must be forwarded if the server is going through a router.
spawn-animals boolean true Animals will be able to spawn.

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

true - Animals spawn as normal. [default]
false - Animals will immediately vanish.
spawn-monsters boolean true Set true if you want monsters to be spawned at night, false if you don't.

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

true - Enabled. Monsters will appear at night and in the dark [default]
false - Disabled. No monsters.
view-distance number

(3-15)

10 The amount of world data the server sends the client, measured in chunks in each direction of the player. The server-side viewing distance. The "Far" viewing distance is 9 chunks.

10 is the default/recommended. Tip: if you have major lag, reduce this value.

Introduced in Beta 1.6
white-list boolean false Enable a white list on the server.

With a white list enabled, users not on the white list 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. [default]
true - The file white-list.txt is used to generate the white list.

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 text 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 number

(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 1-3 The max number of connections the server will accept from the same IP.
If you try to set it higher than 3 it will be changed back to 3.
motd text 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.

Other Features

In 1.8, having spawn-monsters=false & difficulty=1 will allow mobs to spawn from spawners and do not instantly disappear. Mob will not spawn just because it is dark. Unconfirmed bug or feature.