Wiki · Servers & help

Troubleshooting

What to do when Lunchtime won't start, crashes, looks wrong, won't connect or is missing something, and how to report a bug.

For Lunchtime v2.5.1 · Minecraft 1.20.1

Start here when something goes wrong. Most problems come down to Java, memory, a version mismatch or something added on top of the pack, and the log usually says which. For slow FPS or lag, see Performance instead.

Back up your world before you try fixes, especially anything that changes mods or versions. See World and save problems for how.

Where to find logs and crash reports

Almost every fix starts with the log. Two files matter:

  • logs/latest.log: everything from your last session, including errors.
  • crash-reports/crash-….txt: written when the game crashes, newest last.

Both are in your Lunchtime instance folder:

  • CurseForge app: open the Lunchtime profile, choose the ⋯ menu → Open Folder.
  • Prism Launcher: select the instance and choose Folder, then open the minecraft folder inside it. You can also read the log in Edit → Minecraft Log.
  • A server: the logs and crash-reports folders inside the server folder.

After a crash, Lunchtime's Crash Assistant opens a window with the crash report and logs ready to share. When you read a log yourself, look for the first real error, usually a line with ERROR, Exception or Caused by:. The last lines are often just the game shutting down.

The game won't launch

What you see: the launcher says the game closed, the window never opens, or it closes during the first loading bar.

Common causes: the wrong Java version, too little or too much memory, a broken or partial install, or mods, shaders or resource packs you added yourself.

Check first: the end of logs/latest.log. Messages like these point to the cause:

  • java.lang.UnsupportedClassVersionError or Unsupported class file major version: the wrong Java. Use Java 17.
  • Could not reserve enough space for object heap: more memory was requested than Java can get. Lower it, or make sure you're on 64-bit Java.
  • java.lang.OutOfMemoryError: too little memory allocated.
  1. Check the version
    Lunchtime v2.5.1 needs Minecraft 1.20.1, Forge 47.4.29 and Java 17. The CurseForge app sets this up for you.
  2. Check Java and memory
    Set Java 17 and about 8,000 MB of memory. See Java and Memory.
  3. Undo what you added
    If you added mods, shaders or resource packs yourself, take them out again and test.
  4. Repair the install
    If files may be missing, for example after a cancelled download, reinstall the same Lunchtime version in your launcher. Copy your saves folder somewhere safe first.

When to report: if a clean install of the current version still won't start, report it with the log.

It crashes while loading

What you see: a Forge error screen listing mods, or the game closes on the loading screen and Crash Assistant opens.

How to read a crash report: open the newest file in crash-reports. Near the top, the Description: line says what the game was doing. Below it, find the first Caused by: line and look at the mod names in the lines just under it. A Forge error screen during loading usually names the mod and what it's missing, for example a mod that requires another one.

Why not just remove mods? Lunchtime's mods depend on each other, so removing one can break several others. Removing mods from an existing world also permanently deletes their blocks and items from it. Find the cause in the log first.

  1. Note the mod and the error from the first Caused by: line or the Forge error screen.
  2. Undo your own changes, if you've added or updated any mods yourself.
  3. Check Java and memory, as in The game won't launch.
  4. Ask or report with the full crash report if it's a clean install.

Black screen or rendering problems

What you see: a black or white screen, flickering, see-through terrain, or a crash when entering a world or opening the video settings.

Common causes: shaders, graphics drivers, or extra rendering mods added on top of the pack. Lunchtime renders with Embeddium and runs shaders through Oculus; shaders are off by default.

  1. Turn shaders off
    Options → Video Settings → Shader Packs, and switch shaders off. If the problem started when you turned shaders on, this is almost always it.
  2. Can't reach the menu?
    Close the game, open config/oculus.properties in your instance folder, change enableShaders=true to enableShaders=false, save and start again.
  3. Update your system
    On Windows and Linux, update your graphics drivers. On a Mac, update macOS. See Performance.
  4. Remove rendering mods you added
    Don't add OptiFine, Sodium or other rendering mods. Lunchtime already has Embeddium and Oculus, and others clash with them.

When to report: if it happens with shaders off on an up-to-date system, report it with your log, your graphics card or Mac model, and a screenshot.

Missing or wrong textures

What you see: purple-and-black checkerboard blocks or items, plain boxes instead of a model, or menus that look wrong.

Common causes: a resource pack that's off, in the wrong order or failed to load, a resource pack you added, or a real bug in the pack.

  1. Check your resource packs
    In Options → Resource Packs, check you haven't switched off any of the pack's own packs. Remove packs you added yourself.
  2. Restart the game
    A texture that failed to load during a busy start often loads fine the next time.
  3. Check the known issues below. One fish model is a known problem right now.

When to report: with a screenshot and the item or block name. Press F3 + H to show advanced tooltips with the item's ID.

The server won't start

What you see: the start script stops with an error, or the console closes before it says Done.

Check first: the last lines in the console and logs/latest.log in the server folder.

MessageWhat it meansFix
ERROR! variables.txt not presentThe script can't find its settings, usually because the zip isn't fully extractedExtract the whole Server Pack and run the script from the folder that contains variables.txt
Mojang's EULA has not yet been acceptedThe EULA wasn't acceptedStart again and type I agree
Permission denied (macOS, Linux)The script isn't marked as runnableRun chmod +x start.sh install_java.sh, or bash start.sh
A Java version mismatchThe server found a Java other than 17Install Java 17, or let the script install it
Could not reserve enough space for object heapThe memory in JAVA_ARGS is more than the computer can giveLower -Xmx and -Xms in variables.txt
FAILED TO BIND TO PORT!Something else, often another server, is using port 25565Close the other server, or change server-port
A warning about spaces in the pathThe server folder's path has spacesMove the server to a folder without spaces

The full setup, including Java and memory, is on Server setup.

When to report: if a fresh copy of the Server Pack, with Java 17, still won't reach Done, report it with logs/latest.log.

Can't join a server

What you see: the server shows as offline, the connection times out, or you're disconnected with a list of mods.

  • Different versions: if you're disconnected with a list of mismatched or missing mods, your Lunchtime version doesn't match the server's. Everyone needs the same version; check the server's version and update or switch your profile to it.
  • Server still starting: a modded server takes a few minutes. Wait until its console shows Done.
  • Wrong address or port: check the address, and add :port if the server doesn't use 25565.
  • Connection timed out or Connection refused: the server isn't reachable. It may be off, or a firewall or router is blocking it. See Connect to the server.
  • You are not white-listed on this server!: ask the owner to add you.
  • Voice chat won't connect, but the game does: the server's voice chat port, UDP 24454, isn't reachable. See Friends over the internet.
  • Failed to verify username!: restart your launcher and sign in to your Microsoft account again.

Missing items or recipes

What you see: an item, recipe or quest you expected isn't there, or a recipe won't craft.

Common causes: a different pack version, a job level the recipe needs, an item the pack removed or merged on purpose, or a quest that needs an earlier quest first.

  1. Check your version
    The game window's title shows the Lunchtime version. Compare it with the release notes.
  2. Look it up in JEI
    Search for the item in JEI, the recipe viewer next to your inventory. If it has no recipe, it may come from quests or loot.
  3. Hover over it
    If it's locked, the tooltip names the job and level it needs.
  4. Check Pack changes
    Some items are removed or merged on purpose, such as phantoms, duplicate crops and a few Kaleidoscope furniture pieces. See Pack changes.

When to report: include your version, the item's ID from F3 + H, a screenshot of JEI, and what you expected to happen.

World and save problems

What you see: a world won't load, blocks or items are missing after an update, or you're warned the world was made with another version.

Back up first, before trying anything else. In single player, choose your world, then Edit → Make Backup. The backup is saved as a zip in the instance's backups folder. You can also copy the world's folder from saves. On a server, stop it and copy the world folder.

  • After an update: read the release notes. Some updates ask you to do something first, like emptying the Inventorio tool belt before v2.5.1. Worlds from v1.5 lose a lot of data in v2, because quests, jobs, claims, graves and several mobs were replaced.
  • Opening an older world: only open a world in a newer version after making a backup. Don't open a world in an older version than it was last played in.
  • Missing blocks: blocks and items from mods you removed are gone from that world for good. Restore your backup with the mods back in place.
  • A world that won't load: keep it as it is and restore a backup copy, or ask on Discord with your log. Don't delete it: a broken world can often be rescued.

Known issues

These come from the issue tracker and the pack's release notes, as of v2.5.1.

  • Obidontee shows as a yellow box. Reported in v2.5.1: the Obidontee caught with a Starcatcher rod shows as a plain box instead of its model. The report is open.
  • The Advanced Refill Upgrade is disabled. It could delete totems from your off-hand, so its recipe is off since v2.5. One already in a backpack keeps working until you take it out.
  • Inventorio was removed in v2.5.1 because of an item duplication and deletion bug. Take tools out of its belts before updating from v2.5.
  • Some Kaleidoscope furniture vanished. A few broken table, chair and stool variants are removed on purpose, and the pack takes them out of inventories.
  • Explorer's Compass can't find Alex's Caves biomes in this pack. The Caves & Curiosities chapter covers Cave Maps for them, which need Explorer 15.

Reporting a problem

ProblemWhere to go
A bug or crash in LunchtimeThe Lunchtime issue tracker on GitHub. Choose New issue and the bug report form
A bug in one of our own mods, like Lunchtime Jobs, the Cookbook, Miso's Little Guide or Gentle SeasonsThe same issue tracker, with the mod's name in the title
A bug in another mod in the packFirst check it happens without anything you added yourself. If you're sure it's that mod's own bug, report it on the mod's issue tracker, linked from its CurseForge page. If you're not sure, report it on our tracker
"How do I…?" questions and quick helpThe Lunchtime Discord
Private mattersThe Contact page

Search the existing issues first, in case someone has already reported it. A good report includes:

  • Your Lunchtime version, such as v2.5.1.
  • Your launcher (CurseForge app or Prism Launcher) and your operating system.
  • Whether it happens in single player or on a server.
  • The crash report or logs/latest.log. You can upload a log to mclo.gs and share the link.
  • The steps to make it happen again, what you expected, and screenshots if it's something you can see.

Never share passwords, tokens or account codes, even if someone asks for them. Remove private details such as your server's address or IP from logs before you post them.