Zap的增强附魔闪光

ZEEG — Zap 的增强附魔闪光

一个轻量级客户端 Fabric 模组，允许您在没有资源包的情况下动态自定义附魔闪光效果。

功能特性

• 颜色选择器：可设置任意 RGB 或十六进制颜色值
• 多种循环模式：
  • 静态：单一纯色自定义颜色。
  • 彩虹：在光谱中平滑循环过渡。
  • 双色调：在两种自定义颜色之间交替平滑过渡。
• 物品专属覆盖：为特定物品分配独特的闪光颜色（例如：下界合金剑为绿色，弓为红色）。
• 自定义名称覆盖：根据在铁砧中重命名的物品名称动态着色您的闪光效果。
• 资源包配置：资源包创建者可以通过自定义资源包提供默认的闪光配置。
• 直观的图形界面：可直接通过 Mod Menu 访问易于使用的配置界面。
• 原生集成：与游戏内置的闪光强度和速度设置兼容。
• 模组兼容性：适用于任何模组物品。
• 开发者与数据包友好：公开自定义 zeeg:glint 数据组件，允许其他模组、数据包和 /give 命令轻松地在任何物品上设置自定义闪光属性。

版本支持与分支

ZEEG 支持多个 Minecraft 版本：

• 1.21.11
• 26.1.x
• 26.2.x

使用方法

1. 在 Fabric 上安装 ZEEG（需要 Fabric API 和 Mod Menu）。
2. 打开 Mod Menu -> ZEEG -> 配置。
3. 自定义您的颜色、速度、覆盖设置或循环模式。
4. 点击 保存并重载 以在游戏中即时应用更改。

资源包使用说明

资源包创建者可以在其资源包中捆绑默认配置预设、物品专属覆盖或命名覆盖。如果启用，ZEEG 将自动检测并加载这些配置。

在您的资源包中创建一个名为 config.zg 的 JSON 文件，路径为： assets/zeeg/config.zg

示例 config.zg 结构：

{
  "red": 0,
  "green": 255,
  "blue": 128,
  "strength": 255,
  "cycleMode": 1,
  "rainbowSpeed": 25,
  "itemColors": [
    {
      "itemId": "minecraft:netherite_sword",
      "red": 255,
      "green": 0,
      "blue": 0
    }
  ],
  "namedColors": [
    {
      "name": "Excalibur",
      "red": 255,
      "green": 215,
      "blue": 0,
      "strength": 255,
      "cycleMode": 2,
      "red2": 255,
      "green2": 255,
      "blue2": 255
    }
  ]
}

命令使用说明

您可以使用 /give 命令通过指定 zeeg:glint 数据组件来获取带有预配置自定义闪光的物品。

格式：

• 附魔时的自定义闪光：

  /give @s minecraft:diamond_sword[zeeg:glint={r:255,g:255,b:0}]
  

• 彩虹闪光：

  /give @s minecraft:diamond_sword[zeeg:glint={cycle_mode:1,speed:50}]
  

• 双色调闪光：在红色和蓝色之间平滑过渡：

  /give @s minecraft:diamond_sword[zeeg:glint={cycle_mode:2,r:255,g:0,b:0,r2:0,g2:0,b2:255,speed:30}]
  

可用组件字段：

• r、g、b（整数 0-255）：主要 RGB 颜色（默认值：255）。
• strength（整数 0-255）：闪光不透明度/强度（默认值：255）。
• cycle_mode（整数 0-2）：0 = 静态，1 = 彩虹，2 = 双色调（默认值：0）。
• speed（整数 1-100）：循环过渡速度（默认值：25）。
• r2、g2、b2（整数 0-255）：双色调模式的次要目标 RGB 颜色（默认值：255）。

数据包使用说明

数据包创建者可以在战利品表、自定义配方结果或进度奖励中使用 zeeg:glint 组件。

示例战利品表物品：

{
  "type": "minecraft:item",
  "name": "minecraft:netherite_sword",
  "functions": [
    {
      "function": "minecraft:set_components",
      "components": {
        "minecraft:enchantment_glint_override": true,
        "zeeg:glint": {
          "r": 255,
          "g": 0,
          "b": 0,
          "cycle_mode": 2,
          "r2": 255,
          "g2": 128,
          "b2": 0,
          "speed": 15
        }
      }
    }
  ]
}

模组使用说明

模组开发者可以使用 API 直接在 ItemStack 实例上读取和修改闪光组件。

获取闪光数据：

import com.zapaxe.zeeg.GlintComponent;
GlintComponent glint = stack.get(GlintComponent.TYPE);
if (glint != null) {
    int red = glint.r();
    int green = glint.g();
    int blue = glint.b();
}

应用闪光数据：

import com.zapaxe.zeeg.GlintComponent;
// 参数：r, g, b, strength, cycleMode, speed, r2, g2, b2
GlintComponent customGlint = new GlintComponent(255, 0, 255, 255, 1, 20, 255, 255, 255);
stack.set(GlintComponent.TYPE, customGlint);