Configuration

Change the settings in The Last Sun configuration file.

Updated 2026-11-14

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.

Caution

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.