Features

A lightweight audio framework allowing you to drop in custom .ogg files to give every weapon and tool its own signature sounds, down to the specific material.

Swing Sounds: Drop in unique swing sounds for every weapon or tool.
Hit Sounds: Bypassing global resource pack limits, drop in unique hit sounds for every weapon, tool, or empty hand.
Use Sounds: Drop in unique use sounds for drawing bows, charging tridents, and more.
Hotbar Swap Sounds: Drop in unique swap sounds for switching weapons or tools.
Vanilla Sound Replacement: Easily override the default audio under the selected vanilla sound events.

Usage

Quick Start (Recommended)

Pairs with the Clangor: Dungeons Soundpack v2.0—just apply it for a ready-to-use experience.
Requirements:
- Fabric:
  - Fabric API (Required)
  - YetAnotherConfigLib (YACL) (Required)
  - Mod Menu (Optional)
- Forge / NeoForge:
  - YetAnotherConfigLib (YACL) (Required)

Manual Setup

Press F12 (Rebindable) to open the Config Menu:
1. Click Open Folder for the desired item category.
2. Drop in your .ogg files.
3. Press F3 + T to apply.
Press V (Rebindable) to open the Mapping GUI (Advanced):
- Freely assign any item to any item category.
- Create custom item categories.
- Create custom material variants.
Export your setup to a .zip file using the built-in ResourcePack Exporter or /clangor export:
- Apply it to other game instances.
- Share it with your friends.
- Publish it on Modrinth, CurseForge, or our Discord.
Audio Requirements:
- Format: .ogg
- Channels: Mono
- Sample Rate: 44100 or 48000 Hz
- Bitrate: 128 or 192 kbps
- Naming: English-only, no special symbols

Compatibility

For Any Vanilla or Modded Item

Automatically recognizes common, properly named weapons and tools, matching them with preset, material-specific sound categories.
Uncommon or non-standard items can be manually assigned via the Mapping GUI.

Preset Item Categories	Material Variants	Contain
sword	✔	sword, claymore, cutlass, rapier, saber, scimitar, zweihander
axe	✔	axe, guisarme, halberd, khopesh, machete, tomahawk
pickaxe	✔	pickaxe
shovel	✔	shovel
hoe	✔	hoe
empty_hand	✘	air (equal)
rods	✘	stick (equal), bamboo (equal), bone (equal), torch (equal), _torch, _rod
trident	✘	trident
mace	✘	mace, flail, hammer, maul, morgenstern, pernach
spear	✘	spear, ahlspiess, javelin, lance, pike, ranseur
bow	✘	bow
crossbow	✘	crossbow
club	✘	club, cudgel
dagger	✘	dagger, estoc, katzbalger, knife, sai, stabber, stylet, dancers_sword, backhand_blade, nameless_blade, switch_blade
gauntlet	✘	gauntlet, cestus, fist, glove, mauler
glaive	✘	glaive
katana	✘	katana, tachi, uchigatana
scythe	✘	scythe, twinblade
sickle	✘	sickle
staff	✘	staff, jingubang, scepter, sceptre, stave, wand
whip	✘	whip

*Preset Material Variants: general, wooden, stone, copper, iron, gold, diamond, netherite

For Better Combat

Dual-wielding has per-hand sounds.
Better Combat's default weapon swing sounds will overlap with this mod. Toggle them in either config screen as you prefer.

Great Combos

Sound in Space
- Sound Physics Remastered by henkelmax
- Sound Physics Perfected by RedLifedev
Sound in Motion
- Punchy! Series
  - Punchy! by PunchyDevGuy
  - Untitled Punchies by _seoluvs.u
  - Hyper Punchy by HamzaDev
  - Silly Punchies! by craftandoof
  - Modded Swords x Punchy! Compatibility by arwonll
  - Modded Swords x Punchy! v2 by arwonll
- HMI Series
  - Hold My Items by Tree Corp
  - HOLD MY ACTIONS! by ZAIFIX
  - Beash's Swing Animations by Beash
  - Bow's animation by KREKER_BUBA

Credits

Special thanks to Godku for featuring and sharing this mod in the community.

License

Redistribution of the .jar files is not allowed.
Please do not modify, patch, or re-release this mod without my prior consent.

Modpack Policy

Feel free to include this mod in any modpacks on Modrinth or CurseForge.
Please contact me for permission before hosting such modpacks on external platforms.

Clangor