Rare Pickup Sounds

Rare Pickup Sounds A subtle client-side NeoForge mod that plays configurable sounds when items enter your inventory. Adds a wee bit of excitement to mining — hear a rare chime when you finally grab that diamond or a cursed sfx if you want that unexpected spook.

Features Random custom sounds on pickup - Pulls from rare1.ogg to rare50.ogg Per-item odds - Make nether stars proc 100% while dirt is 1/1000 Whitelist or blacklist mode - Full control, supports item tags like #minecraft:ores Volume + pitch randomization - Each proc sounds unique Hotbar-only mode - Ignore armor/offhand/crafting slots to prevent spam 0.5s cooldown - Picking up a stack of 64 won't deafen you Instant config reload - Change settings in-game, no restart Resource pack friendly - Ships with 6 sounds, override/replace all 50 Mod compatible - Tested with Sinytra Connector with 100+ other mods so it should work with just about anything on Neoforge. Client-side only. Works on vanilla/modded servers without needing it installed server-side.

Installation Install NeoForge for 1.21.1 Drop the jar in your mods folder Launch once to generate configs Optional: Add custom sounds to a resource pack at assets/rarepickupsounds/sounds/rare7.ogg etc. Configuration Access in-game: Mods > Rare Pickup Sounds > Config

Default whitelist: diamond, netherite_ingot, nether_star, dragon_egg

Adding Custom Sounds Create a resource pack Add .ogg files to assets/rarepickupsounds/sounds/rare1.ogg, rare2.ogg, ... up to rare50.ogg The mod auto-detects any file in that range. Missing numbers are skipped safely. No sounds.json editing needed for overrides — just drop files in.

Compatibility Notes Sinytra Connector: Fully compatible. Uses FMLClientSetupEvent to avoid early classloading. Distant Horizons: Tested. No static init conflicts. ItemSwapper / IPN: Uses EventPriority.LOWEST to catch inventory changes after other mods. FAQ Q: Does the server need this mod? A: No. Purely client-side. Works on any server.

Q: Can I make only netherite tools play sounds? A: Yes. The easiest way is to add each item manually: minecraft:netherite_sword, minecraft:netherite_pickaxe, etc.

If your modpack adds tags, you can use #c:tools/netherite instead. To check if a tag exists, install JEI or EMI — press U on the item and check the tags list at the bottom. Vanilla F3+H does not show tags. If the tag doesn't exist, check your logs for Tag not found.

Q: Sounds overlap when I pick up a stack A: Increase cooldown in code or set globalRareChance higher. Current cooldown is 0.5s.

Q: No sounds play even at 100% chance A: Multiple things can cause silent pickups. Check these in order:

1. Whitelist/blacklist mismatch If Use Blacklist Mode = false, only items in Item List trigger sounds. If your list is empty or doesn't contain the item you picked up, nothing plays. Fix: Add minecraft:diamond to Item List or set Use Blacklist Mode = true to allow all items.

2. Item Odds overriding Global Chance If an item is listed in Item Odds like minecraft:diamond:1000, it uses 1/1000 odds even if Global Rare Chance = 1. Fix: Remove the item from Item Odds or set its chance to 1 for 100%. Check logs for Item diamond has specific chance: 1000.

3. Hotbar-Only Mode enabled If Hotbar Only Mode = true, items picked up into armor slots, offhand, or crafting grid are ignored. Fix: Set Hotbar Only Mode = false or only test by picking up into slots 0-35.

4. Sound files missing If no .ogg files exist in assets/rarepickupsounds/sounds/, the mod can't play anything. Fix: Check logs for No .ogg files found! Using fallback sound.. Add rare1.ogg to a resource pack at that path, or verify the mod jar has bundled sounds.

5. Tag not found or empty If you used #c:tools/netherite but the tag doesn't exist in your pack, Item List is effectively empty. Fix: Check logs for Tag c:tools/netherite not found. Use manual item IDs instead, or install JEI to verify tags exist.

6. Cooldown blocking spam There's a 0.5s cooldown. If you pick up 64 diamonds at once, you'll only hear 1-2 sounds, not 64. Fix: This is intended. Drop items 1 by 1 to test.

7. Config didn't reload Rare bug: If you edited the .toml directly while the game was running, changes might not apply. Fix: Use the in-game config screen, or restart Minecraft after editing files.

8. Dimension filter If you set Only In Dimensions to ["minecraft:the_nether"], sounds won't play in the Overworld. Fix: Leave Only In Dimensions empty to allow all dimensions.

Debug tip: Set Global Rare Chance = 1, Item List = ["minecraft:dirt"], pick up dirt. If you still hear nothing, check latest.log for [RarePickupSounds] errors.

Credits Code by reg_the_galah Bundled sounds: from the 1997 AstroRocks 2000 voiced by Nate Trost

License MIT - Feel free to use in modpacks, fork, or learn from the code.