Configuration

Configuration

Season System creates its config files in the config folder of your game or server on the first start.

File	Purpose
config/seasonsystem.properties	Main config: calendar, weather, events, temperature, crops, snow, nature, visuals, notifications
config/seasonsystem-crops.json	Crop profiles, see [[Crop Profiles
config/seasonsystem-client.properties	Position and visibility of the HUD (client only)
config/seasonsystem-update.json	Update checker

General notes

• Open the files with any text editor.
• Changes are applied after a restart, or right away with /season reloadconfig (see Commands).
• Chances from 0.0 to 1.0 are fractions: 0.25 means 25 percent. Options ending in _chance with a range of 0 to 100 are percent values.
• Times are in ticks. 20 ticks are one second.
• Radius values are in blocks around each player.
• Values outside the allowed range are clamped to the nearest allowed value. Invalid values fall back to the default.
• Options marked (client) only change what you see and hear on your own game. Each player sets them in their own seasonsystem.properties. All other options are decided by the server.

seasonsystem.properties

Calendar

Option	Default	Allowed	Description
days_per_season	28	1 to 365	Length of one season in Minecraft days. Changing it on an existing world moves the current date.
calendar_time_source	world_age	world_age, day_cycle	world_age counts the days the server actually ran; sleeping and /time do not skip days. day_cycle follows the day/night cycle, so sleeping and /time also advance the calendar. See [[Seasons and Calendar

Weather

Option	Default	Allowed	Description
season_weather_enabled	true		The season picks the weather once per day. false keeps vanilla weather.
spring_rain_chance	0.45	0.0 to 1.0	Chance for a rainy day in spring
spring_thunder_chance	0.08	0.0 to 1.0	Chance that a rainy spring day becomes a thunderstorm
summer_rain_chance	0.10	0.0 to 1.0	Chance for a rainy day in summer
summer_thunder_chance	0.04	0.0 to 1.0	Chance that a rainy summer day becomes a thunderstorm
summer_max_rain_days	3	0 to 365	Maximum rainy days per summer. After that, the rest of the summer stays dry.
autumn_rain_chance	0.30	0.0 to 1.0	Chance for a rainy day in autumn
autumn_thunder_chance	0.05	0.0 to 1.0	Chance that a rainy autumn day becomes a thunderstorm
winter_snow_chance	0.55	0.0 to 1.0	Chance for snowfall on a winter day

Weather events

There is at most one event per day. Each season has two events; the first is rolled first, the second only if the first did not happen. See Weather and Events.

Option	Default	Allowed	Description
seasonal_weather_events_enabled	true		Turns weather events on or off
bloom_day_event_chance	0.16	0.0 to 1.0	Spring, first roll: Bloom Day
spring_rain_event_chance	0.20	0.0 to 1.0	Spring, second roll: Spring Rain
heat_wave_event_chance	0.16	0.0 to 1.0	Summer, first roll: Heat Wave
dry_day_event_chance	0.18	0.0 to 1.0	Summer, second roll: Dry Day
harvest_day_event_chance	0.16	0.0 to 1.0	Autumn, first roll: Harvest Day
windy_day_event_chance	0.18	0.0 to 1.0	Autumn, second roll: Windy Day
frost_night_event_chance	0.18	0.0 to 1.0	Winter, first roll: Frost Night
snowstorm_event_chance	0.20	0.0 to 1.0	Winter, second roll: Snowstorm
weather_events_affect_temperature	true		Events raise or lower the temperature
weather_events_affect_crop_growth	true		Events speed up or slow down crop growth

Temperature

See Temperature for how the temperature is calculated.

Option	Default	Allowed	Description
temperature_system_enabled	true		Main switch. false means no temperature effects on players and no temperature influence on crops.
spring_min_temperature_c	6	-40 to 60	Lowest spring temperature in °C
spring_max_temperature_c	18	-40 to 60	Highest spring temperature in °C
summer_min_temperature_c	20	-40 to 70	Lowest summer temperature in °C
summer_max_temperature_c	34	-40 to 70	Highest summer temperature in °C
autumn_min_temperature_c	5	-40 to 60	Lowest autumn temperature in °C
autumn_max_temperature_c	17	-40 to 60	Highest autumn temperature in °C
winter_min_temperature_c	-12	-60 to 40	Lowest winter temperature in °C
winter_max_temperature_c	2	-60 to 40	Highest winter temperature in °C
temperature_effects_enabled	true		Players get effects when it is too cold or too hot
winter_temperature_debuffs_enabled	true		Cold effects (Slowness, Mining Fatigue) in winter
summer_temperature_debuffs_enabled	true		Heat effects (Weakness, Mining Fatigue) in summer. Deep caves are always spared.
cold_effect_temperature_c	0	-60 to 30	At or below this felt temperature: Slowness
severe_cold_temperature_c	-8	-60 to 30	At or below this felt temperature: Slowness II and Mining Fatigue
heat_effect_temperature_c	33	0 to 80	At or above this felt temperature: Weakness
severe_heat_temperature_c	39	0 to 80	At or above this felt temperature: Weakness and Mining Fatigue
temperature_effect_interval_ticks	80	20 to 1200	How often the player temperature is checked
temperature_effect_duration_ticks	140	40 to 1200	How long the effects last after a check. Keep it higher than the interval, otherwise the effects flicker.
temperature_affect_crop_growth	true		Very cold or hot days slow crops down, mild days (12 to 25 °C) speed them up a little
temperature_damage_enabled	false		Not used at the moment. Changing it has no effect.

Crops

See Crops and Farming.

Option	Default	Allowed	Description
crop_rules_enabled	true		Seasonal crop rules. false means crops grow like in vanilla all year.
spring_crop_growth_multiplier	1.25	0.0 to 10.0	Growth speed in spring. 1.0 is vanilla speed, 0.0 stops growth. Crops in their best season grow a bit faster on top.
summer_wet_crop_growth_multiplier	0.85	0.0 to 10.0	Growth speed in summer on wet farmland. Crops on dry farmland do not grow in summer.
summer_minimum_moisture	5	0 to 7	How wet farmland must be in summer. 7 is fully wet, 0 turns the check off.
summer_dry_crops_can_wither	false		Crops on dry farmland in summer can lose growth stages
summer_dry_crop_wither_chance	4	0 to 100	Chance in percent that a dry crop loses a stage when it is checked
autumn_crop_growth_multiplier	0.65	0.0 to 10.0	Growth speed in autumn
winter_crop_growth_multiplier	0.0	0.0 to 10.0	Growth speed in winter. At 0.0 only crops made for winter still grow.
crop_tick_attempts_per_player	80	0 to 512	Random blocks checked for crops around each player per pass (spring/autumn bonus and summer withering). Higher values act faster but cost more server time. 0 turns these checks off.

Snow and ice

See Snow, Ice and Nature.

Option	Default	Allowed	Description
winter_environment_enabled	true		Snow layers and ice in winter, melting in the other seasons. false means the world is not changed.
winter_environment_tick_interval	20	5 to 1200	How often snow placement and melting run, in ticks. Values below 20 behave like 20.
winter_environment_radius	28	2 to 96	Radius around a player where snow can be placed. The crop checks use it too (up to 32).
winter_snow_attempts_per_player	90	1 to 512	Snow placement tries per pass and player. Higher values cover the ground faster.
winter_freeze_water	true		Open water freezes to ice in winter. Water under a roof is left alone.
winter_melt_radius	48	4 to 96	Radius around a player where snow and ice melt after winter. Values below 8 behave like 8.
winter_melt_attempts_per_player	48	1 to 512	Melt tries per pass and player. Only 8 to 96 are used; summer melts four times as fast.
winter_client_snow_enabled	false		(client) Extra snow particles around you while it snows. Vanilla snowfall is shown either way.
winter_client_snow_particles_per_tick	55	1 to 300	(client) Number of extra snow particles per tick
winter_client_snow_radius	24	4 to 96	(client) Radius for the extra snow particles

Plants and ground cover

Option	Default	Allowed	Description
spring_regrowth_enabled	true		In spring, grass and a few flowers grow back on grass blocks around players
spring_regrowth_radius	40	4 to 160	Radius. Values above 40 behave like 40.
spring_regrowth_attempts_per_player	4	0 to 128	Tries per pass and player. Values above 4 behave like 4.
spring_regrowth_flower_chance	4	0 to 100	Chance in percent that a flower grows instead of grass
summer_flower_decay_enabled	true		In summer, small flowers around players slowly dry out and disappear
summer_flower_decay_radius	40	4 to 160	Radius
summer_flower_decay_attempts_per_player	6	0 to 128	Tries per pass and player
summer_flower_decay_chance	20	0 to 100	Chance in percent for each try
autumn_leaf_litter_enabled	true		In autumn, leaf litter appears on the ground around players. Only on Minecraft versions that have leaf litter.
autumn_leaf_litter_radius	36	4 to 160	Radius
autumn_leaf_litter_attempts_per_player	10	0 to 256	Tries per pass and player
autumn_leaf_litter_chance	35	0 to 100	Chance in percent for each try
autumn_grass_decay_enabled	true		In autumn, short grass, tall grass and ferns around players slowly die off
autumn_grass_decay_radius	36	4 to 160	Radius
autumn_grass_decay_attempts_per_player	4	0 to 128	Tries per pass and player
autumn_grass_decay_chance	25	0 to 100	Chance in percent for each try

Visuals and sounds (client)

Option	Default	Allowed	Description
season_color_tint_enabled	true		Grass and leaves change colour with the season
mild_world_ambience_enabled	true		Grass and leaves get a light extra tint while a weather event is active
season_ambience_particles_enabled	true		Small seasonal particles around you
ambience_particles_per_tick	2	0 to 64	Particles per tick. Values above 3 behave like 3.
season_ambience_sounds_enabled	true		Quiet seasonal sounds now and then, for example birds in spring or bees in summer
ambience_sound_interval_ticks	450	100 to 12000	Rough pause between two ambience sounds
weather_events_boost_ambience	true		More particles and sounds while a weather event is active

Notifications (client)

Option	Default	Description
season_change_notifications_enabled	true	Message when a new season starts
weather_event_notifications_enabled	true	Message when a weather event starts
daily_summary_notifications_enabled	true	Short line above the hotbar at the start of each day with season, day and temperature
season_forecast_enabled	true	At the moment this only changes the Forecast line in the Season Journal

Other

Option	Default	Description
debug_commands_enabled	false	Enables /season debugsnow for testing snow placement. Leave this off on normal servers.

Client config

config/seasonsystem-client.properties stores the HUD. You normally do not need to edit it by hand, because the HUD tab in the Season Journal (key K) changes it for you.

Option	Default	Description
hud_x	8	Distance of the HUD from the left edge of the screen in pixels
hud_y	8	Distance of the HUD from the top edge of the screen in pixels
hud_visible	true	Show the HUD. false hides it.

Update checker

config/seasonsystem-update.json controls the update check. When a newer version of Season System is available, players get a chat message with a link to the project page.

Option	Default	Description
enableUpdateChecker	true	Turns the update check on or off
checkDelayTicks	200	Wait time after the world or server has started before checking (200 ticks = 10 seconds)
connectTimeoutMillis	2500	How long to wait for the connection, in milliseconds
readTimeoutMillis	4000	How long to wait for the answer, in milliseconds
notifyOnlyOncePerRun	true	Show the message only once per server start

Performance tips for big servers

Season System spreads its world work over time, so more players do not cause big lag spikes. If you still need to save server time:

• Lower winter_snow_attempts_per_player and winter_melt_attempts_per_player.
• Raise winter_environment_tick_interval.
• Lower crop_tick_attempts_per_player.
• Lower the radius and attempt values of the plant features, or turn them off.
• Raise temperature_effect_interval_ticks (and temperature_effect_duration_ticks with it).