ShinyItems - 物品发光插件

ShinyItems 是一款轻量级插件，它允许玩家手持特定物品（如火把、荧石等）时，在自身周围产生动态光源，照亮黑暗的洞穴或夜晚环境，提升游戏体验。

💡注意

此资源已停止更新。请前往以下链接查看并下载其后续维护版本：

https://www.spigotmc.org/resources/★shinyitems★-fork.69716/

🎮安装与依赖

安装

• 将下载的 .jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。

必需依赖

本插件需要 LightAPI 才能正常工作。请根据你的服务器版本选择：

• 对于较新版本的服务器 (1.12+)

请使用临时的 LightAPI 分支版本

https://www.spigotmc.org/resources/lightapi-temporary-fork.48247/

• 对于旧版服务器 (1.8.X - 1.11.X)

请使用原版 LightAPI

https://www.spigotmc.org/resources/lightapi.4510/

🔧命令与权限

权限节点

• shinyitems.use

如果配置文件中启用了权限，玩家需要此权限才能使用插件的光照功能。默认情况下，所有玩家都拥有此权限。

• shinyitems.use.item_name_here

如果配置文件中同时启用了物品特定权限，玩家除了需要 shinyitems.use 权限外，还需要对应的物品权限。例如，要让火把发光，玩家需要拥有 shinyitems.use.torch 权限。

注意：物品名称必须全部小写，你可以在官方文档中查找准确的物品名：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html

• shinyitems.toggle

允许玩家使用 /shinyitems toggle 命令，为自己开启或关闭插件的光照效果。

• shinyitems.reload

允许玩家使用 /shinyitems reload 命令，重新加载配置文件，使修改在游戏中生效。

可用命令

• /shinyitems toggle - 切换自身的光照效果开关。
• /shinyitems reload - 重载插件配置（需要对应权限）。

⭐配置说明

配置文件 (config.yml) 中，你通常只需要关注 enable-permissions 选项。其他设置保持默认即可。

默认配置文件预览

enable-permissions: false
enable-item-specific-permissions: false
distance-before-new-lightsource: 1
lightsources:
- ==: io.github.sipsi133.ShinyItem
  enchants: []
  item: REDSTONE_TORCH_ON
  durability: -1
  unbreakable: false
  lightlevel: 7
- ==: io.github.sipsi133.ShinyItem
  enchants: []
  item: REDSTONE_TORCH_OFF
  durability: -1
  unbreakable: false
  lightlevel: 7
- ==: io.github.sipsi133.ShinyItem
  enchants: []
  item: GLOWSTONE
  durability: -1
  unbreakable: false
  lightlevel: 14
- ==: io.github.sipsi133.ShinyItem
  enchants: []
  item: TORCH
  durability: -1
  unbreakable: false
  lightlevel: 14
- ==: io.github.sipsi133.ShinyItem
  enchants: []
  item: LAVA
  durability: -1
  unbreakable: false
  lightlevel: 14
- ==: io.github.sipsi133.ShinyItem
  enchants:
  - DURABILITY
  item: LAVA_BUCKET
  durability: -1
  unbreakable: false
  lightlevel: 14

主要配置项

• enable-permissions: false

设为 true 则启用权限系统，玩家需要 shinyitems.use 权限才能使用光照功能。

• enable-item-specific-permissions: false

设为 true 则启用物品级权限控制（需要同时启用 enable-permissions）。

• distance-before-new-lightsource: 1

玩家移动多少格后，插件会重新计算并放置新的光源。数值越大，性能消耗可能越低，但光照更新会略有延迟。

• lightsources

在此列表中可以自定义哪些物品会发光，以及发光的亮度等级 (lightlevel，范围 0-15)。你可以参照格式添加或修改物品。