server.properties — Sponge 6.0.0 documentation (2022)

allow-flight

boolean

false

Allows users to use flight on your server while inSurvival mode, if they have a mod that provides flightinstalled.

With allow-flight enabled griefers will possibly be morecommon, because it will make their work easier. InCreative mode this has no effect.

false - Flight is not allowed (players in air for atleast 5 seconds will be kicked).

true - Flight is allowed.

allow-nether

boolean

true

Allows players to travel to the Nether.

false - Nether portals will not work.

true - The server will allow portals to send playersto the Nether.

announce-player-achievements

boolean

true

Allows the server to announce when a player gets anachievement.

difficulty

integer(0-3)

1

Defines the difficulty (such as damage dealt by mobs andthe way hunger and poison affects players) of the server.

0 - Peaceful

1 - Easy

2 - Normal

3 - Hard

enable-query

boolean

false

Enables the GameSpy4 protocol server listener. Used to getinformation about the server.

enable-rcon

boolean

false

Enables remote access to the server console.

enable-command-block

boolean

false

Enables command blocks.

force-gamemode

boolean

false

Force players to join in the default game mode.

false - Players will join in the gamemode they hadwhen they last left.

true - Players will always join in the defaultgamemode.

gamemode

integer(0-3)

Defines the mode of gameplay.

0 - Survival

1 - Creative

2 - Adventure

3 - Spectator

generate-structures

boolean

true

Defines whether structures (such as villages) will begenerated in new chunks.

false - Structures will not be generated.

true - Structures will be generated.

Note: Dungeons will still generate if this is set tofalse.

generator-settings

string

blank

The settings used to customize world generation. SeeSuperflatandCustomizedon the Minecraft Wiki (external links) for possiblesettings and examples.

hardcore

boolean

false

If set to true, players will be permanently banned ifthey die.

level-name

string

world

The «level-name» value will be used as the world name andits folder name. You may also copy your saved game folderhere, and change the name to the same as that folder’s toload it instead.

Characters such as ' (apostrophe) may need to be escapedby adding a backslash (\) before them.

level-seed

string

blank

Add a seed for your world, as in Singleplayer.

Some examples are: minecraft, 404, 1a2b3c.

level-type

string

DEFAULT

Determines the type of map that is generated.

DEFAULT - Standard world with hills, valleys, water,etc.

FLAT - A flat world with no features, meant forbuilding.

LARGEBIOMES - Same as default, but all biomes arelarger.

AMPLIFIED - Same as default, but world-generationheight limit is increased.

CUSTOMIZED - Same as default unlessgenerator-settings is set to a preset.

max-build-height

integer

256

The maximum height in which building is allowed. Terrainmay still naturally generate above a low height limit.

max-players

integer (0-2147483647)

20

The maximum number of players that can play on the serverat the same time. Note that if more players are on theserver it will use more resources. Note also, op playerconnections are not supposed to count against the maxplayers, but ops currently cannot join a full server.Extremely large values for this field result in theclient-side user list being broken.

max-tick-time

integer (0-(2^63-1))

60000

The maximum number of milliseconds a single tick may takebefore the server watchdog stops the server with themessage: "A single server tick took 60.00 seconds (shouldbe max 0.05); Considering it to be crashed, server willforcibly shutdown". Once this criteria is met, it callsSystem.exit(1).

-1 - disable watchdog entirely

max-world-size

integer (1-29999984)

29999984

This sets the maximum possible size in blocks, expressedas a radius, that the world border can obtain. Setting theworld border bigger causes the commands to completesuccessfully, but the actual border will not move pastthis block limit. Setting the max-world-size higher thanthe default doesn’t appear to do anything.

Examples:

  • Setting max-world-size to 1000 will allow you to have a2000x2000 world border.

  • Setting max-world-size to 4000 will give you an8000x8000 world border.

motd

string

AMinecraftServer

This is the message that is displayed in the server listof the client, below the name.

  • The MOTD does support color and formatting codes.

  • If the MOTD is over 59 characters, the server list willlikely report a communication error.

network-compression-threshold

integer

256

By default it allows packets that are n-1 bytes big to gonormally, but a packet that n bytes or more will becompressed down. So, lower number means more compressionbut compressing small amounts of bytes might actually endup with a larger result than what went in.

Note: The ethernet spec requires that packets lessthan 64 bytes become padded to 64 bytes. Thus, setting avalue lower than 64 may not be beneficial. It is alsonot recommended to exceed the MTU (Maximum TransmissionUnit), typically 1500 bytes.

online-mode

boolean

true

Server checks connecting players against Minecraft’saccount database. Only set this to false if your server isnot connected to the Internet. Hackers with fake accountscan connect if this is set to false! If minecraft.net isdown or inaccessible, no players will be able to connectif this is set to true. Setting this variable to offpurposely is called «cracking» a server, and servers thatare presently in offline mode are called «cracked»servers, allowing players with unlicensed copies ofMinecraft to join.

false - Disabled. The server will not attempt tocheck connecting players.

true - Enabled. The server will assume it has anInternet connection and check every connecting player.

op-permission-level

integer(1-4)

4

Sets permission level for ops. Each level also containsthe permissions of the levels below it.

1 - Ops can bypass spawn protection.

2 - Ops can use /clear, /difficulty, /effect,/gamemode, /gamerule, /give, and /tp, and can editcommand blocks.

3 - Ops can use /ban, /deop, /kick, and /op.

4 - Ops can use /stop.

player-idle-timeout

integer

If non-zero, players are kicked from the server if theyare idle for more than that many minutes.

Note: Idle time is reset when the server receivesone 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 witharrows will only receive damage if PvP is enabled.

false - Players cannot kill other players (also knownas Player versus Environment (PvE)).

true - Players will be able to kill each other.

Note: Indirect damage sources spawned by players(such as lava, fire, TNT and to some extent water, sandand 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 for remote connection.

rcon.port

integer (1-65534)

25575

Sets the port for remote connection.

resource-pack

string

blank

Optional URI to a resource pack. The player may choose touse it.

resource-pack-hash

string

blank

Optional SHA-1 digest of the resource pack, in lowercasehexadecimal. It’s recommended to specify this. This is notyet used to verify the integrity of the resource pack, butimproves the effectiveness and reliability of caching.

server-ip

string

blank

Set this if you want the server to bind to a particularIP. It is strongly recommended that you leave this 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 anetwork using NAT (If you have a home router/firewall).

snooper-enabled

boolean

true

Sets whether the server sends snoop data regularly tohttp://snoop.minecraft.net. (external link)

false - Disable sending of data.

true - Enable sending of data.

spawn-animals

boolean

true

Determines whether animals will be able to spawn.

false - All animals will immediately vanish, and nonewill spawn.

true - Animals spawn as normal.

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

spawn-monsters

boolean

true

Determines whether hostile mobs will be able to spawn.

false - All mobs will immediately vanish, and nonewill spawn anywhere, or at any time of day.

true - Mobs spawn as normal; in darkness and atnight.

This will have no effect if difficulty is set to Peaceful.

Tip: if you have major lag, set this 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. Settingthis to 0 will not disable spawn protection. 0 willprotect the single block at the spawn point. 1 willprotect a 3x3 area centered on the spawn point. 2 willprotect 5x5, 3 will protect 7x7, etc. This option is notgenerated on the first server start and appears when thefirst 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 packetsending/receiving on Linux.

false - Disabled. Disable Linux packetsending/receiving optimization.

true - Enabled. Enable Linux packetsending/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-sideviewing distance.

10 is the default/recommended. If you have major lag,reduce this value.

white-list

boolean

false

Enables a whitelist on the server.See Managing the Whitelist.With a whitelist enabled, users not on the whitelist willbe unable to connect. Intended for private servers, suchas those for real-life friends or strangers carefullyselected via an application process, for example.

false - No whitelist is used.

true - The file whitelist.json is used togenerate the whitelist.

Note: Ops are automatically whitelisted, and thereis no need to add them to the whitelist.

Top Articles

Latest Posts

Article information

Author: Barbera Armstrong

Last Updated: 10/29/2022

Views: 5973

Rating: 4.9 / 5 (59 voted)

Reviews: 82% of readers found this page helpful

Author information

Name: Barbera Armstrong

Birthday: 1992-09-12

Address: Suite 993 99852 Daugherty Causeway, Ritchiehaven, VT 49630

Phone: +5026838435397

Job: National Engineer

Hobby: Listening to music, Board games, Photography, Ice skating, LARPing, Kite flying, Rugby

Introduction: My name is Barbera Armstrong, I am a lovely, delightful, cooperative, funny, enchanting, vivacious, tender person who loves writing and wants to share my knowledge and understanding with you.