Repository navigation
Getting Started
Download the Solo Mining file for your Minecraft version and loader (see Supported versions) and put it into the mods folder of your client – and of your server, if you play on one. You also need GeckoLib for your version, and on Fabric Fabric API.
Warning
Gates do not work on Peaceful. Monsters cannot exist there, so the mod refuses to build a gate and tells you to change the difficulty. Use Easy or higher.
You have three ways to get a gate:
| Way | How |
|---|---|
| Wait | A gate opens on its own somewhere 18–42 blocks away from you, every 25–45 minutes of play time. You get a message with the coordinates. |
 Gate Catalyst
|
Right-click to summon a gate right next to you. Buy it in the Hunter Shop for 8 Gate Fragments. |
| Command |
/solomining spawn (operators only). |
Lost track of a gate? Use the 
Gate Tracker or /solomining ping. A marker on your screen points to the nearest gate.
Caution
An unused gate expires after 15 minutes. It explodes and a wave of monsters pours out. Enter it in time, or stay away.
The rank (E, D, C, B, A, S, S+, S*) is shown when the gate appears. It is calculated from your current gear: better armor and weapons mean a harder gate with better rewards. See Gates and Ranks.
Walk into the purple gate surface and stand still for 3 seconds. You arrive in the waiting room:
-
Ready Pedestal – right-click when you are ready. The run starts when everyone is ready, or automatically after 90 seconds. -
Hunter Shop with the trader – buy supplies before you go. -
Exit Gate (turquoise) – back to your world.
You also receive a 
Dungeon Exit Crystal. Right-click it inside the gate to leave at any time (it is taken back when you leave).
Important
Read the messages in the waiting room. They tell you the gate type, the death mode and whether it is a Red Gate. A Red Gate does not let you out once the run has started.
The valley is built while you wait (progress in the action bar). Then you are teleported in. Kill every monster in the combat zones; the info box at the top shows how many are left and how much time you have. When the last one falls, darkness falls too, and the boss appears.
Defeat the boss and a reward chest appears, with an Exit Gate right next to it.
Back home, trade your currencies at the Hunter Shop (it is in every waiting room) and watch your Hunter Rank grow with /solomining stats.