Skip to content

FAQ and Troubleshooting

MKI edited this page Oct 20, 2026 · 2 revisions

FAQ and Troubleshooting

I am stuck inside a gate.

Type /solomining exit. It brings you out of every gate – even if something went wrong and the mod cannot tell which run you belong to. In that case it also writes a detailed line to the log (logs/latest.log, search for "keinem Lauf zugeordnet"); please attach it to a bug report.

The one exception is a running Red Gate: it holds you on purpose. Type /solomining exit twice within 10 seconds to give up (no reward, you cannot return).

I logged out inside a gate. Where am I?

In your world, where you entered the gate. /solomining return takes you back into the run. In a Red Gate you stay inside instead.

No monsters spawn / the gate does not start.

The difficulty is probably Peaceful. Gates need Easy or higher – the mod tells you so when you press the Ready Pedestal.

Gates never appear.

  • Natural gates take 25–45 minutes of play time and only open in the Overworld by default (portalAllowedDimensions).
  • On a busy server without PartyLink, the timer is stretched (naturalPortalPlayersPerPortal).
  • Check that enableNaturalPortalSpawns is true. If a gate plaza is set and full, new gates wait (/solomining plaza info).
  • Use a Gate Catalyst for a gate right now.

The gate is too hard / too easy.

The rank follows your gear (see Gates and Ranks). Server owners can tune monster strength (globalMonsterHealthMultiplier, globalMonsterDamageMultiplier), monster numbers (dungeonMonsterCountMultiplier) and the boss (dungeonBossHealthMultiplier) – see Configuration.

I cannot find the last monsters.

When only a few are left they glow through walls, and an arrow in the action bar points to the nearest one (highlightRemainingMonsters, remainingMonsterPointer).

How do I repair gate gear?

In an anvil with Boss Cores.

Monsters are coming out of a gate in my world.

That is the gate breakout: a gate left alone for half its lifetime lets out up to 4 creatures. Enter it, or set gateLeakMaxMonsters to 0. See Gates and Ranks.

I cannot change my armor.

Armor is locked once a run has started, because the rank was calculated from it. It unlocks when you leave.

I cannot break blocks in the gate.

Gates are protected. Only ore veins and the hatch of the hidden vault can be broken.

The screen does not go dark when the boss appears.

A client mod removes the Warden darkness. Set bossIntroEffect to "blindness".

The server lags when a gate starts.

The valley is built over several ticks. Lower dungeonBuildMillisPerTick for smoother play (longer wait), or lower dungeonMonsterCountMultiplier for fewer entities.

My world folder keeps growing.

Make sure cleanupFinishedInstances and recycleInstanceSlots are true (default). Finished gates are removed 10 minutes after the last player left.

Does it work with …?

See Compatibility and API.

Where do I report bugs?

Open an issue on the project page. Please include the mod version, Minecraft version, loader, whether it was singleplayer or a server, and logs/latest.log.

Clone this wiki locally