• The mod drives what ATLYSS already has, the world clock and the rain, rather than adding a clock or weather of its own. That is why players without the mod still see the host's day, night and rain.
• Seasonal colors tint each map's own colors instead of replacing them, so every map keeps its identity.
• Colors are applied with material property blocks, so the game's shared materials are never changed, and switching the mod off puts everything back.
• Snow is the mod's own round flakes. While it snows, the game's rain is simply stopped; its files are never touched.
• Four small Harmony patches, and nothing else is patched: the weather roll, clicks on the panel, keys typed into the panel, and, only on a dedicated server, /seasons typed into the server console.

• On from the start: the seasons themselves, tree and ground colors, the day cycle, fog, mist, falling leaves in autumn and spring, cave fireflies and fairies, rays of sunlight, ground souls on autumn nights, winter snow and shimmers, Catacombs dust, wind gusts, the blossom garden and scenery props.
• The clock and rain start as the game has them, with two gentle changes: days run a little longer in spring and summer and nights longer in autumn and winter, and it rains more in spring and less in summer. Set the per-season day and night lengths (World/Time/Weather > Time > Advanced) to 1 for the game's own clock.
• Off until you turn them on: Heat Wave, Heavy Snow, Embers, Soul Lights (spring nights), Bare Trees, Summer Sheds Leaves, Winter Sheds Leaves, Wild Leaf Colors, Freeze Water In Winter and Seasonal Water Colors.
• Your settings are kept through updates. A new version only moves a setting that is still on an old default.

• ATLYSS already shares the world clock and the rain with every player, which is how players without the mod see the host's day, night and rain.
• Players with the mod receive the host's season, tint strength, map lists, fog, mist and holiday look, and its placed light shafts if the host shares them. Settings the host controls are greyed out in their panel.
• Placed shafts are limited to three per map by default (Most Shafts Per Map), since they are put into the world by hand and anyone opped for the look can place them.
• My Own Season lets a player pick their own season without changing anyone else's. My Own Look Settings keeps their own colors, fog and mist. Both are under Start here in the settings menu.
• Each tree is picked by where it stands, so every player sees the same trees in blossom, turning, or bare.
• When the map you stand in gets no seasons, the panel says why under the clock, and whether that is the host's setting or yours.
• The host's state is compressed, so it fits well within CodeTalker's size limit even with co-hosts. /seasons resync, or the Resync button in the panel, asks the host for everything straight away.

• A look carries the colors, the effects, the fog and mist, the day cycle's shape and the places you have set. It does not carry your keys, your window, anything that decides how hard your machine works, or who may share with you.
• Accept Shared Looks is the switch; off refuses every offer silently. Blocked From Sharing blocks one person, and Wait Between Offers stops anyone asking twice in a row.
• While hosting, Send My Look Live keeps players on your look as you change it, and Host Offer Wait is the shorter wait that uses.
• Take The Host's Look Without Asking is off by default: following the host is already how this mod works, and a look is a large change to make without seeing it first.
• Places travel with a look only if you let them. Share My Regions decides whether yours go out and Take Regions From Shared Looks whether somebody's arrive. Under the first is a list of your places, each reading Shared or Kept back, so you can send some and hold the rest; a Share All Of Them button puts every one back to shared.
• A place that arrives is merged, not swapped in: a place they sent is added or updated and every other place of yours is left alone.
• Take The Host's Regions decides whether the host's list is used while you follow them, which is the same answer My Own Look Settings gives for the rest of the look.
• Loading a preset names which of your own places it is about to write over before you press again.

• How they change: Season Advance decides. Real Minutes (the default) moves on every real week, Game Days after a number of in-game days, Real Date follows the calendar (with Southern Hemisphere for December summers), and Manual waits for you. /seasons set, /seasons next and the Current Season buttons change it straight away.
• Season order can be changed, to skip or repeat a season. A holiday pauses the season while it runs rather than banking the time.
• The world clock is saved by the host, so after a restart the world picks up at the same hour and the same point in the season.
• Trees in ATLYSS are one mesh, trunk and leaves together, so colors are kept soft: a bright color would land on the bark as well. Foliage Tint Strength (0.78) leaves a little of the game's own color showing, and the canopy keeps its texture.
• Ground and grass are tinted toward each season's ground color. Winter's snow is a color, not snow piling up.
• Rain and snow: in winter the game's rain becomes snow (Snow Replaces Rain). Snow density, size, speed, area and drift can all be tuned.
• Places with their own look keep it: Red Woud, Tuul Enclave, the cherry blossom garden and any area you mark yourself. Falling leaves take the color of the canopy they came off, whatever decided it.
• Under a roof the snow and rain stop around you, and the rain's sound drops. The mod looks up for a ceiling, and inside places such as the Catacombs and Crescent Keep it also takes a small picture straight up to find ceilings the game cannot see. /seasons diag roof shows what it found.
• Excluded maps keep their normal look entirely. Maps added by MapLoader get no seasons unless Affect Other Maps (Experimental) is on, and even then no fog or mist unless Fog And Mist On Other Maps is on too. Time cannot be excluded: ATLYSS has one clock for the whole world.

• Dawn From Hour and Dawn To Hour set when the morning ramp runs, and Dusk From Hour and Dusk To Hour the evening one. They ship at half six to half twelve and half one to half eight, so there is an hour of flat daylight between them.
• Night Dimming is how much darker the painted surfaces go at the depth of night. At zero nothing dims and the cycle does nothing.
• The blend is stepped rather than smooth, so a whole dusk costs a handful of repaints instead of one a frame. No single step moves the world by more than one shade.
• Color Fade Seconds is for a color with no clock to follow — rain starting and stopping being the one that has none. Zero is the hard change it was before.
• Day Cycle is the switch, in case it costs you frames, and Low Spec Mode turns it off whatever the switch says.

• Per place and per season: the place's own color, its canopy, bark, vine, snow and accent colors, how bright it is by day and after dark, how long its fog lasts, how much rain changes its light, and how far past its own edge the look reaches.
• Night Starts From Daytime Lighting is the only way to keep somewhere readable after dark, because a multiplier on an already-dark color cannot brighten it. Tuul Enclave's autumn ships with it on.
• A Region, Not A Whole Map stops a region's row claiming a custom map that happens to share its name.
• Also Apply To Map lends one place's look to maps that have no row of their own, by name, several at a time.
• Place Color Strength is how far canopies shift toward a place's color rather than the season's. 1 carries it exactly.
• Global Region Padding is one reach for every region; a place can give its own instead, which beats it. A region that wants none can say zero.
• Water, fog and mist all have per-region lists of their own, and a themed region can keep its look in as many seasons as you like.
• A place that came with the mod cannot be removed, since it would come back on the next update; anything you added can be.

• Spring: petals falling from trees, fairies in caves, and soul lights on spring nights (off by default). Luvora Garden's cherry blossom stays in bloom all year.
• Summer: fireflies in caves, rays of sunlight, embers (off by default), and heat haze (off by default, with Heat Wave At Night to keep it after dark).
• Autumn: falling leaves, and ground souls at night. Ground Souls Style picks how they look: rising wisps, soul fire, a purple mist, all three, or (the default) a different one each night, the same night for every player. Soul Mist Chance and Whole Soul Mist Nights decide how much of the ground mist takes the souls' colors.
• Winter: snow, a far layer of snow, snow on the ground, glints in the snow, and blizzards when winter is foggy. Heavy Snow is off by default.
• Any season: dust in the Catacombs, wind gusts that push everything together, and Effects In Every Season (Experimental) to see any effect all year round.
• Every effect has density, size, area and particle life settings, and a list of maps it appears in.
• Never In lists stop an effect you already have from appearing somewhere. Cave fireflies, fairies, soul lights, embers, heat haze, ground souls, winter shimmers and dust each have one, alongside the god rays list that always had one. Nothing new is added to the world by them; they only hold things back.
• Spring and summer shed leaves of their own now, alongside autumn's, each with their own switch.
• Rays of sunlight stop while it rains, because sunlight through a downpour reads wrong — with a list of places that keep theirs anyway.

• Bare Tree Percent is how many trees in a hundred go bare, and Bare Tree Seasons which seasons they do it in. Trunks, a blossom garden's wood and anything a place has claimed are left alone.
• Bark is left vanilla everywhere unless a place asks for it. The game marks some objects as wood, which finds a trunk no keyword names, and Bark By Ground Type uses it.
• Vines can be colored apart from the trunks beside them, which is the only way to color one without the other. What counts as a vine is a keyword list, with a list of materials held out of it.
• Wild Leaf Colors spreads every canopy as wide as it goes in one press, and a place can ask for it on its own instead.
• Disco Trees, on the Experimental tab, steps the canopies through twelve colors, with Disco Trees Seconds for how long each is held.
• Scenery Tint Strength is lower than the ground's on purpose: a statue tinted as hard as the grass stops reading as stone. Scenery Never In keeps a place out of it.
• Each season also has its own light color, blank by default so the season's own palette decides.

• Fog and mist have a chance per season, a separate chance at night, a color per season, and settings for density, size, how far they reach, how thick the layer is, and how long each piece lasts.
• Hold Fog When Standing Still keeps the fog you stand in from churning.
• Places can have fog and mist of their own: Red Woud is foggy every autumn day, and its mist rolls in there by day while mist elsewhere waits for the night. A row for a place can say day or night for its mist, and the panel writes each row out as it understood it, so a bar in the wrong place is visible rather than silently ignored.
• While hosting, your fog and mist settings are sent to players by default, so everyone sees the same fog on the same days.
• Fog, mist, soul mist and heat haze are drawn in a fixed order, so where they overlap the colors do not flash as you move.

• Seasonal Water Colors gives each season its own, and Water Per Region sets one for a named place and season, which beats the seasonal color there.
• Rows Color Their Own Places decides whether a place's own palette row colors its water too, or only the Water Per Region list does.
• Freeze Water In Winter replaces the surface with ice. Ice solidity, the frost tile size, the ice color and a list of maps never to freeze are all settings, and the ice borrows a shader that is known to light correctly here rather than guessing at one.
• Water is found by the game's own ground marking rather than by name, so a library floor cannot be mistaken for a lake.

• Every new shaft takes the width, length, lean, tilt, sides, brightness, opacity and color set above the list, and whether it is a box, whether it shows at night and whether it leans the way you are facing.
• Most Shafts Per Map (3) limits how many a map may hold, since anyone opped for the look can place one. Zero means no limit.
• Shafts Cast Light adds a real light at the shaft rather than only the beam.
• /seasons ray add <name> [at <player>], ray list, ray remove and ray clear do the same from the chat box.

• The calendar is one setting, Holiday Calendar, written as Name|MM-DD|Season|days before|special, separated by semicolons. Anything in the last field gives that holiday a look of its own on the day.
• The panel shows, for each holiday, when its season starts and the day its look shows.
• Holiday Look Now (in the panel, or /seasons holiday now and /seasons holiday off) shows Halloween's look today, whatever season it is, without touching the calendar. It is not saved, and Spring Cleaning puts it away.
• The host's holidays are everyone's: a date changed on the host moves the holiday for every player.
• The tree color, the souls' colors, their size, how many there are and how thick and how see-through the fog is can all be changed. Souls come in blue, purple, green and orange on the day, larger and denser than on an ordinary night, and they keep whichever Ground Souls Style you have chosen. The ground mist keeps its own colors unless Holiday Mist Colors is switched on.

• The panel and the settings menu change the same settings, so they always agree.
• Search matches a setting's name, the page it is on and its description. Color and color, and grey and gray, find the same things. The setting you pick is lit up for a moment.
• An old or new look, an accent color, a size and a scale can all be chosen under the Panel tab. The accent can follow the season, so the panel changes with the year. The corner grip resizes the window and the title bar drags it.
• Every color row opens a color wheel in a window of its own, which can be dragged off the panel.
• Opening the panel takes the mouse and holds the camera still, the way the game's own menus do, and holding the right mouse button hands the camera back while you look around. Both have a switch under the Panel tab: if another mod's interface will not open while the panel is up, turn one off, and /seasons diag has a panel holds line saying exactly what the panel is doing.
• While a text box in the panel has the keyboard, typing does not move your character and Enter does not open chat. Click off the panel or press Escape to give the keyboard back.
• Enabled, at the top of Seasonal Settings > General, switches the whole mod off and on, and the panel key keeps working while it is off.
• Spring Cleaning, under Performance, puts groups of settings back to how they shipped, with an undo.

/season works too. Commands that change the world are the host's; an opped player's go to the host, who checks their permissions. On a dedicated server, type the same commands into the server console.

• /seasons status, /seasons diag, /seasons diag near, /seasons diag roof, /seasons diag perf, /seasons diag perf reset
• /seasons report, /seasons report <what happened>
• /seasons set <spring|summer|autumn|winter>, /seasons next
• /seasons length <30m|12h|7d|2w>, /seasons advance <manual|realminutes|gamedays|realdate>
• /seasons holiday, /seasons holiday now, /seasons holiday off
• /seasons day, /seasons night
• /seasons time <day|night|freeze|resume>, /seasons time <1-12> <am|pm>
• /seasons time mode <vanilla|host|frozen>, /seasons time daylength <seconds>, /seasons time nightlength <seconds>, /seasons time scale <season> <day|night> <0.25-4>
• /seasons weather <on|off|vanilla>
• /seasons tint <0-1>, /seasons preset <vanilla|extended|realtime|custom>
• /seasons ray add <name> [at <player>], /seasons ray list, /seasons ray remove <name>, /seasons ray clear
• /seasons zone ... marks an area with a color of its own, and /seasons boundary ... keeps the seasons out of one
• /seasons op list|add|remove|powers|universal|on|off|servers, /seasons op copy <server name>
• /seasons cohost <player>
• /seasons requests, /seasons approve <number|all>, /seasons deny <number|all>
• /seasons config <Key> [value], /seasons config find <words>
• /seasons snow <never|winter|always>, /seasons test <snow|rain|leaves|off>, /seasons fog <on|off|auto> (your own, not the host's)
• /seasons resync, /seasons resetstate, /seasons debug, /seasons help

• Permissions come in four parts: season, weather, time and look. Every op gets the universal permissions unless given their own.
• An op's changes wait in their panel until they press Send, and arrive as one request under Host Settings > Requests. Changes That Need Approval and Op Request Cooldown decide what waits and how often they can ask.
• Ops are picked in the panel under Host Settings > Ops, or with /seasons op add <player> and /seasons cohost <player>.
• One ops list serves every server you host, so the same world hosted from the menu and as a dedicated server keeps its ops. With Ops Lists Per Server on, each server name keeps its own list instead; a new name starts with the ops you already had, and /seasons op servers and /seasons op copy <server name> bring back another server's list.

• The world clock and season are saved and picked up again after a restart, including a restart the server does by itself.
• Ops are kept in the config, one list for every server name unless Ops Lists Per Server is on.
• Requests from ops show in the console: answer them with /seasons approve <number> or /seasons deny <number>.
• /seasons diag on a server prints what a server can know: the season, the clock, the weather, ops and what was last sent to players.

• Spread Heavy Work Over Frames (off) colors a newly entered area a bit each frame instead of all at once. Turn it on if entering an area stutters. Work Per Frame is how much of a frame that may take: higher finishes sooner and takes bigger frames doing it.
• Ambient Max Particles (3000) is the one budget every effect shares.
• Colors are only worked out again when something actually changes.
• The host sends its state when something changes, when a map loads, and every 15 seconds, and sends nothing while nobody else is connected.
• A headless server skips every visual.

• The report window has undo and redo, find and replace, word wrap, line numbers, text size, a fixed width font, the date and time (F5) and a template. It can add where you are and what diag saw.
• /seasons report <what happened> saves one straight away.
• Reports are saved in two places, so an update of the mod cannot lose them:

BepInEx/plugins/<the mod's folder>/Bug Reports/
BepInEx/AtlyssSeasons Bug Reports (backup)/

BepInEx/config/<the mod's GUID>.cfg                 every setting
BepInEx/config/AtlyssSeasons/worldstate.json        the saved season and clock
BepInEx/config/AtlyssSeasons/ops-by-server.json     each server's last ops list

• /seasons resetstate clears the saved season and clock.
• /seasons config <Key> [value] reads or changes any setting by its config name, and /seasons config find <words> finds one.