Server Hosting Guide
Set up, configure, and connect to your own modded Minecraft server, from installing Java to port forwarding.
Prefer a managed host?
You can host a pre-configured server from
BisectHosting for 25% off using
the code PIXELDREAM.
Install Java
Pick the right Java version for your modpack.
| Minecraft version | Java version |
|---|---|
| 1.17 and newer | Java 17 or newer |
| 1.16.5 and older | Java 8 |
Always check your modpack's own requirements as well — they take priority over the table above.
Download and install it. We recommend Eclipse Temurin, though OpenJDK also works. Both are free and fully compatible with Minecraft.
Verify the installation by running the following in your terminal:
java -versionSet Up the Server
Download the server pack for your modpack. It's usually under "Additional Files" or "Server Files" on the modpack's download page.
Extract the archive using 7-Zip or an equivalent tool.
Start the server using the instructions for your operating system.
- Run Windows PowerShell as administrator.
- Enter
Set-ExecutionPolicy RemoteSigned, then typeYto accept. - Close the administrator window and open PowerShell normally.
- Navigate to your server directory:
cd path\to\server - Unblock the start script:
Unblock-File -Path .\start.ps1 - Run it:
.\start.ps1
Ignore the Windows steps entirely. Instead, make start.sh executable and run
it from your terminal:
chmod +x start.sh
./start.shAccept the Minecraft EULA by entering I agree when prompted, or by editing
eula.txt manually.
Wait for initialization to finish, then follow the connection steps below.
Stopping the server
Always shut down with the stop command. Closing the window or killing the
process can corrupt your world.
Configure Your Server
Edit server.properties to change how your server behaves:
| Setting | What it controls |
|---|---|
server-ip | Your local IP address |
server-port | The port players connect to (default 25565) |
max-players | How many players can be online at once |
difficulty | peaceful, easy, normal, or hard |
gamemode | survival, creative, adventure, or spectator |
motd | The server description shown in the server list |
pvp | Whether players can damage each other |
view-distance | Render distance in chunks (8–16 recommended) |
white-list | Whether the whitelist is enforced |
Restart the server after changing server.properties. Edits made while it's
running are overwritten on shutdown.
Connect to Your Server
On the same network (LAN)
- In Minecraft, click Multiplayer → Add Server.
- For the server address, use
localhostor your local IP address.
Over the internet (WAN)
- Find your public IP address by searching "what is my IP" online.
- In Minecraft, click Multiplayer → Add Server.
- For the server address, use
your.public.ip:25565.
Port forwarding
Required for players connecting from a different network:
- Open your router's admin panel.
- Find the port forwarding settings.
- Create a new rule:
- Protocol: TCP/UDP
- External port: 25565
- Internal port: 25565
- Internal IP: your server's local IP
Performance Tips
- Allocate an appropriate amount of RAM in your start script.
- Keep
view-distancebetween 8 and 12 chunks. - Keep
entity-broadcast-range-percentageat 100 or lower. - Monitor TPS (ticks per second) to gauge server health.
Troubleshooting
- Verify the server is actually running.
- Check that port forwarding is set up correctly.
- Confirm your firewall isn't blocking the port.
- Check how much RAM is allocated in the start script.
- Reduce the view distance.
- Monitor system resources on the host machine.
- Ensure every player has the exact same modpack version.
- Verify the modpack is compatible with your server pack.
