Torii Tracks for Valheim

Torii Tracks is an immersive BepInEx mod for Valheim designed for builders and content creators who want complete atmospheric control over their bases. It replaces messy text tags with true per-sign data storage, zero-stutter preloaded custom soundtracks, dynamic raid warning horns, and a Valheim-Esque configuration UI.

✨ Key Features

• True Per-Sign Data Storage: Say goodbye to text tags like [r:35]. Sign radiuses and assigned songs are saved directly to the sign's persistent ZDO data, keeping your boards clean for writing and fully synchronized in multiplayer.
• Interactive Sign Configuration (LeftAlt + E): Look at any sign you own and press LeftAlt + E to open the custom configuration window. Adjust the radius with a slider or precise text input, and select a dedicated soundtrack from a scrollable list.
• Zero-Stutter Audio Preloading: All custom audio files (.wav, .mp3, .ogg) are preloaded into memory on startup, ensuring instant, lag-free transitions and zero frame stutters when entering your base.
• Custom Raid Warning & Music: Triggers a custom war horn sound effect and brief delay when a raid starts, followed by a dedicated or randomized battle soundtrack.
• Cinematic Biome Popups: Base name banners fade in smoothly, perfectly timed to sync with your audio transitions (appearing 3/4 of the way through your fade-in effect).
• Valheim-Esque UI Theme: Beautiful dark leathery brown panels, charcoal backdrops, warm gold headers, and clean readability inspired by classic Valheim design and community configuration managers.
• Fully Configurable: Adjust entry delays, fade times (defaulting to a soft 5.0 seconds), UI scales, screen offsets, and popup cooldowns directly through your BepInEx configuration file.

📂 Folder Structure

When installed, the mod automatically generates the following folder structure in your BepInEx plugins directory:

BepInEx/plugins/ToriiTracks/
├── ToriiTracks.dll
├── BaseMusic/       (.wav, .mp3, .ogg files for base background music)
├── Sounds/          (.wav, .mp3, .ogg files for raid war horns)
└── RaidMusic/       (.wav, .mp3, .ogg files for active raid tracks)

Torii Tracks — Full Version History & Changelog

Version 0.10.22 (Stable Release / Reversion)

• Performance Stabilization: Fully removed experimental portal tweaks, volume hooks, and associated audio logic to completely eliminate performance stuttering and clean up configuration menus.
• Core Feature Set Maintained: Retains robust base music streaming, distance-scaled raid war horns, raid music playback, and per-sign configuration.

Version 0.10.25 – 0.10.41 (Portal Tweaks Era — Experimental)

• Portal Volume Control: Experimented with scaling vanilla portal ambient hums via configuration sliders and prefab patches (ZNetScene.Awake).
• Custom Portal Audio: Added custom takeoff and landing sound effect triggers (TakeOff.mp3 and Landing.mp3).
• Runtime Enforcers: Tested component-based volume enforcers to counter Valheim's internal prefab reloading loops. (Note: Later deprecated due to performance overhead and audio persistence issues).

Version 0.10.16 – 0.10.24 (Raid & Audio Polish)

• Distance-Scaled Raid War Horns: Implemented custom war horn audio triggers for raids featuring distance-based volume falloff and temporary pre-raid pauses.
• Dynamic Raid Music: Added dedicated soundtrack playback during active raids with smooth transitions back to base audio upon completion.
• Sleep Integration: Configured smooth audio fade-out and restoration sequences during in-game sleep cycles.
• Master Volume Sync: Added real-time tracking for game master volume adjustments.

Version 0.10.1 – 0.10.15 (Initial Release)

• Base Music Streaming: Introduced dynamic zone-based background music playback scanning local BaseMusic folders with smooth entry and exit fade transitions.
• Per-Sign Customization: Implemented a Valheim-themed configuration UI (accessed via LeftAlt + E while hovering over a sign) to customize individual base radii and assign specific tracks using ZDO persistence.