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.

  1. 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.

  2. 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
  3. Accept the EULA

    Run the server once so it generates the required files, then edit eula.txt and set the value to true.

    eula=true
  4. 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.

Performance tip: If your player count grows, optimize simulation-distance, entity-heavy farms, and chunk generation before simply increasing RAM.

Plugins vs mods explained

Choosing the wrong stack is one of the most common causes of launch issues. Plugins and mods solve different problems.

TypeBest forRuns onClient changes required?
PluginsAdmin tools, economy, ranks, anti-cheat, minigamesPaper, Spigot, PurpurNo, players join with a normal client.
ModsNew blocks, tech systems, questing, total gameplay overhaulsFabric, Forge, NeoForgeYes, 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.

Warning: Plugins built for Paper will not run on Fabric or Forge. Likewise, Fabric mods will not work on Paper unless a compatibility project explicitly supports that combination.

Basic server.properties explanation

The server.properties file controls essential world and network behavior. Below are the settings most customers adjust first.

SettingExampleWhat it does
motdCapybaraHost SMPServer description shown in the multiplayer list.
difficultynormalChanges mob strength and survival challenge.
gamemodesurvivalDefault mode for new players.
view-distance8How many chunks are sent to players.
simulation-distance6How many chunks actively tick gameplay logic.
white-listtrueRestricts 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.

Don’t want to do this manually?

We can install the correct jar, optimize startup flags, configure whitelist rules, and prep your server for launch.

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.