Configuration
This page is the reference for server owners who want to edit The Last Sun's settings. The config file is config/thelastsun.json in the Minecraft instance or server folder. The game creates it the first time it loads. It checks the values at startup and fixes values that are outside their allowed range.
Back up the file before editing it. Close the game or stop the server first, then restart it after making changes.
#Apocalypse timing
| Setting | Default | What it controls |
|---|---|---|
randomDisappearance.minDay |
1 | Earliest Minecraft day the Sun can disappear. |
randomDisappearance.maxDay |
2 | Latest Minecraft day the Sun can disappear. |
gracePeriod.durationSeconds |
480 | Grace period length in real-time seconds. |
gracePeriod.debugDurationSeconds |
0 | Optional replacement length when debug mode is on. |
debugMode |
false | Turns on debug options. Leave off for normal play. |
permanentDarkness |
true | Keeps the Overworld dark after the apocalypse begins. |
apocalypse.progressionSpeed |
1.0 | How fast apocalypse days pass. Above 1 is faster; below 1 is slower. |
If the latest disappearance day is set earlier than the earliest day, the game raises it to match the earliest day. Progression speed must be greater than 0.
Setting progressionSpeed above 1.0 speeds up the world's environmental deterioration. This can cause irreversible changes to your world. Use higher values only if you are comfortable with faster progression (or want more of a challenge).
#Climate stages and messages
| Setting | Default | What it controls |
|---|---|---|
apocalypse.day10Threshold |
10 | Day the First Winter begins. |
apocalypse.day20Threshold |
20 | Day the Frozen Surface begins. |
apocalypse.day30Threshold |
30 | Day the Silent World begins. |
apocalypse.day45Threshold |
45 | Day the Deep Freeze begins. |
apocalypse.day60Threshold |
60 | Day the Frozen Earth begins. |
apocalypse.stageAnnouncements |
true | Whether chat announces each new stage. |
apocalypse.warningMessages |
true | Whether survival warnings repeat during the apocalypse. |
apocalypse.warningIntervalTicks |
24000 | Time between warnings, in game ticks. Minimum 200. |
Stage days must stay in order. If you change them, the game adjusts them so each stage starts no earlier than the previous one.
#Environmental changes
These settings control how often the world is checked and how quickly environmental effects happen. A speed of 0 turns that effect off where supported. Bigger speed values make it happen more often.
For the chance settings, think of the number as "1 in N". A value of 4 means roughly a 1 in 4 chance per check, and a value of 1 means it happens almost every check. Lower numbers mean more frequent changes.
| Setting | Default | Allowed values or effect |
|---|---|---|
environment.scanIntervalTicks |
1 | 1–20; how often areas are checked. |
environment.chunksPerScan |
32 | 1–512; chunks checked in a pass. |
environment.blocksPerChunk |
96 | 1–512; columns sampled in each chunk. |
environment.maxMillisPerTick |
6 | 1–30; time budget for environmental work per tick. |
environment.catchUpChunksPerTick |
96 | 1–1024; chunks checked per tick when catching up. |
environment.catchUpBoostSeconds |
30 | 0–600; how long the catch-up boost lasts. |
environment.grassExtraSamplesPerChunk |
24 | 0–256; extra grass samples checked per chunk. |
environment.grassChanceDay10 |
36 | 1 in N chance for grass change from day 10. Minimum 1. |
environment.grassChanceDay20 |
14 | 1 in N chance for grass change from day 20. Minimum 1. |
environment.grassChanceDay30 |
6 | 1 in N chance for grass change from day 30. Minimum 1. |
environment.grassChanceDay45 |
2 | 1 in N chance for grass change from day 45. Minimum 1. |
environment.grassChanceDay60 |
1 | 1 in N chance for grass change from day 60. Minimum 1. |
environment.dirtChanceDay45 |
24 | 1 in N chance for dirt change from day 45. Minimum 1. |
environment.dirtChanceDay60 |
6 | 1 in N chance for dirt change from day 60. Minimum 1. |
environment.grassDeteriorationSpeed |
1.0 | Speed of grass block damage. Minimum 0. |
environment.soilDeteriorationSpeed |
1.0 | Speed of dirt damage. Minimum 0. |
environment.snowAccumulationSpeed |
1.5 | Speed of snow buildup. Minimum 0. |
environment.waterFreezingSpeed |
1.5 | Speed of water freezing. Minimum 0. |
environment.iceLayerProgressionSpeed |
1.3 | Speed of ice thickening. Minimum 0. |
environment.treeDeteriorationSpeed |
1.0 | Speed of tree damage. Minimum 0. |
environment.animalReductionSpeed |
1.0 | Speed of animal loss. Minimum 0. |
environment.snowAccumulation |
true | Turns snow buildup on or off. |
For less server work, reduce the number of chunks checked in each pass. This can make environmental changes take longer. See Environmental Changes.
#Temperature
| Setting | Default | What it controls |
|---|---|---|
temperature.surfaceMultiplier |
1.0 | Strength of the cold on the surface. Minimum 0. |
temperature.undergroundMultiplier |
0.5 | Strength of the cold underground. Minimum 0. |
Set a value to 0 to remove the cold effect for that spot. See Temperature.
#Farming
| Setting | Default | What it controls |
|---|---|---|
agriculture.undergroundOnlyAfterDay0 |
true | Keeps crop growth underground after the apocalypse begins. |
agriculture.minimumLightLevel |
9 | Light needed for underground crops to grow. Range 0–15. |
See Farming and Crops.
#Defaults for new worlds
These settings pick the starting values for new worlds. Changing them does not change a world that has already been created.
| Setting | Default | What it controls |
|---|---|---|
worldSettingsDefaults.ancientCityEnabled |
false | Whether Ancient Cities can generate in new worlds. |
worldSettingsDefaults.wardenEnabled |
false | Whether Sculk Shriekers can summon Wardens in new worlds. |
Existing worlds use their own settings. See World Settings.