Clangor

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 (Ogg Vorbis - Opus is NOT supported)
  • 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.

• Punchy! Compat Collection
• Punchy! Compatibility

License

All Rights Reserved (ARR)

• 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.