ShinyItems Fork - 发光物品

ShinyItems 是一款允许玩家手持特定物品时，在其周围产生动态光源的插件。它是原版 ShinyItems 的延续版本，支持从 1.8.x 到 1.14.x 的 Bukkit/Spigot 服务端。

💡前置需求与兼容性

• 必需插件：LightAPI fork 的最新版本。

- 插件支持任何版本的 LightAPI（原版或 fork 版），但**强烈建议**使用 fork 的最新版本，因为原版 LightAPI 在 1.14 版本中存在错误且不稳定。

• 服务端版本：支持 Bukkit/Spigot 1.8.x 至 1.14.x。

- 请忽略插件页面顶部的“Native minecraft version 1.13”提示，Bukkit/Spigot 1.14 可以同时兼容 1.13 和 1.14。

✨安装步骤

• 将 ShinyItems.jar 文件拖入服务器的 plugins 文件夹。
• 如果你之前使用过 1.7.0 之前的版本，请备份并删除旧的配置文件 plugins/ShinyItems/config.yml（新旧版本配置文件不兼容）。
• 启动服务器。
• 插件会自动生成一个新的 config.yml 文件，其中包含一些常用光源的配置示例。你可以根据文件内的说明自定义光源列表。

🎮命令

• /shinyitems toggle

- 切换执行命令的玩家是否启用物品发光效果。

• /shinyitems reload

- 重新从配置文件加载数据到内存。用于使配置文件的修改在游戏中生效。

🔧权限

• shinyitems.use

- 如果在配置中启用了权限系统，玩家需要此权限才能使用插件。否则，默认所有玩家都拥有此权限。

• shinyitems.use.<item_name_here>

- 如果在配置中同时启用了物品特定权限，玩家除了需要 `shinyitems.use` 权限外，还需要此权限才能使特定物品发光。

- `<item_name_here>` 是物品的材质名称（小写），例如，要让火把发光，玩家需要 `shinyitems.use.torch` 权限。

- 材质名称请参考：[Spigot Material Javadoc](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)

• shinyitems.toggle

- 授予玩家使用 `/shinyitems toggle` 命令的权限。

• shinyitems.reload

- 授予玩家使用 `/shinyitems reload` 命令的权限。

⭐配置详解 (`config.yml`)

配置文件包含详细的注释说明，以下为关键选项的概述。

主要设置

• debug: true/false

- 启用/禁用额外的调试信息输出。

• enable-permissions: true | false

- 如果为 `true`，玩家需要 `shinyitems.use` 权限才能使用发光物品。否则，所有玩家都可以使用。

• enable-item-specific-permissions: true | false

- 如果此项和 `enable-permissions` 都为 `true`，玩家将只能使用其拥有 `shinyitems.use.<物品名>` 权限的特定物品发光。

• update-delay-ticks: <数字>

- 服务器更新玩家周围光源前的延迟（以游戏刻为单位）。

• db-lights-as-allowed: true/false

- 影响玩家首次使用插件时的默认状态。

- 如果为 `true`，则默认**禁用**玩家的发光物品效果。如果为 `false`（默认值），则默认**启用**。

• water-height-method: MODERN | OLD | AUTO

- 用于判断玩家是否在水下（触发水下渲染风格）时，计算水位高度的方法。

- `MODERN`：使用 Minecraft 1.14 及以上的算法（更精确）。

- `OLD`：使用 Minecraft 1.14 以下的算法。

- `AUTO`：根据 Minecraft 版本自动选择。

光源列表 (`lightsources`)

此列表定义了哪些物品可以发光。每个发光物品都是一个独立的结构，以 - ==: -=[ShinyItem]=- 开头。

每个结构包含以下参数

• item: <名称>

- 物品的材质名称（大写），例如 `TORCH`。

• lightlevel: <空气中亮度> [, <水下亮度>]

- 物品的发光等级，范围 0-15。

- 第一个值为玩家在空气中时的亮度。

- 第二个值（可选）为玩家在水下时的亮度，用逗号分隔。如果省略，则水下使用与空气中相同的亮度。

- 示例：

- `lightlevel: 14` （空气和水下亮度相同）

- `lightlevel: 14, 7` （水下亮度更低）

- `lightlevel: 0, 14` （仅在水下发亮）

• amount: <数字>[, <数字>] | Any

- 使用条件：玩家手中必须持有的物品数量。

- 可以是单个数字、一个区间（两个数字用逗号分隔）或关键字 `Any`（表示任意数量）。

- 示例：

- `amount: Any`

- `amount: 3`

- `amount: 20, 64`

• durability: <数字>[, <数字>] | Any

- 使用条件：玩家手中物品的耐久度。

- 可以是单个数字、一个区间或关键字 `Any`（表示任意耐久）。

- 示例：

- `durability: Any`

- `durability: 0` （物品必须未损坏）

- `durability: 0, 10` （损坏程度不超过10）

• unbreakable: true | false | Any

- 使用条件：玩家手中物品的“无法破坏”标志状态。

- 可以是 `true`、`false` 或 `Any`。

• enchantments: Any | <附魔列表>

- 使用条件：玩家手中物品必须拥有的附魔列表。

- 可以是关键字 `Any`，或一个附魔名称的列表（例如 `- FIRE_ASPECT`）。如果列表为空 `[]`，则物品必须没有任何附魔。

配置逻辑说明

• 物品列表中可以包含重复的物品。插件会从上到下检查，第一个满足所有条件的物品将被选中用于发光。
• 如果玩家双手都持有发光物品，则会选择发光等级最高的那个。
• 所有条件（item, amount, durability, unbreakable, enchantments）必须同时满足（AND 逻辑）。
• 如果需要实现 OR 逻辑（例如不同数量区间对应不同亮度），只需重复定义该物品的结构并设置不同的条件即可。