VaultLootBeams

Vault Loot Beams

基于热门的Loot Beams模组分支，专为 VaultHunters 3rd Edition 整合包修改。
请注意，这个模组的多项“新”功能其实是从适用于较新游戏版本的原版 Loot Beams 模组回移植而来的。
因此，即使我为这个分支修改或重写了这些功能的实现，也不能将全部功劳归于自己。

功能

战利品光束

配置中指定的物品掉落在地面后，会投射出一道彩色战利品光束。
光束有多项可配置属性，详见下文。

渲染要求

• Render Distance – 战利品光束的渲染距离。接受 0-1024 格，默认值为 24。
• Require Ground – 启用后，只有物品位于地面上而非空中时，才会渲染战利品光束。
• Whitelist Color Overrides – 启用后，具有颜色覆盖设置的物品会自动加入渲染白名单。
• Render Condition – 用于自动判断物品是否应显示光束的 [ItemCondition]。默认值为 Lists Only。
• Render Whitelist – 用于指定始终显示战利品光束的物品的 [ItemList]。
• Render Blacklist – 用于指定永不显示战利品光束的物品的 [ItemList]。（此设置优先于白名单。）

渲染属性

• Beam Radius – 战利品光束的半径，接受 0-5，默认值为 1。
• Beam Height – 战利品光束的高度，最大值为 10，默认值为 2。
• Beam Y Offset – 战利品光束的垂直偏移量，最大值为 10，默认值为 0。
• Beam Alpha – 战利品光束的不透明度，接受 0-1，默认值为 0.7。
• White Beam Center – 是否为光束添加白色内层光束，默认启用。
• Beam Shadow – 是否为光束添加彩色阴影（替代原版物品阴影），默认启用。
• Shadow Radius – 阴影半径，接受 0.00001-1，默认值为 0.5。
• Shadow Alpha Multiplier – 阴影不透明度倍率。阴影继承光束的不透明度，再乘以此倍率。接受 0.00001-3，默认值为 1。
• Animate Shadow – 阴影是否随物品的上下浮动动画，默认启用。
• Beam Render Mode – 战利品光束的渲染模式，可设置为：
• Glowing – 光束会以类似闪电的方式渲染，呈现发光（自发光）效果，并能与光影良好配合。这是默认渲染模式。
• Beacon – 光束采用类似信标的纹理。如果你使用过原版 Loot Beams 模组，光束一直都是以这种方式渲染的。
• Solid – 光束使用纯色。
• Beam Color Mode – 战利品光束的默认颜色模式。对于未提供光束颜色且未配置颜色的物品，其颜色将由此模式决定：
• Default – 固定为白色。
• Name Color – 使用物品名称的颜色。
• Rarity Color – 使用物品稀有度的颜色。
• Name or Rarity Color – 如果存在名称颜色则使用名称颜色，否则使用稀有度颜色。（默认）
• Color Overrides – 用于为特定物品指定自定义颜色的 [ColorGroup] 映射。

颜色组

颜色组将一个 [ItemList] 与一组颜色关联起来。
如果包含多种颜色，这些颜色会通过渐变效果循环切换。
颜色组可以通过以下几种方式定义：

• Inline – 内联指定一个物品列表，并关联单一颜色或颜色数组。
• Full – 指定颜色组标识符，并为其配置一个 [ItemList] 和一组颜色。

在颜色组中，可以通过以下方式定义颜色：

• Integer Color– 单个颜色，格式为打包后的整数
• 同时接受直接输入整数11146495或十六进制整数0xAA14FF
• Hex Color
  – 单个颜色，格式为十六进制字符串
• 同时接受"#AA14FF"或"0xAA14FF"

完整地图示例：

{
  "color_map": {
    "minecraft:diamond": 0x00FF00, // Single color for a single item
    "minecraft:*_axe": ["#FF0000", "0x00FF00"], // Multiple colors for a partial item identifier
    "favorites": { // Full color group with an item list and inlined color
      "items": [
        "minecraft:diamond",
        "minecraft:*_sword",
        "minecraft:netherite_ingot"
      ],
      "colors": 0xFFFF00
    },
    "other_favorites": { // Full color group with an item list and multiple colors
      "items": [
        "minecraft:golden_apple",
        "minecraft:enchanted_golden_apple"
      ],
      "colors": ["#FF00FF", "#00FFFF"]
    }
  }
}

战利品光束粒子

• Beam Particles – 战利品光束是否显示粒子，默认启用。
• Particle Groups – 一个将 ID 映射到 [ParticleGroup] 的映射，用于定义特定物品战利品光束的粒子效果。

ParticleGroup

• Particle Size – 粒子大小，接受 0.00001-10，默认值为 0.25。
• Particle Speed – 粒子速度，接受 0.00001-10，默认值为 0.1。
• Particle Spread – 粒子的初始扩散范围，接受 0.00001-10，默认值为 0.05。
• Particle Count – 每秒生成的粒子数量，接受 1-20，默认值为 19。
• Particle Lifetime – 粒子的存活时间（刻），接受 1-100，默认值为 20。粒子会随着时间推移逐渐降低不透明度，直至消失。
• Particle Condition – 用于自动判断物品是否应显示粒子的 [ItemCondition]。默认值为Lists Only。
• Particle Whitelist – 一个 [ItemList]，列出始终显示粒子的物品。
• Particle Blacklist – 一个 [ItemList]，列出绝不显示粒子的物品。（此设置会覆盖白名单。）

战利品光束名称标签

战利品光束还可以选择显示物品名称标签，其中包含物品名称、数量（可选）和稀有度（可选）。

• Beam Nameplate– 是否让战利品光束显示名称标签，默认启用。
• Nameplate on Look – 是否仅当玩家看向物品/光束时才显示名称标签，默认启用。
• Nameplate Look Sensitivity – 玩家需要多准确地看向物品，名称标签才会显示；可设为 0-5，默认值为 0.018。数值越大，对玩家视线的精确度要求越低。
• Nameplate Outline – 名称标签文字是否显示描边，默认启用。
• Nameplate Include Count – 名称标签是否包含物品数量，默认启用。
• Nameplate Scale – 名称标签的缩放比例，可设为 -10-10，默认值为 1。
• Nameplate Y Offset – 名称标签相对于物品实体的垂直偏移量，可设为 -30-30，默认值为 0.75。
• Nameplate Text Alpha – 名称标签文字的不透明度，可设为 0-1，默认值为 1。
• Nameplate Background Alpha – 名称标签背景的不透明度，可设为 0-1，默认值为 0.5。
• Render Vanilla Rarities – 是否显示原版物品稀有度，默认禁用。
• Custom Nameplate Rarities – 如果在物品提示框中检测到，则会显示的自定义稀有度列表。
• Nameplate Condition – 用于自动判断物品是否应显示名称标签的 [ItemCondition]。默认值为 Lists Only。
• Nameplate Whitelist – 应始终显示名称标签的物品 [ItemList]。
• Nameplate Blacklist – 不应显示名称标签的物品 [ItemList]。（此项会覆盖白名单。）

战利品光束音效

• Landing Sound – 战利品光束落地时是否播放音效，默认禁用。
• Sound Volume – 落地音效的音量，可设为 0-1，默认值为 0.3。
• Sound Condition – 用于自动判断物品落地时是否应播放音效的 [ItemCondition]。默认值为 Lists Only。
• Sound Whitelist – 落地时应始终播放音效的物品 [ItemList]。
• Sound Blacklist – 落物时绝不播放音效的物品 [ItemList]。（此项会覆盖白名单。）

LootBeamHolder

这是一个简单的 API 接口，模组中的物品可以实现该接口，以将物品指定为战利品光束载体。

这样一来，无需将物品加入渲染白名单，也无需满足渲染条件，该物品也能显示战利品光束；同时，光束颜色还可以根据物品属性动态确定。

该接口有 2 个方法：shouldRenderBeam(ItemEntity, ItemStack) 和 getBeamColor(ItemEntity, ItemStack)。

你也可以选择通过 LootBeamHolderRegistry 注册一个 LootBeamHolder，而不是直接实现该接口。

配置

Vault Loot Beams 使用 json 配置文件来设置其功能。
你可以直接编辑配置文件，并使用指定的快捷键在游戏内重新加载；也可以使用游戏内配置编辑器（通过指定的快捷键打开）修改配置。
下文将介绍几种供多个配置选项使用的自定义配置选项类型。

ItemCondition

应用于物品的条件，用于判断相关配置选项是否通过。

• Lists Only – 仅考虑提供的白名单和黑名单。
• All Items – 所有物品均通过。
• Equipment – 装备类物品通过。（工具、盔甲、武器等）
• Rare Items – 稀有度高于 Common 的物品通过。
• Rare or Equipment – 通过 Equipment 或 Rare Items 的物品。

ItemList

物品列表是一种特殊类型的列表，用于为各种配置选项收集物品。
物品列表既可以内联为单个条目，也可以写成包含多个条目的完整列表。
条目可以采用多种格式：

• 物品标识符 – 指定具有所提供标识符的单个物品，例如 minecraft:diamond。
• 部分物品标识符 – 使用 * 表示的部分标识符，例如 minecraft:*_axe；部分标识符会指定同一命名空间下路径以 *
• 后缀结尾的所有物品。minecraft:beds物品标签 – 指定所提供标签中的所有物品，例如
• 。minecraft模组 ID – 指定该模组中的所有物品，例如 the_vault。

Vault Hunters 集成

与 The Vault 模组搭配使用时，Vault Loot Beams 会自动添加一组内置的默认配置。
此集成包含两项功能：

1. 为以下物品实现 LootBeamHolder，使其能够根据物品属性动态显示颜色：

• 增幅、祝福、药水、Vault 水晶、催化剂、铭文、宝石和工具。

1. 向默认配置中添加多个 Vault Hunters 物品及其颜色。

• 将所有 Vault 护甲、主手物品、副手物品和饰品加入白名单。
• 将宝石、钥匙部件、空白钥匙、未鉴定钥匙、知识之星和古董加入白名单。
• 为神器、铭文、失落的悬赏、旧笔记、悬赏珍珠、催化剂、卡牌组、Pog、所有宝藏钥匙及所有印章提供颜色。

漏洞修复与优化

此分支包含多项漏洞修复和优化，让你能够安心地使用战利品光束，同时无需担心性能问题。