Runic Instruments

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.

Status: 0.9.0 pre-release. Core systems are in place and stable; the art pipeline and organic progression triggers are the main items on the 1.0 punch list. See the full CHANGELOG.md in the jar for specifics.

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.