有效乐器
演奏音乐。赋能盟友。或诅咒你的敌人。 Effective Instruments 为 Genshin Instruments 添加了一个魔法光环系统,允许音乐家在表演时为附近的玩家和驯服宠物提供药水效果——或者,如果他们选择负极性变体,则对附近的生物施加减益效果。每种乐器都有其独特的正面 和 进攻性光环——拿起 Windsong Lyre 感受微风加快你的步伐(正面),或召唤呼啸的狂风,减缓并削弱范围内所有的敌人(进攻性)。
1.4.x 新增内容:
- 进攻性(负面)光环 —— 每种乐器都获得了镜像的减益变体(凋零、中毒、缓慢、失明等)。点击红色边框图标即可即时切换极性。
- 乐器耐久度 —— 乐器现在会随着使用而磨损(基于每个乐器的 NBT 耐久度),并且可以在铁砧上修复。每个乐器槽位下方都有原版风格的耐久度条。进攻性光环会加速乐器的磨损。
- 42 种乐器拥有 1 对 1 的独特光环。 每种 GI、EMI(包括所有 16 种音符盒变体)以及 Immersive Melodies 乐器都拥有其独特的正面 + 进攻性配对——共包含 84 种独特光环。
- 默认广泛的进攻性目标范围 —— 负面光环会击中范围内的所有生物,除了音乐家本人、他们自己的宠物以及其他玩家的宠物。管理员可以根据需要切换为细粒度的按类别控制。
- 诊断命令 ——
/effectiveinstruments diagnose 会显示光环管道中的每一个门控状态,从而让“为什么我的光环没有触发?”这个问题有一个命令即可解答的答案。
来自 1.3.0: 可选的 Immersive Melodies 支持!走动并演奏 IM 乐器即可获得更轻量的被动增益——无需屏幕界面。
工作原理
静止层级(Genshin Instruments / Even More Instruments)
- 打开任意一种乐器,来自 Genshin Instruments(或 Even More Instruments)。
- 您乐器的默认正面光环会自动选中。 每种乐器都映射了一个默认光环——无需手动选择。
- 弹奏单个音符,光环立即生效 作用于范围内所有有效的目标。持续演奏时效果会刷新;彩色的音符粒子向外飘散以显示光环的范围。
- 点击右上角的红色边框图标 切换到该乐器的进攻性变体。受影响生物身上的非环境粒子表明减益已生效。
- 停止演奏,光环会在短暂的宽限窗口后停用(可配置,默认为 5 秒)。效果会自然消失。
- 关闭乐器,光环清除。再次打开相同的乐器,它会记住您本次会话的最后一次选择。
移动层级(Immersive Melodies — 可选)
当安装了 Immersive Melodies 并与 Effective Instruments 共存时:
- 手持一种 IM 乐器 并开始一段旋律(自动播放)或使用自由演奏模式。
- 自由走动 —— 每次脉冲(默认:每秒一次)都会对您和附近的盟友应用一个被动光环增益。在光环激活期间,彩色音符会在音乐家周围漂浮。
- 暂停或切换乐器 —— 效果会短暂 linger 然后清除。
- 点击红色边框图标 切换到所持乐器的移动层级进攻性光环。
移动层级的光环故意比静止层级更轻量(单一效果、更短的范围和持续时间)以保持平衡。如果两种层级同时应用于同一玩家,默认情况下静止层级优先。
1.4.3 中加入了自由演奏支持。 打开 IM 界面足以激活光环——无需自动播放。(仅在自动播放 / 实际音符演奏期间扣除耐久度,浏览旋律列表时不扣除。)
乐器光环
每种乐器都附带了其独有的、主题性的光环:
Genshin Instruments
| 乐器 |
光环 |
效果 |
| Windsong Lyre |
Zephyr's Blessing |
速度 I |
| Vintage Lyre |
Echoes of Antiquity |
生命恢复 I |
| Floral Zither |
Bloom Veil |
吸收 I + 饱和度 I |
| Glorious Drum |
Warcry Cadence |
力量 I + 抗性 I |
| Nightwind Horn |
Moonlit Passage |
夜视 + 缓降 |
| Ukulele |
Sunkissed Serenade |
幸运 I |
| Djem Djem Drum |
Rhythm of the Earth |
急迫 I + 跳跃提升 I |
Even More Instruments
| 乐器 |
光环 |
效果 |
| Guitar |
Wanderer's Anthem |
速度 I + 跳跃提升 I |
| Keyboard |
Harmonic Resonance |
生命恢复 I + 急迫 I |
| Koto |
Tranquil Current |
水下呼吸 + 海豚之恩 |
| Pipa |
Silk Road Vigor |
速度 I + 力量 I |
| Saxophone |
Smoky Allure |
村庄英雄 I |
| Shamisen |
Ghost Flame |
防火 + 力量 I |
| Trombone |
Bulwark Fanfare |
抗性 I + 吸收 II |
| Violin |
Heartstring Aria |
生命恢复 I + 吸收 I |
音符盒乐器变体(大鼓、低音、钟琴等)也映射到了主题匹配的光环——请参阅配置文件文件夹中的 _README_INSTRUMENTS.txt 获取完整列表。
Immersive Melodies(移动被动层级)
| IM 乐器 |
被动光环 |
效果 |
| Flute |
Windstep |
Speed I |
| Lute |
Traveler's Hum |
Luck I |
| Piano |
Measured Tempo |
Haste I |
| Vielle |
Hearthsong |
Regeneration I |
| Didgeridoo |
Earthpulse |
Jump Boost I |
| Bagpipe |
Steadfast Drone |
Resistance I |
| Trumpet |
Brass Call |
Strength I |
| Tiny Drum |
March Tap |
Speed I |
| Triangle |
Clear Ping |
Night Vision |
| Handpan |
Stillwater |
Water Breathing |
| Ender Bass |
Shade Resonance |
Fire Resistance |
所有光环均可自由自定义、禁用或删除。通过创建新的 JSON 文件即可添加自定义光环。
完全数据驱动的光环系统
每个光环都由配置文件文件夹中的一个简单 JSON 文件定义:
config/effective_instruments/auras/
首次启动时,模组会生成 84 个默认光环 JSON 文件(31 个静态正面 + 31 个静态攻击 + 11 个移动正面 + 11 个移动攻击)以及一个 _README.txt 参考指南。从那里开始,您可以完全控制:
- 编辑任何默认光环——更改其效果、持续时间、半径、颜色、名称或描述
- 禁用某个光环,只需设置
"enabled": false——它仍保留在磁盘中,但不会在游戏中显示
- 删除默认光环文件——它将不会被重新生成
- 创建新光环,只需将您的
.json 文件添加到该文件夹中
光环 JSON 格式
{
"displayName": "Fire Ward",
"description": "Fire Resistance to nearby allies",
"color": "FF4400",
"enabled": true,
"durationTicks": 200,
"radius": 12,
"sortOrder": 10,
"effects": [
{ "effect": "minecraft:fire_resistance", "amplifier": 0 }
]
}
1.3.0 新增: 两个可选字段用于控制层级支持:
"tiers" — "stationary"、"mobile" 或两者的数组。如果省略,默认为 ["stationary"],因此现有文件无需编辑。
"showInSelector" — true/false。对于静态预设默认为 true,对于仅移动类型默认为 false。
字段说明:
| Field |
Type |
Description |
displayName |
string |
按钮工具提示中显示的名称 |
description |
string |
工具提示描述行 |
color |
string |
十六进制颜色代码(例如 "FF8800")— 用于粒子效果和 UI 高亮 |
enabled |
bool |
此光环是否在选择器中显示 |
durationTicks |
int |
应用效果的持续时间(20 tick = 1 秒) |
radius |
int |
光环范围(以方块为单位)。使用 -1 继承全局服务器默认值 |
sortOrder |
int |
UI 中的按钮排序(数值越小越靠左) |
effects |
array |
要施加的药水效果列表(见下文) |
tiers |
array |
(可选) 哪些层级:["stationary"]、["mobile"] 或两者 |
showInSelector |
bool |
(可选) 在静态选择器 UI 中显示 |
icon |
string |
(可选) 按钮图标纹理的资源位置 |
iconSelected |
string |
(可选) 选中状态图标纹理的资源位置 |
effects 数组中的每一项包含:
"effect" — 药水效果的注册表名称(例如 "minecraft:regeneration"、"minecraft:speed")
"amplifier" — 效果等级减 1(0 = I 级,1 = II 级,以此类推)
如果省略了 icon/iconSelected,按钮将显示显示名称的首字母作为后备方案——因此自定义光环不需要任何纹理工作。
乐器-光环映射
静态映射
文件 config/effective_instruments/instrument_auras.json 控制每种乐器可用的光环以及打开时自动选择的那个。
每个条目支持两种格式:
字符串简写 — 单个光环,默认且唯一选项:
"genshinstrument:windsong_lyre": "zephyrs_blessing"
对象形式 — 默认光环 + 选择器中允许的其他光环:
"genshinstrument:windsong_lyre": {
"default": "zephyrs_blessing",
"allowed": ["zephyrs_blessing", "echoes_of_antiquity", "bloom_veil"]
}
- 如果某种乐器未列出,则显示所有启用的光环(向后兼容)
- 默认光环会自动包含在允许列表中
移动映射(1.3.0 新增)
文件 config/effective_instruments/mobile_instrument_auras.json 将 Immersive Melodies 乐器 ID 映射到移动层级光环预设。每个条目是一个简单的字符串(每个乐器对应一个光环,无选择器):
"immersive_melodies:flute": "windstep_mobile"
使用 /effectiveinstruments reload 命令即可应用对任一映射的更改,无需重启。
命令
| 命令 |
权限 |
描述 |
/effectiveinstruments reload |
OP (level 2) |
重新加载所有光环预设和乐器映射(静态 + 移动) |
/effectiveinstruments status [player] |
OP (level 2) |
显示玩家当前的光环状态(当存在 Immersive Melodies 时显示两个层级) |
/effectiveinstruments durability {get |
set <n> |
repair} |
/effectiveinstruments diagnose |
Everyone |
导出管道状态(为什么我的光环没有触发?) |
/effectiveinstruments reset-mappings |
OP (level 2) |
删除并根据标准的 1 对 1 表重新生成乐器-光环映射 |
/effectiveinstruments help |
Everyone |
打印配置文件位置和命令摘要 |
配置
所有配置文件都位于同一个文件夹下:config/effective_instruments/。
服务器配置 (server.toml)
常规设置:
| 设置 |
默认值 |
描述 |
enabled |
true |
所有光环效果的主开关 |
noteWindowTicks |
100 |
最后一个音符后多少刻钟光环会停用(100 = 5 秒) |
auraTickIntervalTicks |
10 |
光环效果在目标身上刷新的频率(以刻钟计) |
defaultRadius |
16 |
默认光环范围(方块数),当预设的半径为 -1 时使用 |
目标设定:
| 设置 |
默认值 |
描述 |
allowSelfBuff |
true |
音乐家是否能获得自己的光环效果 |
includeOtherPlayers |
true |
范围内的其他玩家是否会受到效果影响 |
includeTamedPets |
true |
范围内的驯服动物是否会受到效果影响 |
petEntityTypeAllowlist |
[] |
额外被视为宠物的实体类型 ID(例如 ["alexsmobs:crow"]) |
移动层级设置(1.3.0 新增):
如果未安装 Immersive Melodies,这些设置将无效。
| 设置 |
默认值 |
描述 |
enabled |
true |
移动层级的主开关 |
pulseIntervalTicks |
20 |
移动效果刷新的频率(以刻钟计,20 = 1 秒) |
lingerTicks |
60 |
玩家停止演奏后效果持续存在的时长(刻钟) |
defaultRadius |
8 |
当 JSON 中的半径为 -1 时的移动光环范围 |
maxTargetsPerTick |
16 |
每次脉冲中每个移动音乐家的最大目标实体数量 |
allowSelfBuff |
true |
音乐家能否获得自己的移动效果 |
includeOtherPlayers |
true |
范围内的其他玩家会受到移动效果 |
includeTamedPets |
false |
驯服宠物会受到移动效果(默认关闭以保持平衡) |
suppressWhenStationaryActive |
true |
当静态层级激活时,会抑制同一玩家的移动效果 |
客户端配置 (client.toml)
| 设置 |
默认值 |
描述 |
showOverlay |
true |
在乐器屏幕上显示光环选择按钮 |
overlayScale |
1.0 |
叠加层按钮的缩放因子(0.5 - 2.0) |
compactMode |
false |
使用紧凑的按钮布局 |
particlesMode |
ALL |
浮动音符粒子:可选 ALL、MINIMAL 或 NONE |
reducedMotion |
false |
减弱粒子漂移和脉冲(无障碍功能) |
screenClassAllowlist |
[] |
来自其他模组的乐器屏幕的完全限定类名,这些屏幕不继承自 Genshin Instruments 的 InstrumentScreen |
视觉效果
当光环激活时,彩色的漂浮音符粒子会在光环效果范围的整个半径内生成。粒子会染上光环配置的颜色——例如 Zephyr's Blessing 的青绿色、Warcry Cadence 的深红色、Moonlit Passage 的紫色等。它们会缓缓上升、飘动、大小脉动并逐渐消失。
粒子渲染完全在客户端进行。如果粒子导致性能问题,可以使用 particlesMode 客户端配置选项来减少或禁用它们。
智能增益处理
- 强者胜出: 如果目标已经拥有来自其他来源(如信标或药水)的同一效果的更强版本,光环不会覆盖它。
- 平滑切换: 切换光环会立即从所有目标身上移除旧光环的效果。模组会精确追踪它对哪些实体应用了哪些效果,并且只移除它自己的效果。
- 清理关闭: 关闭乐器会清除光环并移除跟踪的效果。下次打开乐器时,其默认光环将自动选中。
- 层级优先级: 当静止和移动层级都可能对同一玩家生效时,静止层级获胜并压制移动层级(可配置)。
- 环境效果: 光环施加的效果使用环境标志(细微的漩涡粒子)以区别于药水,并保持视觉杂乱度较低。
- 按乐器记忆: 如果你覆盖了乐器的默认光环,你的选择会在会话期间被记住(登出后遗忘)。
兼容性
- Genshin Instruments(必需)—— 所有乐器界面都会被自动检测
- Even More Instruments(可选)—— 所有 EMI 界面都扩展了 Genshin Instruments 的
InstrumentScreen 并得到自动支持,包括全部 16 种音符盒乐器变体
- Immersive Melodies(可选,1.3.0 新增)—— 启用移动被动层级。不导入 IM 类,无反射,无混入器。当不存在 IM 时,兼容层是一个零成本的空操作
- 其他乐器模组 —— 使用
screenClassAllowlist 客户端配置来添加对不扩展 InstrumentScreen 的模组的界面支持
除非光环提供更强的或相等的版本,否则其他模组的效果(药水效果、信标等)永远不会被移除或覆盖。
要求
- Minecraft 1.20.1
- Forge 47+
- Genshin Instruments 5.0+
- 可选: Even More Instruments 6.0+
- 可选: Immersive Melodies 0.6.0+(启用移动层级)
快速开始
- 与 Genshin Instruments 一起安装该模组。
- 在游戏中打开任何乐器。其独特的光环会自动选中,右上角会出现相应的按钮。
- 开始演奏。附近的盟友将获得增益。
- (可选) 安装 Immersive Melodies。手持 IM 乐器并开始一段旋律——被动增益将自动激活。
- 要自定义光环,请编辑
config/effective_instruments/auras/ 中的 JSON 文件。
- 要更改乐器映射,请编辑
config/effective_instruments/ 中的映射文件。
- 使用
/effectiveinstruments reload 命令在无需重启的情况下应用更改。
Effective Instruments
Play music. Empower allies. Or curse your enemies. Effective Instruments adds a magical aura system to Genshin Instruments, letting musicians grant potion effects to nearby players and tamed pets while they perform — or, if they pick the negative-polarity variant, inflict debuffs on nearby mobs. Every instrument has its own unique positive and offensive aura — pick up a Windsong Lyre and feel the breeze quicken your step (positive) or call down a howling gale that slows and weakens every foe in range (offensive).
New in 1.4.x:
- Offensive (negative) auras — every instrument gets a mirrored debuff variant (Wither, Poison, Slowness, Blindness, etc.). Pick the red-bordered icon to swap polarities on the fly.
- Instrument durability — instruments now wear out with use (per-instrument NBT durability) and can be repaired on an anvil. Vanilla-style durability bar under every instrument slot. Offensive auras wear instruments out faster.
- 1-to-1 unique auras across 42 instruments. Every GI, EMI (including all 16 note-block variants), and Immersive Melodies instrument has its own distinct positive + offensive pair — 84 unique auras shipped.
- Broad offensive targeting by default — negative auras hit every mob in range except the musician, their own pets, and other players' pets. Admins can flip to fine-grained per-category control if preferred.
- Diagnostics command —
/effectiveinstruments diagnose surfaces every gate in the aura pipeline so "why isn't my aura firing?" has a one-command answer.
From 1.3.0: Optional Immersive Melodies support! Walk around playing an IM instrument and receive lighter, passive buffs — no screen needed.
How It Works
Stationary Tier (Genshin Instruments / Even More Instruments)
- Open any instrument from Genshin Instruments (or Even More Instruments).
- Your instrument's default positive aura auto-selects. Each instrument has a default aura mapped to it — no manual selection needed.
- Play a single note and the aura applies immediately to all valid targets in range. Effects refresh as you keep playing; colored music note particles float outward to show the aura's reach.
- Pick the red-bordered icon in the top-right to switch to the instrument's offensive variant. Non-ambient particles on affected mobs show the debuff landed.
- Stop playing and the aura deactivates after a short grace window (configurable, default 5 seconds). Effects naturally expire.
- Close the instrument and the aura clears. Open the same instrument again and it remembers your last selection for that session.
Mobile Tier (Immersive Melodies — optional)
When Immersive Melodies is installed alongside Effective Instruments:
- Hold an IM instrument and start a melody (autoplay) or use free-play mode.
- Walk around freely — a passive aura buff applies to you and nearby allies every pulse (default: once per second). Colored music notes float around the musician while the aura is active.
- Pause or switch instruments — effects linger briefly then clear.
- Pick the red-bordered icon to swap to the mobile-tier offensive aura for the held instrument.
Mobile auras are deliberately lighter than stationary ones (single effect, shorter range and duration) for balance. If both tiers would apply to the same player, the stationary tier takes precedence by default.
Free-play support shipped in 1.4.3. Opening the IM screen is enough to activate the aura — no autoplay required. (Durability is only charged during autoplay / actual note playback, not while browsing the melody list.)
Instrument Auras
Every instrument ships with its own unique, thematic aura:
Genshin Instruments
| Instrument |
Aura |
Effects |
| Windsong Lyre |
Zephyr's Blessing |
Speed I |
| Vintage Lyre |
Echoes of Antiquity |
Regeneration I |
| Floral Zither |
Bloom Veil |
Absorption I + Saturation I |
| Glorious Drum |
Warcry Cadence |
Strength I + Resistance I |
| Nightwind Horn |
Moonlit Passage |
Night Vision + Slow Falling |
| Ukulele |
Sunkissed Serenade |
Luck I |
| Djem Djem Drum |
Rhythm of the Earth |
Haste I + Jump Boost I |
Even More Instruments
| Instrument |
Aura |
Effects |
| Guitar |
Wanderer's Anthem |
Speed I + Jump Boost I |
| Keyboard |
Harmonic Resonance |
Regeneration I + Haste I |
| Koto |
Tranquil Current |
Water Breathing + Dolphin's Grace |
| Pipa |
Silk Road Vigor |
Speed I + Strength I |
| Saxophone |
Smoky Allure |
Hero of the Village I |
| Shamisen |
Ghost Flame |
Fire Resistance + Strength I |
| Trombone |
Bulwark Fanfare |
Resistance I + Absorption II |
| Violin |
Heartstring Aria |
Regeneration I + Absorption I |
Note Block Instrument variants (basedrum, bass, bell, etc.) are also mapped to thematically matching auras — see _README_INSTRUMENTS.txt in your config folder for the full list.
Immersive Melodies (mobile passive tier)
| IM Instrument |
Passive Aura |
Effect |
| Flute |
Windstep |
Speed I |
| Lute |
Traveler's Hum |
Luck I |
| Piano |
Measured Tempo |
Haste I |
| Vielle |
Hearthsong |
Regeneration I |
| Didgeridoo |
Earthpulse |
Jump Boost I |
| Bagpipe |
Steadfast Drone |
Resistance I |
| Trumpet |
Brass Call |
Strength I |
| Tiny Drum |
March Tap |
Speed I |
| Triangle |
Clear Ping |
Night Vision |
| Handpan |
Stillwater |
Water Breathing |
| Ender Bass |
Shade Resonance |
Fire Resistance |
All auras can be freely customized, disabled, or deleted. Add your own by creating new JSON files.
Fully Data-Driven Aura System
Every aura is defined by a simple JSON file in your config folder:
config/effective_instruments/auras/
On first launch, the mod generates 84 default aura JSON files (31 stationary positive + 31 stationary offensive + 11 mobile positive + 11 mobile offensive) and a _README.txt reference guide. From there, you have full control:
- Edit any default aura — change its effects, duration, radius, color, name, or description
- Disable an aura by setting
"enabled": false — it stays on disk but won't appear in-game
- Delete a default aura file — it won't be regenerated
- Create new auras by adding your own
.json files to the folder
Aura JSON Format
{
"displayName": "Fire Ward",
"description": "Fire Resistance to nearby allies",
"color": "FF4400",
"enabled": true,
"durationTicks": 200,
"radius": 12,
"sortOrder": 10,
"effects": [
{ "effect": "minecraft:fire_resistance", "amplifier": 0 }
]
}
New in 1.3.0: Two optional fields control tier support:
"tiers" — array of "stationary", "mobile", or both. Defaults to ["stationary"] if omitted, so existing files need no edits.
"showInSelector" — true/false. Defaults to true for stationary presets, false for mobile-only.
Fields:
| Field |
Type |
Description |
displayName |
string |
Name shown on the button tooltip |
description |
string |
Tooltip description line |
color |
string |
Hex color code (e.g. "FF8800") — used for particles and UI highlights |
enabled |
bool |
Whether this aura appears in the selector |
durationTicks |
int |
How long applied effects last (20 ticks = 1 second) |
radius |
int |
Aura range in blocks. Use -1 to inherit the global server default |
sortOrder |
int |
Button ordering in the UI (lower = further left) |
effects |
array |
List of potion effects to apply (see below) |
tiers |
array |
(Optional) Which tiers: ["stationary"], ["mobile"], or both |
showInSelector |
bool |
(Optional) Show in stationary selector UI |
icon |
string |
(Optional) Resource location for the button icon texture |
iconSelected |
string |
(Optional) Resource location for the selected icon texture |
Each entry in the effects array takes:
"effect" — the registry name of the potion effect (e.g. "minecraft:regeneration", "minecraft:speed")
"amplifier" — effect level minus 1 (0 = Level I, 1 = Level II, etc.)
If icon/iconSelected are omitted, the button displays the first letter of the display name as a fallback — so custom auras don't require any texture work.
Instrument-Aura Mapping
Stationary Mapping
The file config/effective_instruments/instrument_auras.json controls which auras are available for each instrument and which one auto-selects when opened.
Two formats are supported per entry:
String shorthand — single aura, default and only option:
"genshinstrument:windsong_lyre": "zephyrs_blessing"
Object form — default aura + additional allowed auras in the selector:
"genshinstrument:windsong_lyre": {
"default": "zephyrs_blessing",
"allowed": ["zephyrs_blessing", "echoes_of_antiquity", "bloom_veil"]
}
- If an instrument is not listed, all enabled auras are shown (backwards-compatible)
- The default aura is always included in the allowed list automatically
Mobile Mapping (new in 1.3.0)
The file config/effective_instruments/mobile_instrument_auras.json maps Immersive Melodies instrument IDs to mobile-tier aura presets. Each entry is a simple string (one aura per instrument, no selector):
"immersive_melodies:flute": "windstep_mobile"
Use /effectiveinstruments reload to apply changes to either mapping without restarting.
Commands
| Command |
Permission |
Description |
/effectiveinstruments reload |
OP (level 2) |
Reload all aura presets and instrument mappings (stationary + mobile) |
/effectiveinstruments status [player] |
OP (level 2) |
Show a player's current aura state (both tiers when IM is present) |
/effectiveinstruments durability {get |
set <n> |
repair} |
/effectiveinstruments diagnose |
Everyone |
Dump pipeline state (why isn't my aura firing?) |
/effectiveinstruments reset-mappings |
OP (level 2) |
Delete + regenerate the instrument-aura mapping from the canonical 1-to-1 table |
/effectiveinstruments help |
Everyone |
Print config location and command summary |
Configuration
All config files live under a single folder: config/effective_instruments/.
Server Config (server.toml)
General settings:
| Setting |
Default |
Description |
enabled |
true |
Master toggle for all aura effects |
noteWindowTicks |
100 |
Ticks after the last note before the aura deactivates (100 = 5 sec) |
auraTickIntervalTicks |
10 |
How often (in ticks) aura effects refresh on targets |
defaultRadius |
16 |
Default aura range in blocks (used when a preset's radius is -1) |
Targeting settings:
| Setting |
Default |
Description |
allowSelfBuff |
true |
Whether the musician receives their own aura effects |
includeOtherPlayers |
true |
Whether other players in range receive effects |
includeTamedPets |
true |
Whether tamed animals in range receive effects |
petEntityTypeAllowlist |
[] |
Extra entity type IDs to treat as pets (e.g. ["alexsmobs:crow"]) |
Mobile tier settings (new in 1.3.0):
These no-op when Immersive Melodies is not installed.
| Setting |
Default |
Description |
enabled |
true |
Master toggle for mobile tier |
pulseIntervalTicks |
20 |
How often (in ticks) mobile effects refresh (20 = 1 sec) |
lingerTicks |
60 |
How long effects linger after the player stops playing |
defaultRadius |
8 |
Mobile aura range when JSON radius is -1 |
maxTargetsPerTick |
16 |
Entity cap per mobile musician per pulse |
allowSelfBuff |
true |
Musician receives their own mobile effects |
includeOtherPlayers |
true |
Other players in range receive mobile effects |
includeTamedPets |
false |
Tamed pets receive mobile effects (off by default for balance) |
suppressWhenStationaryActive |
true |
Stationary tier suppresses mobile for the same player |
Client Config (client.toml)
| Setting |
Default |
Description |
showOverlay |
true |
Show the aura selector buttons on instrument screens |
overlayScale |
1.0 |
Scale factor for overlay buttons (0.5 - 2.0) |
compactMode |
false |
Use a compact button layout |
particlesMode |
ALL |
Floating music note particles: ALL, MINIMAL, or NONE |
reducedMotion |
false |
Dampen particle drift and pulse (accessibility) |
screenClassAllowlist |
[] |
Fully-qualified class names for instrument screens from other mods that don't extend Genshin Instruments' InstrumentScreen |
Visual Effects
When an aura is active, colored floating music note particles spawn across the full radius of the aura's effect range. The particles are tinted to match the aura's configured color — teal drifting notes for Zephyr's Blessing, crimson for Warcry Cadence, violet for Moonlit Passage, and so on. They gently rise, drift, pulse in size, and fade out.
Particle rendering is entirely client-side. If particles cause performance issues, use the particlesMode client config option to reduce or disable them.
Smart Buff Handling
- Strongest wins: If a target already has a stronger version of the same effect from another source (e.g. a beacon or potion), the aura won't overwrite it.
- Clean switching: Changing auras instantly strips the old aura's effects from all targets. The mod tracks exactly which effects it applied to which entities and only removes its own.
- Clean close: Closing an instrument clears the aura and strips tracked effects. The instrument's default aura will auto-select next time it's opened.
- Tier precedence: When both stationary and mobile tiers could apply to the same player, stationary wins and suppresses the mobile tier (configurable).
- Ambient effects: Aura-applied effects use the ambient flag (subtle swirling particles) to distinguish them from potions and to keep the visual clutter low.
- Per-instrument memory: If you override the default aura for an instrument, your choice is remembered for that instrument within the session (forgotten on logout).
Compatibility
- Genshin Instruments (required) — all instrument screens are automatically detected
- Even More Instruments (optional) — all EMI screens extend Genshin Instruments'
InstrumentScreen and are automatically supported, including all 16 Note Block Instrument variants
- Immersive Melodies (optional, new in 1.3.0) — enables mobile passive tier. No IM classes imported, no reflection, no mixins. When IM is absent the compat layer is a zero-cost no-op
- Other instrument mods — use the
screenClassAllowlist client config to add support for screens from mods that don't extend InstrumentScreen
Effects from other mods (potion effects, beacons, etc.) are never stripped or overwritten unless the aura provides a stronger or equal version.
Requirements
- Minecraft 1.20.1
- Forge 47+
- Genshin Instruments 5.0+
- Optional: Even More Instruments 6.0+
- Optional: Immersive Melodies 0.6.0+ (enables mobile tier)
Quick Start
- Install the mod alongside Genshin Instruments.
- Open any instrument in-game. Its unique aura auto-selects and the corresponding button appears in the top-right corner.
- Start playing. Nearby allies will receive the buff.
- (Optional) Install Immersive Melodies. Hold an IM instrument and start a melody — passive buffs activate automatically.
- To customize auras, edit the JSON files in
config/effective_instruments/auras/.
- To change instrument mappings, edit the mapping files in
config/effective_instruments/.
- Use
/effectiveinstruments reload to apply changes without restarting.
评论 0
登录后参与评分
还没有评论,来抢沙发吧