Please Consider Donating - Every Dollar Counts
Runic Instruments turns instrument play into a configurable support and battlefield system for the Runecraft modpack. Open an instrument, choose from the resonances you have unlocked, and keep playing to project buffs, debuffs, and optional mod-specific effects around the musician.
Highlights
- 90 resonance patterns across 15 instrument families
- Four tiers of progression: Apprentice → Journeyman → Master → Legendary
- Server-synced resonance selector and unlock state
- Ally, hostile, self, and world-targeted effects with per-effect targeting
- Craftable passive runes that extend range, duration, amplifier, and linger time
- Loot-generated Song Scrolls that unlock gated resonances
- Optional integrations for Ars Nouveau, Blood Magic, Nature's Aura, MineColonies, AttributesLib, and Iron's Spells 'n Spellbooks
- Ensemble, weather, and biome bonuses for group performances
How it works
- Open a supported instrument.
- Pick an unlocked resonance from the overlay.
- Play notes to keep the resonance active; effects linger briefly when you stop.
- Higher tiers require unlocks — currently via Song Scroll loot or operator commands; in-game progression triggers are on the 1.0 roadmap.
Survival progression
- Rune items are crafted with vanilla ingredients.
- Filled Song Scrolls can appear in dungeon, mineshaft, desert pyramid, jungle temple, stronghold library, and End City treasure loot.
- Gated resonances are unlocked through advancement progress or Song Scroll use.
Requirements
- Minecraft 1.20.1
- Forge 47.3+
- Genshin Instruments 5.0+
- Optional tested companions: Even More Instruments 6.1.4, Ars Nouveau 4.12.7, Blood Magic 3.3.5, Nature's Aura 39.4, MineColonies 1.20.1-1.1.1203-snapshot, Curios 5.14.1, Patchouli 85, AttributesLib 1.3.7, Iron's Spells 'n Spellbooks 1.20.1-3.15.4
Known limitations in 0.9.0
- Resonance selector buttons currently render as letter-in-color tiles; icon assets ship on disk but are not yet blitted by the widget.
- Item textures are simple placeholders; commissioned art is planned.
- Advancement criteria are placeholders (
minecraft:impossible), so Song Scrolls and operator commands are the primary unlock paths.
- MineColonies
colony_morale currently applies Regeneration as a stand-in for the full happiness API.
Feedback
Bug reports and feature requests welcome via the repository's issue tracker.
