Dynamic Lights

插件

· 作者 BeansNToast

手持物品会发出动态光源,跟随玩家和生物。适用于现代 Paper 1.21+。无需安装客户端模组。

0 本站下载 0 关注 更新于 6 个月前

最新 0.1.1+paper26 · 26.1.2 · Folia / Paper

一键开服(送7天)

DynamicLights

手持物品会发出动态光源,并跟随玩家和生物实时移动。专为现代 Paper 1.21+ 构建。无需客户端模组、无需 ProtocolLib、无需修改世界数据。

你手中的火把会照亮周围的洞穴。僵尸头上的南瓜灯会让僵尸本身发光。将灯笼放在地上,它会照亮房间。当你走开后,世界再次变暗——你的存档文件从未改变。

为什么选择此插件

  • 专为 Paper 1.21+ 构建 —— 大多数替代方案仍停留在 1.16。
  • 生物发光 —— 给僵尸手中的火把或头顶的南瓜灯,它就会发着光四处走动。支持按生物类型配置。
  • 柔和衰减簇 —— 外围光源块的亮度逐渐衰减,使运动看起来平滑而非跳跃。
  • 零依赖 —— 纯 Paper API。无需 ProtocolLib,无需 PacketEvents。
  • 单玩家开关 —— 客户端可以选择退出以节省性能。通过 PDC 持久化保存设置。
  • 单世界禁用 —— 可以通过名称跳过下界、末地或任何特定世界。
  • 热重载无需重启 —— /dl reload 会恢复所有幻影方块、重新加载配置并继续运行。
  • 体积小巧 —— ~40 KB jar 包,除 bStats 外无阴影依赖。

功能

功能 状态
玩家手持物品(主手、副手) ✅
玩家可穿戴光源(头盔槽位) ✅
生物手持物品(僵尸、骷髅、猪灵等) ✅
生物可穿戴光源(僵尸头上的南瓜灯) ✅
掉落物品发光(地上的灯笼发光) ✅
可配置的物品 → 亮度映射 ✅
用于平滑移动的簇衰减效果 ✅
单玩家切换 (/dl toggle) ✅
单世界禁用 ✅
水下支持(水logged 光源块) ✅
无世界修改 —— 纯基于数据包 ✅
旁观者和隐身检测 ✅
热重载 ✅
可替换方块白名单(保留台阶、旗帜等) ✅

兼容性

  • 服务器: Paper 1.21.x(基于 1.21.4 API 构建;已在 1.21.11 上测试)。应在任何 1.21 补丁版本上运行。
  • Java: 21+。
  • Folia / Spigot: 未测试。欢迎提交 PR。
  • 冲突: 目前已知无冲突。由于不修改世界数据,随时可以安全移除。

默认物品亮度

TORCH 14    LANTERN 15    GLOWSTONE 15    JACK_O_LANTERN 15
SOUL_TORCH 10    SOUL_LANTERN 10    REDSTONE_TORCH 7
SEA_LANTERN 15   SHROOMLIGHT 15   END_ROD 14
CAMPFIRE 14   SOUL_CAMPFIRE 10   GLOW_BERRIES 6   BLAZE_ROD 10

通过 config.yml 添加或覆盖任意材质。

命令

命令 权限 描述
/dynamiclights toggle dynamiclights.toggle 切换您自己的动态光源。
/dynamiclights reload dynamiclights.reload 重新加载配置 + 恢复运行。
/dynamiclights status — 诊断信息:跟踪的光源发射器、配置摘要。

别名:/dl, /dynlights。

配置

enabled: true
view_radius: 32
update_interval_ticks: 1
mob_scan_interval_ticks: 4
track_mobs: true
track_items: true                # 地上的掉落物品会发光

suppress_vanished_emitters: true
suppress_spectator_emitters: true

cluster_radius: 1                # 0 = 单列, 1 = 3x3, 2 = 5x5 (上限为 2)
cluster_height: 2                # 1 = 仅头部, 2 = 头部 + 身体 (上限为 3)
cluster_falloff_per_block: 2     # 从中心每增加一个方块距离减去的亮度值

disabled_worlds: []              # 例如 [world_nether, world_the_end]

mob_whitelist:
  - ZOMBIE
  - SKELETON
  - PIGLIN
  - DROWNED

equipment_slots:
  - MAIN_HAND
  - OFF_HAND
  - HEAD

item_brightness:
  TORCH: 14
  LANTERN: 15
  GLOWSTONE: 15
  JACK_O_LANTERN: 15

replaceable_blocks:              # 只有这些方块可以被替换为幻影光源
  - AIR
  - CAVE_AIR
  - WATER
  - SHORT_GRASS
  - TALL_GRASS

工作原理

当实体持有配置好的光源物品时,插件会向附近的每个玩家发送一个幻影 minecraft:light[level=N,waterlogged=B] 方块更新数据包,位置在实体的眼睛位置(及周围簇区域)。实际世界数据从未被触碰——区块光照不会重新计算,也不会放置任何方块。当实体移动时,之前的方块会通过真实方块数据包进行还原,并发射新的方块。

由于原版 Minecraft 客户端仅了解基于方块级别的光照,动态光源本质上会吸附到方块网格上。簇和衰减设置可以使视觉过渡更柔和,但无法使光线完全连续——这需要像 LambDynamicLights 或 Optifine 的动态光源这样的客户端模组。

性能

在一个拥有约 30 只手持火把生物的 4 人测试服务器上,使用默认簇大小(3×2×3 = 每个发射器 18 个方块),每刻任务耗时 < 1 毫秒。如果您的服务器受 CPU 限制:

  • 设置 track_mobs: false 以跳过每刻的生物扫描。
  • 将 cluster_radius 降低至 0(单列而不是 3×3)。
  • 增加 update_interval_ticks 至 2(光源以 10 Hz 频率跟随实体,而不是 20 Hz)。

安装

  1. 将 DynamicLights-x.y.z.jar 放入服务器的 plugins/ 文件夹中。
  2. 重启服务器。
  3. 根据需要编辑 plugins/DynamicLights/config.yml。
  4. 执行 /dl reload。

许可证

专有软件 —— 保留所有权利。您可以在自己的 Minecraft 服务器上安装和运行未经修改的插件副本。未经书面许可,禁止重新分发、修改和逆向工程。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源