How to Change Player Slots on Your Minecraft Server

If you want to change player slots on your server, you need to edit the max-players setting inside your server’s server.properties file. This setting controls how many players can be connected to your Minecraft: Java Edition server at the same time. The same setting is used by Vanilla Java servers, Paper servers, Spigot servers, and most Spigot-based forks. Paper’s official documentation lists max-players=20 as the default setting for the maximum number of players allowed on the server.

Player slots are important because they control your server’s capacity. A higher slot count lets more people join, but it does not automatically mean your server can handle more players smoothly. More connected players usually means more chunk loading, more entity activity, more plugin usage, and more CPU and RAM demand. Mojang’s own Java server setup documentation also describes max-players as the setting that specifies how many people can join your server.

This guide explains how to safely change Minecraft server player slots, what the setting does, and how to choose a realistic player limit for your server.

This Guide Is for Minecraft: Java Edition #

This guide applies to Minecraft: Java Edition servers.

That includes:

• Vanilla Minecraft servers
• Paper servers
• Spigot servers
• Purpur servers
• Most other Spigot or Paper forks

This guide does not cover Minecraft Bedrock Edition servers, since Bedrock uses a different server system and different configuration behavior.

What Are Minecraft Server Player Slots? #

Minecraft server player slots are the maximum number of players allowed online at one time.

For example, if your server is set to:

max-players=20

then up to 20 players can join the server at the same time.

If the server reaches that limit, additional players will not be able to join until someone leaves or the limit is increased.

Why Player Slots Matter #

Changing player slots is not just about picking a bigger number. Your player limit should match what your server can actually handle.

A server with too many players may experience:

• lag spikes
• low TPS
• slow chunk loading
• delayed commands
• plugin performance issues
• crashes during peak activity

A server with too few slots may unnecessarily block players from joining, especially if your community is growing.

The goal is to set a player limit that fits your server’s hardware, software, and gameplay style.

Where Player Slots Are Configured #

The player slot limit is controlled by the max-players line inside:

server.properties

The server.properties file is the main configuration file for a Minecraft Java server. It is normally located in the root folder of your server, near files and folders such as:

server.properties
eula.txt
plugins/
world/
server.jar

On hosted Minecraft servers, you can usually access this file from your server control panel’s File Manager.

On a self-hosted server, it will be inside the folder where your server .jar file is located.

Before You Change Minecraft Server Player Slots #

Before editing anything, stop your Minecraft server completely.

This matters because some server settings may not save correctly if the server is still running. Stopping the server first also prevents the file from being overwritten while you are editing it.

Before continuing:

• Stop the server
• Wait until it shows as offline
• Open the file manager or server directory
• Locate server.properties

Do not edit the file while the server is actively running.

How to Change Minecraft Server Player Slots #

Follow these steps to update the max player limit.

Step 1: Open Your Server Control Panel #

Log into your Minecraft server control panel.

Look for a section called one of the following:

• Files
• File Manager
• Server Files
• Config Files

Open the main server directory.

Step 2: Open the server.properties File #

Find this file:

server.properties

Open it using the file editor in your hosting panel.

If you are hosting the server on your own PC or VPS, open the file with a text editor such as:

• Notepad
• Notepad++
• Visual Studio Code

Step 3: Find the max-players Setting #

Inside server.properties, look for this line:

max-players=20

The number after the equals sign is the current player slot limit.

The default is commonly set to 20 on Java server configurations, including Paper’s documented default.

Step 4: Change the Player Slot Limit #

Change the number to the maximum amount of players you want online at one time.

For example, if you want 10 players:

max-players=10

If you want 50 players:

max-players=50

Only change the number after the equals sign. Do not rename the setting.

Correct:

max-players=30

Incorrect:

players=30

Incorrect:

max players 30

The setting must stay formatted as:

max-players=NUMBER

Step 5: Save the File #

After changing the value, save server.properties.

Make sure the file keeps its normal line-by-line formatting. If everything appears on one long line, use a better text editor or restore the file formatting before starting the server again.

Step 6: Restart the Minecraft Server #

Start your server again from the control panel.

The new player slot limit will apply after the server restarts.

If you changed the value while the server was still running, restart the server anyway to make sure the new setting takes effect.

Step 7: Check the New Player Limit #

After the server is online, check that the new player limit is working.

You can do this by:

• viewing the server in the Minecraft multiplayer server list
• checking the player count display
• reviewing your server panel
• joining the server and confirming it is online

The server list should show the updated maximum player count.

Recommended Player Slot Settings #

Your player slot count should be based on your server’s actual performance, not just the biggest number you want to advertise.

Here is a practical starting point:

These numbers are general recommendations. A well-optimized Paper server on strong hardware may handle more players than a heavily modded or poorly optimized server with the same slot count.

Player Slots Do Not Increase Server Performance #

A common mistake is thinking that increasing max-players upgrades the server.

It does not.

The max-players setting only controls how many people are allowed to connect. It does not increase RAM, CPU power, disk speed, or network capacity.

If your server is already lagging with 10 players, raising the limit to 30 will usually make the problem worse.

Before increasing player slots, check:

• current RAM usage
• CPU usage
• TPS
• plugin load
• view distance
• simulation distance
• entity counts
• world size

For many Minecraft servers, performance issues are caused by a mix of player count, chunk loading, plugins, mobs, redstone, and server hardware.

Best Practices for Setting Minecraft Player Slots #

For a smoother server experience, follow these best practices:

• Start with a realistic slot count
• Increase slots slowly as your community grows
• Watch performance during peak hours
• Do not advertise more slots than your server can handle
• Optimize view distance and simulation distance before scaling up
• Use Paper or a Paper-based fork for better performance options
• Upgrade your hosting plan if your server consistently reaches its limit

A smaller server that runs smoothly is better than a large server that constantly lags.

Common Issues After Changing Player Slots #

The Player Limit Did Not Change #

If the server still shows the old player limit:

• make sure you saved server.properties
• restart the server
• confirm you edited the correct file
• check that the line still says max-players=

The Server Starts Lagging After Increasing Slots #

If lag begins after raising the player limit, your server may not have enough resources for the new capacity.

Try:

• lowering the player limit again
• reducing view-distance
• reducing simulation-distance
• checking plugin performance
• upgrading RAM or CPU resources

Players Still Cannot Join #

If players cannot join even though slots are available, the issue may not be the player limit.

Check:

• whitelist settings
• server IP and port
• firewall or connection issues
• player bans
• online-mode authentication issues

Example server.properties Player Slot Setup #

Here is a simple example of a server configured for a small SMP:

max-players=15
difficulty=normal
white-list=false
view-distance=8
simulation-distance=6

This setup keeps the player limit reasonable while also reducing some of the chunk and simulation load that can cause lag on smaller servers.

When Should You Increase Player Slots? #

You should consider increasing your Minecraft server player slots when:

• your server is regularly full
• players are waiting to join
• your TPS stays stable during peak hours
• CPU and RAM usage are still healthy
• your community is ready to grow

Do not increase slots just because the setting allows it. Increase them when your server performance shows that it can support more players.

When Should You Lower Player Slots? #

You should lower the player limit if:

• the server lags during busy hours
• TPS drops below a stable level
• players complain about delayed actions
• chunk loading becomes slow
• the server crashes under load

Lowering slots is not always a bad thing. Sometimes it is the easiest way to protect the player experience while you work on optimization or upgrade the server.

Smooth Server Growth Starts With the Right Limit #

Changing Minecraft player slots is simple, but choosing the right number takes some thought. The max-players setting controls access, not performance. If you match your slot count to your server’s hardware, software, and player activity, you will create a smoother experience for everyone who joins.

For most new servers, start smaller, monitor performance, and increase the limit only when the server is ready for more players.