-
Notifications
You must be signed in to change notification settings - Fork 1
World Enter Pregen
Your single-player world pre-generates itself before you start playing it.
When you open a world, Chunksmith freezes it, generates terrain out to 4096 blocks behind a progress screen, and hands it to you when it is done -- or the moment you ask for it, whichever comes first.
The point is that the world stops moving while you wait. Nothing ages, nothing wanders off, nothing starves, and no night passes. You come back to the world you left.
Mod only, single-player only, MC 26+ (Fabric and NeoForge). A dedicated server has no world-entry moment and nobody to show a screen to, so this does not apply there -- see Plugin vs mod. Older Minecraft versions cannot freeze the world the same way and are not covered yet.
A screen with the world behind it, showing:
- a bar filling towards your configured radius,
- the percentage and the number of chunks generated so far,
- an estimate of the time remaining, in plain language, which settles as it learns the real rate,
- and an Enter World Now button.
Press it and you are in the world immediately. Generation keeps running in the background, and from that moment it yields to you -- the throttle's player reserve is handed back, so you get the server and the pregen gets what is left. You can play while it finishes.
Closing the screen with Escape does exactly the same thing. There is deliberately no way to close it and be left standing in a frozen world.
A world that finishes never does this again. The completed run is recorded next to the world data, and loading that world afterwards takes you straight in.
Three cases, so nothing is surprising:
| What you did | What happens next time |
|---|---|
| Let it finish | Straight into the world. It will not run again. |
| Pressed Enter World Now part-way | It continues where it stopped. Leaving early records nothing. |
Raised worldEnterPregenRadius
|
It runs again, for the part you have not generated yet. |
If you ever want a finished world to run it again, delete worldenter-done.json from the
chunksmith folder inside that world's save.
Both live in config/chunksmith/config.json, and both can be set with /cs set.
| Setting | Default | What it does |
|---|---|---|
worldEnterPregen |
true |
On or off. Off means worlds open the way they always did. |
worldEnterPregenRadius |
4096 |
How far out to generate, in blocks. 128 - 32768. |
Why 4096 by default. It matches what Distant Horizons and voxy draw straight out of the box, so the view you get is the view those renderers can actually show you. A smaller radius finishes sooner and shows you less.
Roughly 205,000 chunks live inside a 4096-block circle, so the first run on a fresh world is not quick. That is what the button is for.
Freezing does not make it faster. It is a little slower than generating with the world running. Freezing is there so the world does not move while you wait, not to speed anything up.
It works in a world made without cheats. The settings it needs are changed directly rather than through the command interpreter, so you do not need to enable cheats to use it.
A crash mid-run is safe. Everything it borrows -- the freeze, the time setting, the throttle values -- is written down before it is touched. If the game dies while the world is frozen, the next start reads that record, puts your settings back exactly as they were, and carries on. Your own values come back, not Minecraft's defaults: if you had time advancement turned off on purpose, it stays off.
It does not touch your write backpressure. While the world is frozen Chunksmith raises how much
work it may do per tick, but deliberately leaves throttleMaxQueuedWrites alone. Maxing that out
makes the save at the end of the run block long enough to trip the server watchdog.
/cs set worldEnterPregen false
Or set "worldEnterPregen": false in config/chunksmith/config.json.
To keep it but make it shorter:
/cs set worldEnterPregenRadius 1024
You do not need this feature to pre-generate a world -- it is the ordinary
/cs start run, done for you at the moment it is most useful. If you would rather drive
it yourself, turn worldEnterPregen off and see How to.