๐Ÿฐ Hytale
How to change the max players

How to change the max players

The max players setting controls how many players can be on your server at the same time. The default is 100, but you can adjust it based on your server's resources and needs.

Step 1

Stop the server from the Console tab. Then go to the File Manager section and open the config.json file in the root directory.

Step 2

Locate the "MaxPlayers" field and set it to your desired value:

config.json
"MaxPlayers": 50,

Step 3

Click Save content at the top right, then start your server from the Console tab.

How many players can your server handle?

The value in config.json is just a cap โ€” whether your server runs smoothly at that limit depends on its resources:

  • RAM โ€” More players means more data in memory. If the server starts lagging as players join, RAM is usually the first bottleneck.
  • CPU โ€” Each player generates tick load. Large groups in the same area are harder on the CPU than players spread across the map.
  • World complexity โ€” Servers with many placed structures and entities use more resources per player than a fresh world.

Start with a conservative limit and raise it as you get a feel for your server's performance. It's easier to increase the cap than to troubleshoot lag with a full server.

โœ… That's it! Your server will now enforce the new player limit. If you have any problems, contact us via Discord (opens in a new tab) so we can help you.