![CLANGOR - FORGE YOUR BLADE'S VOICE](https://cdn.modrinth.com/data/cached_images/d621446c6f5342d7c346e37b20a0cb600e076f6e_0.webp) # 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 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

v2.0

v1.0

# Usage

Quick Start (Recommended)

- Pairs with the **[Clangor: Dungeons Soundpack](https://modrinth.com/resourcepack/clangor-dungeons-soundpack) v2.0**—just apply it for a ready-to-use experience. - Requirements: - Fabric: - [Fabric API](https://modrinth.com/mod/fabric-api) *(Required)* - [YetAnotherConfigLib (YACL)](https://modrinth.com/mod/yacl) *(Required)* - [Mod Menu](https://modrinth.com/mod/modmenu) *(Optional)* - Forge / NeoForge: - [YetAnotherConfigLib (YACL)](https://modrinth.com/mod/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](https://discord.gg/wzT9qTgShJ). - 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. ![Better Combat weapon swing sound volume config](https://cdn.modrinth.com/data/cached_images/d1434dc6968706327975b61bb649587b94eb3876.png)

Great Combos

- **Sound in Space** - [Sound Physics Remastered](https://modrinth.com/mod/sound-physics-remastered) by henkelmax - [Sound Physics Perfected](https://modrinth.com/mod/sound-physics-perfected) by RedLifedev - **Sound in Motion** - Punchy! Series - [Punchy!](https://modrinth.com/mod/punchy-fpa) by PunchyDevGuy - [Untitled Punchies](https://modrinth.com/resourcepack/untitled-punchies) by _seoluvs.u - [Hyper Punchy](https://modrinth.com/resourcepack/hyper-punchy) by HamzaDev - [Silly Punchies!](https://modrinth.com/resourcepack/silly-punchies) by craftandoof - [Modded Swords x Punchy! Compatibility](https://modrinth.com/resourcepack/punchy!-compatibility) by arwonll - [Modded Swords x Punchy! v2](https://modrinth.com/resourcepack/modded-swords-x-punchy!-v2) by arwonll - HMI Series - [Hold My Items](https://modrinth.com/mod/hold-my-items) by Tree Corp - [HOLD MY ACTIONS!](https://modrinth.com/resourcepack/hmi-hold-my-actions!) by ZAIFIX - [Beash's Swing Animations](https://modrinth.com/resourcepack/hmi-beashs-swing-animations) by Beash - [Bow's animation](https://modrinth.com/resourcepack/bowsaninations) by KREKER_BUBA

# Credits

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

- [Punchy! Compat Collection](https://modrinth.com/collection/GypBAs4y) - [Punchy! Compatibility](https://punchymod.com/compat)

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

BD0518