
Wiki · Servers & help
Server setup
Run your own Lunchtime server with the official Server Pack, step by step, on Windows, macOS or Linux.
For Lunchtime v2.5.1 · Minecraft 1.20.1
This guide sets up a Lunchtime server on your own computer with the official Server Pack. The Server Pack already has the right mods, configs and start scripts, and the mods that only work on a player's computer are already switched off. You don't need to copy or remove any mods yourself.
Rather not run it yourself? BisectHosting, our hosting partner, installs Lunchtime in one click and keeps the server online when your computer is off. See Hosting. To play with friends without a server at all, see Multiplayer.
Before you start
- The server runs Minecraft 1.20.1 with Forge 47.4.29 and needs Java 17.
- It needs its own memory. Plan on 6 to 8 GB just for the server (see Memory). If you also play on the same computer, your game needs its own memory on top.
- The first start needs an internet connection. The scripts download Forge and its libraries.
- Everyone who joins needs Lunchtime v2.5.1, the same version as the server.
1. Download the Server Pack
The Server Pack is a separate download from the normal modpack. Don't use the regular Lunchtime-Cozy-Create-and-Cooking-v2.5.1.zip for a server: that's the client file the CurseForge app installs for players.
- Open the Server Pack file
Go to Lunchtime_Cozy_Create_and_Cooking_Server_Pack_v2.5.1.zip on CurseForge. You can also find it on the pack's Files page, under Server Packs or under Additional Files of the v2.5.1 release. - Download it
It's a large download, about 1.6 GB.
2. Extract it
Make a new, empty folder for the server and extract the zip into it. Pick a short path without spaces: the start scripts warn you and ask before they run from a folder with spaces in its path, because spaces can make the server crash.
Windows
- Make a folder such as
C:\LunchtimeServer. - Right-click the zip, choose Extract All…, pick that folder and choose Extract.
macOS
- Double-click the zip in Finder. It extracts next to the zip.
- Move the extracted folder somewhere simple, such as a
LunchtimeServerfolder in your home folder.
Linux
mkdir -p ~/lunchtime-server
unzip Lunchtime_Cozy_Create_and_Cooking_Server_Pack_v2.5.1.zip -d ~/lunchtime-server
When you're done, open the folder and check you can see start.sh, start.bat, variables.txt, server.properties and the mods and config folders. If they're inside one more folder, use that inner folder from now on.
3. Install Java 17
Minecraft 1.20.1 with Forge 47.4.29 runs on Java 17, 64-bit. The Server Pack's variables.txt asks for Java 17 too.
Check which Java you have
Open Command Prompt (Windows) or Terminal (macOS and Linux) and run:
java -version
You're ready if the first line shows version 17, for example openjdk version "17.0.13". If it says the command isn't found, or shows another version such as 21 or 8, install Java 17.
Install it
Download Eclipse Temurin 17 from adoptium.net. Choose your operating system and the JDK or JRE installer, version 17.
- Windows: the
.msifor x64. Keep the option that adds Java to your PATH. - macOS: the
.pkg. Choose aarch64 for Apple Silicon (M1 and newer) and x64 for Intel Macs. - Linux: use your distribution's Java 17 package, or follow Adoptium's installation guide.
Close and reopen your terminal, then run java -version again to check.
The scripts can install Java for you. If no Java 17 is found, the start script offers to install it with a small tool called Jabba. Type I agree when it asks, and it downloads Temurin 17 just for this server. On Linux this needs a recent glibc; if your system is too old, the script tells you and you install Java 17 yourself.
If you have several Java versions, you can point the server at Java 17 by setting JAVA in variables.txt to the full path of its java program. On Windows, put an extra \ before every \ and : in the path, as the comment at the top of variables.txt shows.
4. Start the server
Windows
Double-click start.bat. It runs the PowerShell start script for you. Don't delete the .ps1 files: start.bat needs them.
macOS and Linux
Open Terminal, go to the server folder and run the start script:
cd ~/LunchtimeServer
./start.sh
If you get Permission denied, the script lost its "executable" setting while it was extracted. Fix it once, then start again:
chmod +x start.sh install_java.sh
./start.sh
Running bash start.sh also works. Double-clicking start.sh in Finder usually opens it in a text editor instead of running it, so use Terminal.
Accept the EULA
The first time, the script asks you to accept Mojang's Minecraft EULA. Read it, then type I agree and press Enter. The script saves your answer in eula.txt as eula=true, so it only asks once.
What happens next
The script prints a short summary starting with Starting server..., with the Minecraft, Forge and Java versions and the memory settings it read from variables.txt. On the first start it downloads and installs Forge, which takes a few minutes. Then the server loads every mod and generates the world, which can take several more minutes.
The server is ready when the console shows a line like this:
Done (95.432s)! For help, type "help"
Keep the window open while people play. To shut down, type stop in the console and wait for it to save. Closing the window without stop can lose recent progress.
The Forge installer also creates run.bat and run.sh. You can ignore them and keep using start.bat or start.sh. Don't delete them: the next start would install the server again.
It stopped or crashed? The error is near the end of the console and in logs/latest.log. See Server won't start for what the common errors mean.
5. Set the server's memory
The server's memory is set in variables.txt, on this line:
JAVA_ARGS="-Xmx4G -Xms4G"
The Server Pack starts with 4 GB. For Lunchtime, 6 to 8 GB is a better start for a small group of friends. To give it 6 GB, change the line to:
JAVA_ARGS="-Xmx6G -Xms6G"
Save the file and start the server again. -Xmx is the most memory the server can use; -Xms is what it reserves at start.
- Only edit
variables.txt. Don't edituser_jvm_args.txt: the start script writes it again fromvariables.txtevery time. - Leave room for the computer. Your operating system and other programs need memory too, so never give the server all of your RAM.
- Server memory and game memory are separate. The number in
variables.txtis only for the server. Each player sets their own game's memory in their launcher (8 GB recommended, see Performance). If you host and play on the same computer, add both: an 8 GB game plus a 6 GB server needs about 14 GB free, so a 16 GB computer will be tight and 32 GB is comfortable. - More isn't always better. Watch real use before you raise it further. The server performance tips show how to check with spark.
6. Connect to the server
Every player needs Lunchtime v2.5.1 installed from CurseForge, the same version as the server. Then they open Multiplayer → Add Server and enter the address:
| Who | Address to use |
|---|---|
| You, on the server computer | localhost |
| Friends on the same home network | The server computer's local IP address, such as 192.168.1.20 |
| Friends over the internet | Your public address, once your network lets them reach the server (see below) |
The server listens on port 25565, the Minecraft default (server-port in server.properties). If you change the port, add it to the address, for example 192.168.1.20:25570.
To find your local IP address: run ipconfig on Windows and look for the IPv4 Address; on macOS open System Settings → Wi-Fi (or Network) → Details; on Linux run hostname -I. If Windows asks whether Java may use the network, allow it on private networks.
Friends over the internet
Friends outside your home network can't reach a server on your computer by default. Common ways to let them in:
- Port forwarding: in your router's settings, forward TCP port 25565 to the server computer, then share your public IP address. Every router is different, and some internet providers don't allow it.
- A virtual network or tunnel that your friends join, if port forwarding isn't possible.
- A hosted server such as BisectHosting, which gives you an address that works anywhere.
Voice chat uses its own port. Simple Voice Chat listens on UDP port 24454, set in config/voicechat/voicechat-server.properties. If you use port forwarding, forward that UDP port too, or players can join but voice chat won't connect.
Only share your address with people you trust. The Server Pack has online-mode=true, so everyone needs a real Minecraft account. To allow only your friends, type whitelist on in the server console and whitelist add PlayerName for each player.
7. Update to a new version
When a new Lunchtime version comes out, update the server and every player to the same version. Keep your world and your settings apart from the server files:
- Stop the server
Typestopand wait until it has saved. - Back up first
Copy the whole server folder somewhere safe. At the very least keep theworldfolder,server.properties,whitelist.json,ops.json, thebanned-*.jsonfiles, yourvariables.txtif you changed the memory, and any config files you edited. - Read the release notes
Check Pack changes for anything to do before updating. For example, v2.5.1 asks players to take their tools out of the Inventorio tool belt first. - Extract the new Server Pack into a new folder
Don't extract it over the old one, and don't delete the old folder yet. - Bring your world and settings across
Copy theworldfolder and the files from step 2 into the new folder. If you changed config files, compare them with the new versions instead of copying old ones over, so you keep the release's fixes. - Start the new server
Once it reachesDoneand your world looks right, you can remove the old folder. Keep the backup for a while.
Never delete or replace the world folder to fix an update problem. Ask on Discord first.
Server settings worth knowing
- Day length and rain come from Gentle Seasons and are set on the server. Players are synced automatically.
- Jobs settings are in
config/lunchtimejobs-common.toml: the number of active jobs, XP rates withglobalXpMultiplieror per job, and more. See Jobs. - Market Orders reset every Monday at 06:00.
- The default
server.propertieshas 10 player slots, easy difficulty and a view distance of 10. For tips on distances, see Performance. - Admin commands are listed in Commands & keys.
Stuck? See Troubleshooting, or ask on Discord.