Mods / Resonator Tweaks

Description
Files

Tags:: QoL Audio Music Client AI Clientside
Author:: Hark000
Side:
Client
Created:
Jul 3rd at 3:12 AM
Last modified:
Aug 8th at 3:51 AM
Downloads:
153: Latest release (for Vintage Story 1.22.1 - 1.22.6, potentially outdated):
ResonatorTweaks1.2.1.zip 1-click install

Resonator Tweaks

A lightweight, client-side fix-up for the resonator.

The resonator is a lovely block with a few frustrating habits: its disc is tied to the Music volume slider, so it goes silent if you play with music off; only one can be heard at a time; and it plays through once and stops. This mod fixes all of that, and lets you tune each resonator individually.

It is client-side only. There is nothing to install on a server, nothing for an admin to approve, and no requirement that anyone else runs it. Drop it in your own Mods folder and it works — singleplayer, someone else's server, anywhere.

What's in it

Plays with Music turned off. The disc is routed through the Sound effects volume instead of the Music volume, so you can keep game music off and still hear your records.

Several resonators at once. Vanilla only ever plays one disc at a time — start a second and the first goes quiet, and it stays quiet. Every resonator now has its own audio and they no longer fight over it.

Per-resonator settings. Look at a resonator and press F to open a small panel:

Setting	What it does
Volume	How loud this particular resonator is
Falloff radius	How far away it can be heard, in blocks. Volume fades to nothing at the edge
Loop	Repeat the disc instead of stopping at the end

Changes apply live as you drag the sliders, and are saved per world on your own machine. Breaking a resonator forgets its settings, so a new one placed there starts fresh.

Discs resume on their own. Walk back into the area, or rejoin the world, and a resonator with a disc in it picks up again without being touched.

No more volume blast. Vanilla briefly plays a starting disc at full volume with no distance falloff, audible from a very long way off. It now fades in properly from the first moment.

Pairs with Resonator Overhaul. If that mod is installed, this one detects it on startup and stands down completely, so the two are safe to keep side by side.

Settings

The values in ModConfig/resonatortweaks.json, created automatically on first launch, are the defaults for any resonator you have not given its own settings with the F panel.

Option	Default	What it does
`PlayWithMusicOff`	`true`	Use the Sound effects volume. Set `false` for vanilla behaviour (Music volume)
`Volume`	`1`	Default loudness, 0–1
`MaxDistanceBlocks`	`25`	Default audible radius. Vanilla is about 25
`Loop`	`false`	Whether new resonators loop by default
`GlitchPitch`	`true`	Let temporal storms bend the playback pitch, as vanilla does
`MaxAllowedDistanceBlocks`	`64`	Upper limit of the in-game radius slider

Per-resonator settings live separately in ModConfig/resonatortweaks-resonators.json, filed by world. You should not need to edit that one by hand.

The F key is rebindable in the normal controls menu, under Edit resonator settings.

A note on multiplayer

Because this mod is client-side, everything it does is local to you. Your volume, radius and looping choices change what you hear; another player with the mod hears their own settings, and a player without it hears vanilla.

That is usually exactly what you want on a public server — no permissions to hand out, no arguments about how loud someone's jukebox is. If you'd rather resonator settings were shared, saved to the world and the same for everybody, use Resonator Overhaul instead. It does the same job server-side.

Updating and uninstalling

Updating is drop-in. New options are added to your existing ModConfig/resonatortweaks.json automatically on the next launch, and your current values are kept. If you ever want a clean slate, delete that file and restart — it regenerates with defaults.

One thing to know if you are updating to 1.2.0 from an earlier version: the Loop option never actually worked before. If you had it set to true, your discs will start looping now — that is the fix landing, not a new setting.

Uninstalling is clean. Remove the mod and resonators go back to vanilla behaviour. Nothing is written to the world save; the two files in ModConfig are the only trace, and they can be deleted whenever you like.

The mod is required on the client only — servers need nothing.

Created with AI assistance.

Feedback, bug reports and suggestions are always welcome.

Copyright (c) 2026 High Tech Games. All rights reserved.This mod is made available under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License (CC BY-NC-ND 4.0). You may download, play, and share this mod for personal use. You may not alter, transform, build upon, or commercially exploit this work without explicit permission.Modifications & Collaborative Use:If you would like to modify this code, use assets from this mod, or continue updating it for newer versions of Vintage Story, please contact me directly. I am open to granting Creative Commons Attribution-NonCommercial-ShareAlike (CC BY-NC-SA) permissions on a case-by-case basis.

Mod Version	Mod Identifier	For Game version	Downloads	Released	Changelog	Download	1-click mod install*
1.2.1	resonatortweaks	1.22.1 - 1.22.6	66	Aug 8th at 3:51 AM	Show	ResonatorTweaks1.2.1.zip	1-click install
1.2.1 Fixed: Resonator discs now properly fade out ambient/biome music while playing instead of playing over it. Added: New `DuckAmbientMusic` setting, enabled by default. Turn it off if you want ambient music to continue playing underneath resonators. Tested: Verified with Vintage Story 1.22.6. No known conflicts.
1.2.0	resonatortweaks	1.22.3 - 1.22.4	37	Jul 22nd at 4:52 AM	Show	ResonatorTweaks1.2.0.zip	1-click install
## 1.2.0 The playback engine has been rebuilt on the one from Resonator Overhaul, which fixes a stack of long-standing problems, and per-resonator settings have been added. - Several resonators can now play at once. Previously only one could — starting a second disc silently killed the first, and it stayed dead until its chunk reloaded. The game's music system only has room for one track at a time, so discs no longer go through it at all; each resonator now owns its own audio. - No more volume blast when a disc starts. For a moment at the start of playback the disc played at full volume with no distance falloff, audible hundreds of blocks away. - Looping actually works. The `Loop` setting had never had any effect — it was applied at a point where there was nothing yet to apply it to. - Discs resume on their own. Walk back into a chunk, or rejoin a world, and a resonator with a disc in it starts playing again without being touched. - Discs no longer stop for no reason. A background sync could cut playback short even with the disc still in the resonator. - New: per-resonator settings. Look at a resonator and press F to set its volume, falloff radius and looping, with the sliders applying live as you drag. Saved per world on your own machine, in `ModConfig/resonatortweaks-resonators.json`. Breaking a resonator clears its settings, so a new one placed there starts fresh. - The values in `ModConfig/resonatortweaks.json` are now the defaults used by any resonator you have not given its own settings. Your existing config file keeps working as-is; one new option, `MaxAllowedDistanceBlocks` (64), caps how far the in-game radius slider can go. - Also fixed: the mod could end up doing nothing at all after leaving a world and rejoining without closing the game, until it was fully restarted. Note on multiplayer: these settings are client-side, so they change what you hear. Other players hear their own.
1.1.0			35	Jul 3rd at 4:41 AM	Show	ResonatorTweaks.zip
ResonatorTweaks v1.1.0 — Auto-detects and auto-stands-down if Resonator Overhaul is present.
1.0.0			15	Jul 3rd at 3:14 AM	Show	ResonatorTweaks.zip
A simple, lightweight client-side mod that lets the Resonator play as an ambient sound effect, even with music turned off. Includes a small configuration file that lets you: Enable or disable the sound. Adjust the volume. Change the sound falloff range. Choose whether it loops continuously. Lightweight and still undergoing testing.

1 Comment (oldest first | newest first) (threaded | flat)

ManaWei, Aug 13th at 5:33 AM

If it's only client side at least flag it as such and not as "Both"