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.

Drop in unique swing sounds for every weapon or tool.

Bypassing global resource pack limits, drop in unique hit sounds for every weapon, tool, or empty hand.

Drop in unique use sounds for drawing bows, charging tridents, and more.

Drop in unique swap sounds for switching weapons or tools.

Easily override the default audio under the following vanilla sound events:

• item.armor.equip_generic
• item.crossbow.hit
• item.crossbow.loading_start
• item.crossbow.loading_middle
• item.crossbow.loading_end
• item.crossbow.quick_charge_1
• item.crossbow.quick_charge_2
• item.crossbow.quick_charge_3
• item.crossbow.shoot
• item.mace.smash_air
• item.mace.smash_ground
• item.mace.smash_ground_heavy
• item.shield.block
• item.spear_wood.attack
• item.spear_wood.hit
• item.spear_wood.use
• item.spear.attack
• item.spear.hit
• item.spear.use
• item.trident.hit
• item.trident.hit_ground
• item.trident.throw
• item.trident.thunder
• item.trident.return
• item.trident.riptide_1
• item.trident.riptide_2
• item.trident.riptide_3
• entity.arrow.hit
• entity.arrow.shoot
• entity.arrow.hit_player
• entity.experience_orb.pickup
• entity.item.pickup
• entity.player.levelup

Showcase

Usage

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

• 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

• 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

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

• 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

• Punchy! Compat Collection
• Punchy! Compatibility

License

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

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