Quiet Crafting — sound menu for Sun Haven

Silence crafting-table sawing and manage individual sounds in game. Open chat, enter /sounds, and submit to open the sound menu.

The initial mute list is WoodcuttingTable2; ElvenCraftingTable1. The basic table's clip was identified in a player runtime log; the elven clip was verified in the installed game assets.

0.4.2 is an early test release. Build, behavior, game API, and compiled volume-hook checks pass. The latest font-cache fix still needs in-game confirmation.

Install or upgrade

1. Close the game and select your Sun Haven profile in r2modman or Thunderstore Mod Manager.
2. Find QuietCrafting in the mod browser and install it. The declared BepInExPack by BepInEx dependency is installed by the manager.
3. Click Start modded, load your character, and enter /sounds in chat.

For a local ZIP, use Settings → Install local mod and select QuietCrafting-0.4.2.zip. Reuse the existing local package's author when upgrading it. When moving from a local test build to the published package, keep only one installed copy of QuietCrafting; keep the existing configuration file.

/sounds replaces the old /soundlog command. Existing mute settings are kept. On the first upgrade from the original 0.1.0 preset, the unchanged preset migrates to the corrected table sounds; customized and intentionally empty lists remain unchanged.

The ZIP follows the manager's documented local installation and package structure. Use Install local mod, rather than profile import.

For a manual installation into an existing BepInEx setup, extract only plugins/QuietCrafting/QuietCrafting.dll into BepInEx/plugins/QuietCrafting/.

Sound menu

The menu uses a game-style layout: upright icon tabs extend above a gold/red window frame, with a centered title, corner close button, and one inset parchment page. Original pixel-art borders and icons complement Sun Haven's loaded button, scrollbar, and Gurajada font assets. Shared game assets are resolved at runtime and are not redistributed. Native borders are scaled for the overlay canvas rather than enlarged with the game's world-sprite scale.

Six full sound rows emphasize large outlined clip names beside timestamps. Toolbar icons, scrollbar arrows, and an explicit global-state indicator provide controls without extra technical subtext. Enabled toggles use the game's pressed button frame when loaded; otherwise they keep the normal frame. Captions and icons move with the native face when pressed. Dark timestamps, search text, and footer labels use a plain material without inherited outlines or stroke dilation. The menu owns its dynamic font textures and materials so glyph additions cannot overwrite the game's font atlas, or be overwritten by it. Opening the menu writes a Sound menu text: summary to LogOutput.log; a healthy summary reports zero empty meshes.

Sound log

Shows the latest 200 playback requests, including repeated and muted clips, newest first. Each row emphasizes the exact clip name alongside its capture time. Technical playback details remain available in optional file logging.

• Mute / Unmute: change that clip's current mute preference immediately. All rows representing the same clip share one preference.
• Search: filter the list by part of a sound's name.
• Pause log / Resume log: freeze the displayed snapshot while collection continues in the background.
• Clear: empty the recent log. This does not remove saved sounds or mutes.
• Copy list: copy the filtered list, including complete names, to the clipboard.

Live controls update active audio sources managed by the patched playback helpers, as well as future playback. Unmuting does not replay a sound that has already finished. Muting matches exact clip names, without regard to case; every use of that clip through the supported paths shares the setting.

Saved sounds

Shows every currently muted sound and previously muted sounds you have kept. This list and its mute preferences survive game restarts in the mod's config.

• Mute / Unmute: toggle the sound without removing it from the saved list.
• Remove: unmute and forget the sound. It stays absent after a restart. Muting it again from the Sound log tab adds it back.
• Search and Copy list work on this tab too.

The Global Enable toggle applies all selected mutes when on and bypasses them when off, preserving your selections. Its helper text shows the current ON / OFF state. Changes save automatically; the sound menu does not need a separate Apply button.

Close with X or Esc. The menu holds the local character's input and blocks clicks behind its backdrop. The world and crafting continue running. The command is handled locally, is not broadcast to other players, and does not enable cheats.

Configuration and optional file logging

After one launch, the selected profile contains:

BepInEx/config/local.sunhaven.quietcrafting.cfg

Example settings:

[General]
Enabled = true

[Sounds]
MutedClips = WoodcuttingTable2; ElvenCraftingTable1
SavedClips = WoodcuttingTable2; ElvenCraftingTable1

[Diagnostics]
LogSounds = false

MutedClips holds active mute selections; SavedClips also remembers sounds you unmuted. Entries use semicolons, exact clip names, and no file extensions or wildcards. The menu updates both settings for you. The internal DefaultsRevision setting controls one-time preset migration.

For external edits, close the game, use r2modman's Config editor or a text editor, and restart. Changes made through an optional in-game BepInEx ConfigurationManager update playback immediately.

/sounds works with LogSounds = false. If enabled, file logging writes each unique clip name once per session to BepInEx/LogOutput.log:

[Sound] Clip="WoodcuttingTable2" Muted=True Via=PlayOneShot

The recent log is held only in memory. Saved names and mute selections persist. These are playback requests, not microphone recordings; requests can include distant or otherwise inaudible sounds. sound-names.txt is a reference list from inspected assets and an observed runtime log, not a complete list of every possible playback path.

Test checklist

1. Check LogOutput.log for Ready: patched 4/4 audio methods, Live volume control ready, and Sound menu ready: /sounds, with no plugin errors.
2. Craft at the basic table and confirm the sawing is muted. In /sounds, use Unmute while it is playing, then Mute, and check both changes apply.
3. On Saved sounds, unmute a clip and confirm it stays listed. Remove it and confirm it disappears. Mute it from Sound log and confirm it returns.
4. Restart and check that muted, unmuted, and removed entries retain their states.
5. Check normal chat, search typing, tab switching, scrolling, pause, clear, copying, closing with X/Esc, and movement after closing. Return to the title screen and reload the save, then open the menu again.
6. Confirm music, footsteps, tools, and FinishCrafting2 remain normal unless specifically selected. If available, test an elven table and an ambient loop.
7. Check the gold frame, upright tab icons, selected-tab height, six full rows, scrollbar arrows, and readable outlined text. Verify Global Enable updates its check/minus icon, indicator, and ON/OFF help without losing saved mutes.

Scope and removal

The plugin patches Sun Haven's managed audio helpers and their volume writes. Direct Unity AudioSource calls and music playback through other paths may not be covered. It preserves the game's object creation, cleanup, and intended volume values, and updates tracked active sources when preferences change.

Settings affect the local player's audio. The mod does not edit saves, recipes, items, or world time. Disable/uninstall it in the manager to remove its effect; saves do not depend on the plugin.

Build from source

Install a .NET SDK and build using your own game installation:

.\scripts\Build-Package.ps1 -GameDirectory 'D:\SteamLibrary\steamapps\common\Sun Haven'

The first restore uses NuGet.org and BepInEx's NuGet feed. Output is dist/QuietCrafting-0.4.2.zip and a SHA-256 checksum. Only the mod DLL and its documentation are packaged. Unity, game, BepInEx, and Harmony libraries are not redistributed; BepInExPack supplies the loader and Harmony.

With a .NET 10 SDK, run the state and command behavior checks:

dotnet run --project tests/QuietCrafting.Checks -c Release

scripts/Test-GameApi.ps1 reads the game's metadata with Mono.Cecil from the local NuGet cache (or -CecilDll <path>). scripts/Test-VolumeTranspiler.ps1 checks the compiled instruction transform without invoking Unity native audio. See docs/DEVELOPMENT.md for the implementation and validation boundary.

1.0.0

• First 1.0 release, with the sound menu, instant mute/unmute controls, saved sounds, and crafting-table mute defaults from 0.4.2.
• Add a shorter, cheerful README with quick setup and the essentials.
• Retain the isolated font atlases and text-legibility fixes.

0.4.2

• Fully isolate the menu's dynamic font atlas textures and base material. A shallow FontAsset copy retained the game's writable textures but separate packing data, allowing later glyph additions to overwrite existing letters.
• Reset TMP's cached primary atlas reference, verify private ownership, and preload printable menu/clip-name characters before the first canvas draw.
• Release all private font atlas pages, including pages added dynamically.
• Ignore the search input's intentional zero-width sentinel in text diagnostics.

0.4.1

• Give dark timestamps, search text, empty-state messages, and footer labels a private plain material, explicitly clearing inherited outline, face dilation, and shadow/glow effects that made their letters merge together.
• Increase search placeholder contrast while retaining the outlined cream style for headings, tabs, sound names, and buttons.

0.4.0

• Rebuild the menu around the approved mockup: upright icon tabs above a shared gold/red frame, centered title, corner close button, and an inset parchment page.
• Add original pixel-art frame and icon primitives, outlined cream labels, a search icon, and toolbar icons. No game artwork is redistributed.
• Correct native sprite border scaling for the overlay canvas, removing the oversized borders and distorted control shapes.
• Fit larger labels using a private copy of the game font's measured English glyph metrics, preserving the shared font and atlas.
• Show six full sound rows with large clip names, timestamps, alternating paper shading, and aligned mute/unmute and saved-sound removal controls.
• Add scrollbar arrow controls, a global-state indicator, and dedicated footer help while retaining the existing logging, persistence, and audio behavior.
• Move button captions and icons with native pressed faces, including action buttons as well as persistent toggles. Release generated art with the menu.
• In-game visual verification of the rebuilt menu remains pending.

0.3.4

• Enclose the count, toolbar, sound list, global toggle, help, and status in an inset page frame beneath the tabs, with consistent internal padding.
• Move toggle captions down with the native pressed face, including held clicks and persistent enabled states.
• Lower the Global Enable caption slightly more for a better visual fit.

0.3.3

• Raise all button captions to center them on the visible face above the shadow.
• Use the native pressed sprite for enabled mute, pause, and global toggles when that artwork is loaded; retain the normal frame when unavailable.
• Rename the master toggle to Global Enable with ON / OFF help explaining how it applies or bypasses saved sound mutes.
• Give the two pages dedicated native tab frames, a raised active tab, an active edge, and a divider above the page content.

0.3.2

• Enlarge clip names and give them the full row height, with timestamps in a separate narrow column. Remove technical playback details from menu rows.
• Use the saved tab's extra space for clip names without a redundant subline.
• Enlarge and vertically center control captions, improve search text sizing, and fit the title and subtitle on one header row.

0.3.1

• Fit compact text labels to the game's font metrics and replace fixed-size ellipsis clipping that could discard the entire first line.
• Give both toggle/tab states the same native button frame, with a subtle tint change instead of switching between a rounded frame and a flat rectangle.
• Log a text-mesh check when opening the menu to help verify rendered labels.

0.3.0

• Rename the chat command to /sounds and replace the window with a native Unity sound menu using the game's loaded panel, tab, button, scrollbar, and font assets.
• Add immediate Mute / Unmute controls to every recent sound row.
• Add Saved sounds for current and previous mutes, persisted across restarts.
• Add Remove to unmute and forget a saved sound until it is muted again from the log.
• Apply changes to active managed audio sources while retaining intended volume for unmuting; cover the recurring writes for persistent ambience.
• Add a master muting bypass and preserve search, pause, clear, and copying.
• Recycle visible UI rows and capture click targets before live rows shift.
• Preserve previous mute settings and seed saved sounds on upgrade.
• New native menu and active playback changes await in-game verification.

0.2.0

• Change the default to WoodcuttingTable2; ElvenCraftingTable1 after a runtime log identified the basic crafting-table sound.
• Automatically migrate the unchanged 0.1.0 preset; preserve custom and empty blacklists.
• Add local /soundlog chat command and a draggable recent-sounds window.
• Keep the latest 200 playback requests in memory, including repeated and muted clips, independently of file logging.
• Add name filtering, pause-list, clear, clipboard export, and close controls.
• Hold local character input while the window is open; release only the mod's own input key on close or destruction.
• Remove harmless Harmony field-lookup warnings during startup.
• New window and mute preset await in-game verification.

0.1.0

• Initial local test build for Windows Sun Haven and BepInEx 5.
• Default blacklist for the identified CraftingTable1 and ElvenCraftingTable1 clips.
• Exact, case-insensitive, semicolon-separated custom sound blacklist.
• Optional logging of sound names, once per name per session.
• Audio dispatch patch that runs on Unity's main thread for positional sounds.
• In-game verification pending.