Effective Instruments

模组

· 作者 otectus

演奏音乐。赋能盟友,或诅咒敌人。Effective Instruments 为乐器添加了魔法光环系统,使音乐家能够为附近的玩家和生物提供药水效果。

0 本站下载 0 关注 更新于 4 个月前

最新 1.6.0 · 1.20.1 · Forge

一键开服(送7天)

有效乐器

演奏音乐。赋能盟友。或诅咒你的敌人。 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)

  1. 打开任意一种乐器,来自 Genshin Instruments(或 Even More Instruments)。
  2. 您乐器的默认正面光环会自动选中。 每种乐器都映射了一个默认光环——无需手动选择。
  3. 弹奏单个音符,光环立即生效 作用于范围内所有有效的目标。持续演奏时效果会刷新;彩色的音符粒子向外飘散以显示光环的范围。
  4. 点击右上角的红色边框图标 切换到该乐器的进攻性变体。受影响生物身上的非环境粒子表明减益已生效。
  5. 停止演奏,光环会在短暂的宽限窗口后停用(可配置,默认为 5 秒)。效果会自然消失。
  6. 关闭乐器,光环清除。再次打开相同的乐器,它会记住您本次会话的最后一次选择。

移动层级(Immersive Melodies — 可选)

当安装了 Immersive Melodies 并与 Effective Instruments 共存时:

  1. 手持一种 IM 乐器 并开始一段旋律(自动播放)或使用自由演奏模式。
  2. 自由走动 —— 每次脉冲(默认:每秒一次)都会对您和附近的盟友应用一个被动光环增益。在光环激活期间,彩色音符会在音乐家周围漂浮。
  3. 暂停或切换乐器 —— 效果会短暂 linger 然后清除。
  4. 点击红色边框图标 切换到所持乐器的移动层级进攻性光环。

移动层级的光环故意比静止层级更轻量(单一效果、更短的范围和持续时间)以保持平衡。如果两种层级同时应用于同一玩家,默认情况下静止层级优先。

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+(启用移动层级)

快速开始

  1. 与 Genshin Instruments 一起安装该模组。
  2. 在游戏中打开任何乐器。其独特的光环会自动选中,右上角会出现相应的按钮。
  3. 开始演奏。附近的盟友将获得增益。
  4. (可选) 安装 Immersive Melodies。手持 IM 乐器并开始一段旋律——被动增益将自动激活。
  5. 要自定义光环,请编辑 config/effective_instruments/auras/ 中的 JSON 文件。
  6. 要更改乐器映射,请编辑 config/effective_instruments/ 中的映射文件。
  7. 使用 /effectiveinstruments reload 命令在无需重启的情况下应用更改。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源