Skip to content
MC Planner
Academy
Minecraft mod

Mod troubleshooting

The MC Planner mod doesn't load, shows only lines or a box, won't sign in, or crashed? Find what you see, and what to do about it.

For Mod 0.3.0 · Minecraft 26.2 · Fabric · Updated

Find what you see below. Most problems are a setting or a missing file.

The mod doesn't load

Minecraft stops at the start with a message about missing or incompatible mods:

  • Minecraft 26.2? This version of the mod is for 26.2 only. Older versions are coming.
  • Fabric API? It has to be in the same mods folder, version 0.160 or newer.
  • Fabric Loader 0.19 or newer?

The game starts, but J does nothing and there's no MC Planner group in the key settings:

  • The right profile? Both .jar files belong in the mods folder of the profile you start, and that profile needs Fabric.
  • J taken? Another mod may use J. Look in Options → Controls → Key Binds for keys shown in red, and give Open MC Planner another key. /mcplanner opens the menu too.

Step by step: Install the mod.

Only lines, no fills

You see outlines, but no coloured or textured ground:

  • An area without a block set only gets its outline at first. Switch on Display… → Area fill, or set a block for it in the app.
  • A path without a block set: check that Display… → Path tiles is on.
  • Fill in Display… set to 10 %? Raise it to 25 % or more.
  • Shader packs are supported: fills show with Iris too. Still only lines with a shader pack? Make sure you have the newest version of the mod, then try with the shader pack switched off. If that changes it, write to us with the name of the shader pack.

Only a box

Buildings show as see-through boxes, with a line at every storey: that's how a building looks. A building from a schematic shows its blocks instead, when the mod finds the file. Only a box there? See the next part.

A schematic shows only as a box

Press J and click the building. The screen says why:

It saysWhat to do
"Not on this computer: …" (the label says "schematic file missing")Get the same file from the source link and put it in Downloads or the schematics folder, then Look again. Step by step.
"Found — switch on Display → Block textures to see its blocks"Switch on Display… → Block textures.
"… is an old MCEdit/Schematica schematic …"Old .schematic files (from before Minecraft 1.13) only show in the app for now.
"… is too big for the game view …"Builds larger than 16 million blocks of space only show in the app.
"Looking for the file…" for a long timeBig folders take a moment. Files over 60 MB aren't looked at.

The file has to be the same file that was placed in the app. A changed or re-saved version is a different file to the mod, and a zipped one isn't found: unpack it first. Builds with more than 600 000 blocks also show as a box.

Asked for a plan? (mod 0.2.0)

Mod 0.2.0 asked for an MC Planner plan before it opened plan files. From 0.3.0 the mod is free for everybody and never asks: get the newest version from the mod page. Still on 0.2.0? Press J → Sign in, and your plan files open.

"This world is paused"

A shared world pauses when its owner's plan doesn't keep it live in MC Planner Cloud any more. The mod still shows it, read-only, the same as the app: the menu says Paused: read-only (Why? opens this page), the HUD says paused, read-only, and statuses and markers can't be changed there.

  • Your world: make it live again in the app, and the mod picks it up by itself: Paused worlds.
  • A friend's world: only the owner can change it. Nothing is lost while it's paused.

The mod looks again every few minutes. (Mod 0.2.0 drew nothing in a paused world: get the newest version from the mod page.)

Sign-in problems

You seeWhat to do
The code ran outPress Try again for a new code, and press Connect on the website before the countdown ends.
The browser didn't openPoint at Open browser: its tooltip shows the address. Open it in your browser yourself.
"Sign-in didn't work." or another messagePress Try again. Check that this computer can reach auth.lab43.dev and app.mc-planner.com (a firewall or school network may block them).
"Signed out · This device was disconnected."Someone disconnected this computer on auth.lab43.dev/account, or the sign-in ran out. Press J → Sign in again.
Signed in, but your worlds aren't thereCheck the name at the top of the menu: it has to be the same account you use in the app. See the next part.

More about signing in: Sign in with a code.

My shared world isn't listed

  • Signed in with the same account as in the app? The menu shows the account at the top.
  • Is the world shared? Only shared worlds are listed, not worlds you plan alone. Share it in the app with Plan together, or use a plan file.
  • Press Refresh on Choose a plan. A message in red says what went wrong.
  • Paused worlds are listed as Paused, read-only: This world is paused.

My plan file isn't listed

  • The mod looks in Documents\MC Planner and in the profile's mcplanner/plans folder, and in the folders directly inside them.
  • Saved in the browser? It's in your Downloads: drop it onto Choose a plan.
  • Is your Documents folder in OneDrive? Then drop the file onto Choose a plan too.
  • Press Refresh.

Nothing shows here

The menu says what's going on:

  • "Nothing planned in this dimension (… objects elsewhere)": the plan is in another dimension.
  • "Everything here is hidden by the filters.": switch filters back on in the menu. Done is hidden at first.
  • The overlay is off: press N. The HUD then says "hidden".
  • Far away: the plan is drawn up to 160 blocks at first. Display… → Draw up to goes up to 512.

"saved copy" or "offline" in the HUD

  • saved copy: the mod shows the last copy it saved while it loads the newest one. It goes away by itself.
  • offline: the plan can't be loaded right now: no internet, or the server didn't answer. You still see the last saved copy, if there is one. The menu (J) shows why under the plan (⚠). The mod keeps trying; Refresh tries at once.

I can't change anything

Status buttons and + Marker here are greyed out: their tooltip says why. See Can't change anything?.

Minecraft crashed? Send a crash report

When Minecraft crashed and the mod was part of the crash, or the mod hit an error while you played, the menu (J) has Crash report at the top left.

It shows the whole report the mod can send to Lab43. Scroll through it with the mouse wheel or Page Up and Page Down. Type what you were doing in the field below it if you like, then press Send to Lab43, or Don't send. Either way, the mod doesn't offer that crash again. Nothing is sent unless you press Send to Lab43.

In the reportNever in it
Minecraft's crash report, with the error and where it happenedYour Minecraft name and player id, your sign-in tokens
The versions of the mod, Minecraft, Fabric and Java, your system and graphics cardThe names of your worlds and servers, IP addresses
The mod's settings (Display…, filters) and the errors it caughtYour plan's contents, the names of your plans and files
The last 200 lines about the mod from Minecraft's log, and your noteYour email address, folder paths with your user name

Reports go to auth.lab43.dev, Lab43's account site, and are deleted after 90 days. More: Privacy: crash reports.

Still stuck?

Minecraft crashed? Send the report from J → Crash report: see above. For anything else, Minecraft writes what the mod does to logs/latest.log in your profile folder, in the lines with "MC Planner". Send us that file with a short note of what you did.