Minecraft server documentation
Start with a stable jar, understand your expansion path, and tune the settings that impact player experience the most.
How to install a Minecraft server
For most communities, Paper is the best default because it offers strong performance and broad plugin compatibility. Vanilla is fine for small private worlds, while Forge or Fabric are better for modded servers.
-
Choose the correct server type
Use Vanilla for pure Mojang behavior, Paper for plugin-focused public servers, Fabric for lightweight mods, and Forge or NeoForge for heavier modpacks.
-
Upload the jar and create a startup command
Make sure the Java version matches the Minecraft release you want to run. Newer versions usually require more recent Java builds.
java -Xms2G -Xmx4G -jar paper-1.21.jar --nogui -
Accept the EULA
Run the server once so it generates the required files, then edit
eula.txtand set the value to true.eula=true -
Review memory and world settings
Do not assign every gigabyte available on the node. Leave enough RAM for the operating system, panel agent, and Java overhead.
Plugins vs mods explained
Choosing the wrong stack is one of the most common causes of launch issues. Plugins and mods solve different problems.
| Type | Best for | Runs on | Client changes required? |
|---|---|---|---|
| Plugins | Admin tools, economy, ranks, anti-cheat, minigames | Paper, Spigot, Purpur | No, players join with a normal client. |
| Mods | New blocks, tech systems, questing, total gameplay overhauls | Fabric, Forge, NeoForge | Yes, clients usually need the same mods. |
When to choose plugins
Use plugins if you want a public survival server, economy, permissions, or gameplay tweaks without forcing players to install a custom launcher.
When to choose mods
Use mods if your goal is custom content, automation, RPG mechanics, or an existing modpack experience. Make sure the loader and version all match.
Basic server.properties explanation
The server.properties file controls essential world and network behavior. Below are the settings most customers adjust first.
| Setting | Example | What it does |
|---|---|---|
motd | CapybaraHost SMP | Server description shown in the multiplayer list. |
difficulty | normal | Changes mob strength and survival challenge. |
gamemode | survival | Default mode for new players. |
view-distance | 8 | How many chunks are sent to players. |
simulation-distance | 6 | How many chunks actively tick gameplay logic. |
white-list | true | Restricts access to approved users only. |
motd=CapybaraHost Survival
online-mode=true
pvp=true
difficulty=normal
gamemode=survival
view-distance=8
simulation-distance=6
max-players=30
After editing server.properties, restart the server so the new settings take effect.
Still having issues? Contact support
If the server fails to boot, throws Java version errors, or plugins are loading in red, join our Discord for guidance.