ArcaneBeam

奥术光束 (Arcane Beam)

Arcane Beam 是一个客户端侧的视觉与音效替换模组，用于替换 Minecraft 1.18.2 Forge 版本中《宝藏猎人》（Vault Hunters）的奥术（Arcane）与奥术射线（Arcane Rail）技能。

它不再渲染长长的粒子流，而是绘制出清晰、可配置的光束，这些光束跟随玩家的准星，在碰撞时停止，并保留两个技能的原始行为。奥术仍然是持续光束，而奥术射线则是短促的单发射击光束。

功能特性

• 将奥术和奥术射线的粒子线条替换为渲染的光束
• 为奥术和奥术射线提供独立的设置
• 每个技能有四种光束颜色和四种辉光颜色
• 游戏内颜色选择器，支持实时预览
• 强度、不透明度、辉光半径、辉光不透明度、辉光旋转和颜色偏移控制
• 为两个技能提供可配置的淡入/渐入和淡出/渐隐过渡效果
• 每个技能可独立配置淡入/淡出时长
• 选择主手或副手作为光束起源
• 精细的 XYZ 轴起源偏移控制
• 支持鼠标滚轮调整起源偏移、音量和过渡时长字段
• 着色器兼容性开关
• 为两个技能提供自定义音效选择
• 每个技能可独立控制自定义音效音量
• 为奥术技能提供启动音效 + 循环音效行为支持
• 当选择自定义 ArcaneBeam 音效时，会抑制默认的宝藏施法音效
• 在半透明的配置界面后方提供光束实时预览
• 客户端配置保存至 config/ArcaneBeam.json

需求

此模组专为《宝藏猎人》第三版设计，需要：

• Minecraft 1.18.2
• Forge 40.x
• Java 17
• The Vault (宝藏猎人模组)
• 展示新音效槽位文件路径的示例资源包压缩包： 示例资源包

0.1.14

发布说明

特别感谢 Masuary 提供的新菜单。

## 0.1.14

此次更新聚焦于 Arcane Beam 的光束配置，并使模组保持专注于《宝藏猎人》技能视觉替换。游戏玩法行为、伤害、冷却时间、目标锁定、法力消耗和服务器逻辑均保持不变。

### 光束配置

- 为奥术/奥术射线的光束渲染新增了“准星瞄准”开关
- 当“准星瞄准”启用时，渲染的光束会直接指向准星下的方块或实体，而不是锁定在玩家的视线向量上
- 这有助于光束在视觉上与近距离、远距离目标、方块和实体对齐，即使光束在不同距离被截断时也是如此
- “准星瞄准”为可选功能，默认关闭，除非启用，否则保留之前的光束行为
- “准星瞄准”设置按光束配置文件分别保存

### 配置菜单

- 将 Arcane Beam 配置菜单更新为更新的标签页布局
- 改进了现有技能替换设置的间距和组织结构
- 保留现有的配置文件、颜色控制、着色器兼容性选项、音效选项和资源包音效槽位不变

### 模组清理

- 已将 Sophisticated Storage 的兼容性修复移出 Arcane Beam，作为独立模组

### 备注

- 这仍然是一个客户端侧的视觉/音频替换模组
- 现有的奥术、奥术射线、闪电打击、宝藏祭坛、风暴之箭、制裁与执政官的游戏玩法行为不变

0.1.11

发布说明

## 0.1.11

此更新改进了 Arcane Beam 的自定义音效处理，并降低了在长时间游戏过程中 Minecraft 音频中断的可能性。

### 音频稳定性

- 改进了离开世界、断开连接或 Minecraft 停止活动音效时对 Arcane Beam 自定义音效的清理
- 更改了 Arcane Beam 自带的技能音效，以避免不必要的流式音频回放
- 将 Arcane Beam 运行时的自定义音效默认更改为使用更轻量的非流式音效路径
- 改进了对活跃的奥术、闪电打击、奥术射线、宝藏祭坛、风暴之箭、制裁与执政官替换音效的清理
- 保留所有现有的音效选项、资源包音效槽位、视觉效果和技能行为不变

这是一次专注于客户端音频稳定性的维护性发布。游戏玩法行为、伤害、冷却时间、目标锁定、法力消耗和服务器逻辑均保持不变。

0.1.10

发布说明

## 0.1.10

此更新为《宝藏猎人》的技能和祭坛灌注效果新增了几个客户端侧的视觉和音效替换。所有游戏玩法行为、伤害、目标锁定、冷却时间、法力消耗和服务器逻辑均保持不变。

### 宝藏祭坛灌注

新增了一个可配置的宝藏祭坛灌注替换效果。

当祭坛灌注开始时，默认的粒子柱会被四个汇聚在祭坛上的小型角落光束所取代，随后是一道中心光束和从祭坛表面升起的辉光。

配置选项包括：
- 启用/禁用替换
- 配置文件
- 着色器兼容性
- 全亮模式
- 角落光束颜色
- 中心光束颜色
- 中心辉光颜色
- 光束不透明度、大小、锥度、高度和淡出
- 用于对齐天花板建筑的角落光束起源高度和半径
- 可选的起源标记 X 渲染，便于设置
- 角落停留、汇聚和中心生长的计时控制
- 音效模式和音量

音效选项：
- 默认
- 祭坛 1
- 资源包 1
- 资源包 2

资源包音效路径：
- `assets/arcanebeam/sounds/abilities/vault_altar_resourcepack_1.ogg`
- `assets/arcanebeam/sounds/abilities/vault_altar_resourcepack_2.ogg`

### 风暴之箭

新增了一个可配置的风暴之箭替换效果。

射出的箭矢被替换为一个滚动的小型目标指示器球体，成功的风暴之箭打击被替换为从天而降的快速轨道式能量螺栓。命中效果包含一个更大的渲染火花轨迹，无需使用繁重的粒子系统。

配置选项包括：
- 启用/禁用替换
- 配置文件
- 着色器兼容性
- 全亮模式
- 目标圈
- 可选的显示实际半径
- 圆圈颜色、不透明度和宽度
- 螺栓颜色、核心颜色、宽度、长度、寿命和起源高度
- 命中闪光颜色和大小
- 音频范围
- 音量

音效选项包含独立的：
- 打击音效
- 投射物/指示器发射音效

资源包音效路径：
- `assets/arcanebeam/sounds/abilities/storm_arrow_resourcepack_1.ogg`
- `assets/arcanebeam/sounds/abilities/storm_arrow_resourcepack_2.ogg`
- `assets/arcanebeam/sounds/abilities/storm_arrow_projectile_resourcepack_1.ogg`
- `assets/arcanebeam/sounds/abilities/storm_arrow_projectile_resourcepack_2.ogg`

### 制裁

新增了一个可配置的制裁替换效果。

制裁打击被替换为与风暴之箭相同风格的快速轨道能量螺栓，包括可配置的命中闪光和火花轨迹。制裁不使用投射物替换，但它支持一个独立的激活音效。

配置选项包括：
- 启用/禁用替换
- 配置文件
- 着色器兼容性
- 全亮模式
- 目标圈
- 可选的显示实际半径
- 圆圈颜色、不透明度和宽度
- 螺栓颜色、核心颜色、宽度、长度、寿命和起源高度
- 命中闪光颜色和大小
- 音频范围
- 音量

音效选项包含独立的：
- 打击音效
- 激活音效

资源包音效路径：
- `assets/arcanebeam/sounds/abilities/smite_resourcepack_1.ogg`
- `assets/arcanebeam/sounds/abilities/smite_resourcepack_2.ogg`
- `assets/arcanebeam/sounds/abilities/smite_activation_resourcepack_1.ogg`
- `assets/arcanebeam/sounds/abilities/smite_activation_resourcepack_2.ogg`

### 执政官

新增了一个可配置的执政官替换效果。

执政官与制裁分开处理，并使用一种受“啸鸦”启发的小型追踪导弹式视觉效果。导弹从玩家周围一个可配置的半径范围内生成，弧形飞向目标，并使用可配置的尾迹颜色、核心颜色、命中闪光和短寿命。

配置选项包括：
- 启用/禁用替换
- 配置文件
- 着色器兼容性
- 全亮模式
- 目标圈
- 可选的显示实际半径
- 圆圈颜色、不透明度和宽度
- 导弹/尾迹颜色、核心颜色、宽度、长度、寿命、高度和起源半径
- 命中闪光颜色和大小
- 音频范围
- 音量

音效选项包含独立的：
- 打击音效，包括自带的“啸鸦”选项
- 激活音效

资源包音效路径：
- `assets/arcanebeam/sounds/abilities/archon_resourcepack_1.ogg`
- `assets/arcanebeam/sounds/abilities/archon_resourcepack_2.ogg`
- `assets/arcanebeam/sounds/abilities/archon_activation_resourcepack_1.ogg`
- `assets/arcanebeam/sounds/abilities/archon_activation_resourcepack_2.ogg`

### 资源包示例

更新了示例 Arcane Beam 资源包压缩包，新增了风暴之箭、制裁、执政官和宝藏祭坛的音效替换路径。

这些 Arcane Beam 资源包槽位不需要自定义的 `sounds.json`。将占位符 `.ogg` 文件替换为你自己的 Ogg Vorbis 文件，启用资源包，然后在相关的 Arcane Beam 配置标签页中选择 Resourcepack1 或 Resourcepack2。

0.1.9

发布说明

## 0.1.9

- 新增了一个可配置的宝藏祭坛灌注视觉替换效果
- 将祭坛激活粒子柱替换为四个汇聚在祭坛中心的角落光束
- 为角落光束、中心光束和中心辉光添加了宝藏祭坛颜色控制
- 添加了可配置的角落光束起源高度和半径，以便天花板安装的发射器能在游戏中对齐
- 更新了示例资源包压缩包，加入了宝藏祭坛音效替换路径

0.1.8

发布说明

## 0.1.8

- 新增了一个受“地震电荷”冲击波启发的可配置闪电打击视觉替换效果
- 在配置界面中新增了“闪电打击”标签页，包含配置文件、着色器兼容性、颜色控制、视觉微调和音效控制
- 新增了一个风格类似小型“地震电荷”的自定义闪电打击投射物渲染
- 新增了可配置的闪电打击冲击波元素，包括扩张环、中心球体、上/下锥体、星状点、波纹设置、不透明度、大小、颜色和寿命
- 为闪电打击增加了“默认”、“地震电荷”、“资源包1”和“资源包2”音效模式
- 新增了对独立的闪电打击施法和打击音效替换的支持，带有音量控制
- 包含了自带的“地震电荷”施法和打击音效
- 将默认的闪电打击设置设为经过测试的 `Main` 配置文件值
- 改进了冲击波和投射物渲染的着色器兼容性
- 通过使用宝藏打击音效作为客户端投射物命中钩子失效时的回退触发器，提高了闪电打击的命中可靠性
- 修复了闪电打击的替换效果，现在投射物过期和非目标打击不会触发冲击波或打击音效
- 修复了闪电打击颜色选择器的布局和颜色更新行为
- 改进了奥术的激活和释放处理，使自定义光束和音效更可靠地跟踪按键
- 加固了可选的客户端侧 Sophisticated Storage 限制桶正面交互辅助功能

0.1.7

发布说明

## 0.1.7

- 新增了一个客户端侧 Sophisticated Storage 限制桶的交互修复
- 保留了物品存入、双击右键全部存入、染料、打包带和升级组件的正常正面行为
- 增加了从限制桶正面使用潜行 + 空手右键打开的功能，与用户配置的潜行键位一致
- 当安装了 Vault Additions 时，跳过新的 Sophisticated Storage 交互混入，与 Arcane Beam 现有的 Vault Additions 兼容性保护一致

0.1.6

发布说明

## 0.1.6

- 在配置界面中为奥术和奥术射线增加了配置文件支持
- 增加了每个类别的配置文件创建和选择功能，配置文件保存在 `config/ArcaneBeam.json` 中
- 在首次使用新配置格式启动时，将现有的奥术和奥术射线设置迁移到 `Default` 配置文件中
- 当安装了 Vault Additions 时，安全地跳过 Arcane Beam 的 Sophisticated Storage / Compressium 混入

0.1.5

发布说明

## 0.1.5

- 修复了 Compressium 压缩方块在 Sophisticated Storage 桶显示面上显示不正确的问题
- 为 Sophisticated Storage 显示渲染路径增加了可选的客户端侧兼容性处理
- 改进了 Compressium 方块显示的大小和面对齐，使桶显示更接近正常方块显示行为
- 保持兼容性路径为可选，因此未安装 Sophisticated Storage 或 Compressium 时 Arcane Beam 仍可加载
- 改进了奥术/奥术射线配置界面，使其能缩放以适应更大的 GUI 比例和更小的屏幕
- 为奥术和奥术射线各增加了两个资源包音效槽位

0.1.4

发布说明

## 0.1.4

- 修复了在某些宝藏主题中光束被拉向正北的问题
- 加固了光束方向渲染，使得主题粒子和碰撞终点无法将渲染的光束从施法者的瞄准方向旋转开
- 保持方块碰撞行为不变：光束仍然可以在方块上提前停止，但碰撞只能缩短光束而不会改变其方向
- 增加了对短暂无效视线向量帧的回退处理，使光束保持其上一次的有效瞄准方向，而不是突然指向世界方向

0.1.3

发布说明

## 0.1.3

- 改进了在多人游戏中移动、侧移和跳跃时的奥术光束稳定性
- 改进了本地奥术激活追踪，减少附近玩家因你的角色而触发光束或音效的可能性
- 修复了奥术释放时机，使得当施法键释放时，本地光束和自定义循环音效能更快地停止
- 保留了通过粒子检测渲染远程玩家光束的功能，同时将其与本地玩家所有权分离
- 平滑了进入或离开潜行状态时的光束起源，使起始点能够过渡而不是突然垂直跳动
- 改进了光束颜色循环，使过渡能够更平滑地混合所有已配置的颜色

0.1.2

发布说明

## 0.1.2

- 修复了由淡出/渐隐在活跃刷新期间过早开始导致的奥术光束和辉光抖动问题
- 增加了一个淡出宽限期，使活跃的奥术光束在粒子刷新间隔期间保持视觉上的刚性
- 将方形光束核心几何体替换为 8 边管状，以获得更圆润的外观
- 将方形辉光外壳几何体替换为 8 边管状
- 更新了着色器兼容性渲染，以使用相同的 8 边光束和辉光几何体

0.1.1

发布说明

## 0.1.1

- 增加了每个技能的音量控制
- 增加了每个技能的可配置“淡入”/“渐入”过渡模式
- 增加了每个技能的可配置“淡出”/“渐隐”过渡模式
- 增加了每个技能的“淡入刻数”和“淡出刻数”字段
- 增加了对过渡刻数字段的鼠标滚轮支持
- 增加了对音量字段的鼠标滚轮支持
- 增加了对较新的过渡和起源设置的实时预览支持
- 修复了奥术选项 2 的启动音效，使其在奥术结束时立即停止
- 修复了因附近玩家通过本地玩家施法而导致错误触发本地光束/音频的问题
- 将本地所有权归属限制在光束起源区域，而非整个射线
- 修复了默认/自定义音效抑制逻辑，使宝藏音效仅在选择了自定义 ArcaneBeam 音效时才被抑制
- 修复了奥术射线“默认”音效的回退机制
- 优化了配置界面的布局，包括颜色行、十六进制框对齐、过渡按钮和刻数标签

0.1.0

发布说明

## 0.1.0

首次公开发布。

- 将宝藏奥术和奥术射线的粒子流替换为渲染的光束
- 增加了独立的奥术和奥术射线设置
- 增加了光束和辉光颜色控制
- 增加了游戏内颜色选择器和实时预览
- 增加了基于手部的起源选择和 XYZ 轴起源偏移
- 增加了着色器兼容性开关
- 增加了自定义奥术和奥术射线音效选择
- 当选择自定义 ArcaneBeam 音效时，增加了对默认宝藏施法音效的抑制
- 增加了客户端配置持久化，保存至 `config/ArcaneBeam.json`

致谢

Arcane Beam 的渲染器是直接参考 JustAHuman 的 VaultLootBeams 构建的，同时感谢该项目的列出的贡献者 shiroroku (elise) 和 amo，以及上游的 Loot Beams 渲染器谱系。