## [0.2.6-dev.8] - 2026-08-21

### Changed
- The mod now runs on every Vintage Story 1.22.x release, starting at 1.22.0. Earlier development builds declared 1.22.5 or newer without a technical reason and were refused by older game builds before any code ran.

## [0.2.6-dev.7] - 2026-08-21

### Fixed
- Some sounds could lose their muffling forever after another sound ended on the same audio channel. The mod now checks that a finished sound still owns its channel before cleaning up.
- Stereo sounds (music, resonator tracks) can no longer lose stereo permanently after a fast sequence of loads. A failed load no longer leaves the flat mono version behind.
- Rain and thunder from the replacement system and the vanilla system can no longer play at the same time after you turn weather enhancement off and on between sessions.
- In multiplayer, the server now ignores resonator and boombox messages from players who are not near the device, arrive too fast, or carry a malformed track name.
- Two openings close together (one above the other) now keep their own identity instead of fighting over one voice.
- When there are more openings than voices, the nearest opening wins the free slot first — not the oldest one.
- The Layer 1 rain bed now fills in when an opening qualified for a voice but had no slot left, so wide cave mouths no longer go quiet.
- Leafless rain no longer adds extra volume on top of leafy rain in dense forests.
- Thunder cracks indoors no longer fight with the rumble over one filter.
- A disc taken out of a resonator no longer reloads at an old frozen rotation.
- Frozen resonator rotations no longer leak into a new world at the same coordinates.

### Changed
- Max Rain Sources default went from 4 to 8. This value also decides how many openings get tracked each tick; 4 starved cave mouths. Existing configs keep an edited value.
- Removed the dead "Opening Persistence" setting. It did nothing since persistence moved to the virtualization model.

### Performance
- Reverb raycasts, path records, and block-change invalidation allocate far less, so mining and fighting cause less stutter.
- Turning OFF sound repositioning no longer silently turns OFF positional reverb with it.
- The player reverb cache refreshes after a block change even when you stand still.

## [0.2.6-dev.6] - 2026-08-19

### Fixed
- Rain no longer plays from behind solid rock. In a cave, sources placed at openings found earlier from the surface kept playing through the stone above you and buried the one opening you could actually hear. A source that measures inaudible now gives its slot back.
- An opening you can see now wins its slot over one remembered from somewhere else.
- Rain sources sit on an opening, not in the middle between two of them.
- Rain and wind through windows or doors no longer flicker in volume.
- Window and door openings change size smoothly instead of jumping.
- A single block of open sky no longer sounds as loud as the open sky itself.
- Sounds fade in and out more smoothly.
- The carried resonator (boombox) works again with Carry On 2.0. Older Carry On versions still work as before.
- Fixed music staying at an old position after a failed pickup.
- Rain and wind now fade in gently when first detected, instead of jumping straight to full volume.
- Quiet sounds change smoothly instead of jumping suddenly.
- Less stutter when you place or break a block.

### Changed
- Sounds muffle and fade at a more natural speed.
- Sound transitions now match how fast you are moving, such as sprinting or falling.

### Performance
- The mod runs noticeably faster, especially in rain. (20-40% decrease in function ms after Trace)

## [0.2.6-dev.5] - 2026-08-16

### Fixed
- **Rain no longer sounds like metal on a wooden trapdoor.** The rain impact list held the
  pattern `trapdoor`. The mod matches a pattern as a prefix, so the pattern also caught the
  wooden trapdoors and the legacy trapdoors. The list now holds the two metal styles only,
  `trapdoor-plate` and `trapdoor-bars`.
- **`.sp toggle` gives the game back to vanilla audio.** The toggle stopped new work only.
  A sound that already played kept the filter, the reverb, the pitch and the moved position
  of the mod. Rain was the worst case. It stayed at its last level and no longer got quieter
  when you walked inside. The toggle now restores every live sound. It stops the weather and
  thunder sounds of the mod, and it gives the reverb, the weather, the underwater filter and
  the distance attenuation back to the game.
- The toggle also reacts to a change in the ConfigLib window or in the config file. Before,
  it reacted to the chat command only.

### Changed
- **A torch on a torch holder is 20 percent louder.** The default volume of the crackle goes
  from 0.35 to 0.42.
- **One smoothing stage for each thing you hear.** The filter, the reverb and the position of
  a sound move toward their new value in one place, every 25 ms. Before, two steps smoothed
  the same value at rates that changed with the distance, so the real speed matched no
  written number.
- A far sound reacts as fast as a near sound. Its reverb needs the same time. Only the
  measurement is less frequent.
- The filter moves through the loudness in equal steps. A transition no longer runs fast at
  the loud end and slow at the quiet end.

### Performance
- The mod writes the reverb of a sound only while the reverb moves. A sound in a room that
  does not change costs no reverb work.
- The mod does not measure a throttled sound. Its fade continues in the audio step.

### Configuration
- **The mod upgrades an old config file. It does not replace it.** Both config files go to
  version 11. The mod keeps every value you set and changes only what this release changed.
  It replaces the `trapdoor` pattern, and it raises the torch volume to 0.42 if your file
  still holds the old default of 0.35. A value that you edited stays. A file older than
  version 10, or newer than the mod, still falls back to fresh defaults.

### Known limits of the toggle
- The game applies a replaced sound file and an added block ambient sound when it loads the
  assets. The mod silences the added block ambient sounds when you turn it off. A replaced
  sound file stays until you restart the game.
- A sound that the mod mixed down to mono stays mono until the game loads that asset again.
  A new sound loads in stereo, as vanilla does.

### Internal
- `AudioPhysicsSystem.ProcessSoundRaycast` is now `UpdateSoundAcoustics` with
  `ResolveAcousticPaths` and `ResolveRepositioning`. New files: `Core/SmoothingCurves.cs`,
  `Core/ThrottleFadeState.cs`, `Core/AmbientVolumeResolver.cs`, `Core/FilterPipeline.cs`.
- `SoundPhysicsAPI` and the weather system read the occlusion from the applied filter gain,
  so the value includes the airspace, opening and diffraction floors.

Bump Changelog Config

Initial Release for 1.22.x

Backwards Version for 1.21.x 
Might be buggy, no Issue Reporting will be done on this.
Might update later