What are all these files for ?

The files in the top level of your Minecraft server directory control elements of the server as explained below. You can edit them by hand with the Text Editor in the Configuration Files tab or alter them by issuing in-game commands either as an Op within the game or from the Web Console.


Some items from the server.properties file can also be changed with the Configuration Editor.


For more details about the proper editing of JSON files, see: How do I edit JSON files?


For details about configuring common files for modded Minecraft, see:


“ip”: “#.#.#.#”,
“created”: “YYYY-MM-DD HH:MM:SS -000”,
“source”: “Server”,
“expires”: “forever”,
“reason”: “Banned by an operator”


Server Command: /ban-ip <ip-address or player name> [reason]


ban-ip prevents the anyone from logging in from the specified numerical internet address. A banned player could come back to the server from another location if you don't also add them to banned-players.


Adding a reason is optional but useful, especially on a server where multiple players share admin privilages.


“uuid”: “uuid-string”,
“name”: “PlayerName”,
“created”: “YYYY-MM-DD HH:MM:SS -000”,
“source”: “Server”,
“expires”: “forever”,
“reason”: “Banned by an operator”


Server command: /ban <playerName> [reason]


ban prevents the specified player from logging into the server wherever they are. If the player in question has another account to use, they could come back to the server if you don't also add them to banned-ips. If you know a player connects from same location as another player (such as two siblings in the same house) and only need to ban one, you should only ban their player name, not the IP address (in that sort of situation, beware that the banned player might try to get on through their friend or sibling's account).


If you are editing the file by hand, both the name and the UUID of a player are required. The UUID of a player can be looked up on many sites such as http://mcuuid.net/. Alternately, it can be found by searching in usercache.json.


Other notes on banning players:


If you want to ban a player only temporarily, edit the “expires” line with a date and time in the format “YYYY-MM-DD HH:MM:SS -000” (year-month-day hour:minute:seconds timezone). The timezone is expressed in + or - hours from GMT; for example, Eastern Standard Time would be GMT minus 5, or -005.


To restore a banned player's access, delete their entry from the file or use /pardon <playerName>


"uuid": "uuid-string",
"name": "playerName",
"level": 4,
"bypassesPlayerLimit": false


Server commands: /op <playerName>, /deop <playerName>


Designates the specified player as an Operator, giving them admin powers on the server.


The level, a number from 1-4, indicates the level of power an op has. The default value when using the /op command is set by the op-permission-level entry in the server.properties file.

  1. Level ops can build in the spawn area if spawn-protection is enabled in server.properties.
  2. Level ops can also use the commands /clear, /difficulty, /effect, /gamemode, /gamerule, /give, /summon, /setblock and /tp. They can also edit command blocks.
  3. Level ops can also use the /ban, /deop, /kick and /op commands.
  4. Level ops can also use the /stop command to shut down the server.


In general, the owner of the server will want to give themselves op level 4 and lower levels to those assisting them.


The bypassPlayerLimit setting will allow an op to log on even if the server has the maximum number of players already logged into it if set to true.


To revoke a player's op privilages, delete their entry from the file or use the command /deop <playerName>.




This file contains a list of any players who have connected to the server or been referenced by op/ban commands, including their UUID. Don’t edit this.


“uuid”: “uuid-string”
“name”: “PlayerName”


Sever commands: /whitelist add|remove <playerName>, /whitelist on|off (enable or disable whitelist mode), /whitelist reload (update any changes to the whitelist), /whitelist list (show the current whitelist)


Adds the specified players to the server whitelist. If the command /whitelist on has been set or white-list has been set to true in server.properties, only players on the whitelist will be allowed to connect. This is the preferred setting if you are hosting a server for just you and your friends.


After changing the whitelist, you will want to run the /whitelist reload command to force the changes to take effect without needing to restart the whole server.




See: How do I edit server.properties?


  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

How do I edit server properties ?

The server.properties file lists a number of basic settings for your world in the format...

How do I edit JSON files ?

JSON (JavaScript Object Notation) is a standardized format for managing lists of data in a way...

Powered by WHMCompleteSolution