DynLight

插件

· 作者 def9a2a4

动态光照——手持或掉落的物品、发光或着火的生物、火焰箭等。可配置,并为其他插件提供 API。

0 本站下载 0 关注 更新于 2 周前

最新 0.1.0 · 26.3 · Paper / Purpur

一键开服(送7天)

一个基于实体的动态光照插件,支持与其他插件集成。

手持物品、掉落物、燃烧的生物以及其他实体都会发光。完全可配置,其他插件可以通过 API 或记分板标签定义自己的自定义发光实体。

功能

光源

  • 手持物品 - 火把、灯笼、萤石以及 40+ 种其他物品在手持时会发出光线
  • 掉落物品 - 地面上的物品会发出其对应的光照等级
  • 燃烧实体 - 任何着火的实体都会以可配置的强度发光
  • 火焰弹射物 - 燃烧的箭矢、火球和灵魂之箭会发出光线
  • 附魔装备 - 穿着附魔盔甲或手持附魔物品的玩家会发出微弱的光芒
  • 常亮实体 - 烈焰人、发光鱿鱼、岩浆怪和悦灵始终发出光线
  • 记分板标签光源 - 拥有 dynlight:<level> 记分板标签的任何实体都会发出光线,从而实现跨插件集成,无需编译时依赖

特殊机制

  • 水敏感性 - 基于火的物品(火把、营火)在水下会被熄灭,而防水物品(萤石、海晶灯)继续发光
  • 仅客户端渲染 - 光块基于数据包传输,不会修改世界。灵感来源于 DynamicLights
  • 按玩家切换 - 玩家可以单独在客户端启用/禁用动态光照
  • 异步渲染 - 光照计算在异步线程运行,对服务器影响最小

配置

性能设置:

# 更新间隔(单位:刻,20 刻 = 1 秒)
# 数值越小 = 更新越频繁 = 光照移动更平滑,但 CPU 占用更高
update-interval: 1

# 渲染动态光照的最大距离(单位:格)
render-distance: 96

# 检查实体火焰熄灭的频率(单位:刻,10 = 0.5 秒)
fire-sweep-interval: 10

启用或禁用特定的光源类型:

detection:
  held-items: true
  dropped-items: true
  burning-entities: true
  flaming-arrows: true
  enchanted-armor: true
  enchanted-items: true
  always-lit-entities: true
  tagged-entities: true

配置附魔装备的光照强度:

light-levels:
  enchanted-armor: 3
  enchanted-items: 3

配置物品如何发出光线:

items:
  TORCH:
    light: 10
    water-sensitive: true
  LANTERN:
    light: 12
    water-sensitive: false

具有水敏感性的物品在被淹没时将停止发光。

配置实体着火时如何发出光线:

entities:
  # 属性:基础光照、火焰光照、水平半径、高度
  BLAZE:
    base-light: 8    # 始终发出光线
    fire-light: 15
属性 描述 默认值
base-light 未着火时的光照等级(0 = 仅在燃烧时发光) 0
fire-light 着火时的光照等级 12
horizontal-radius 光柱半径(0=1x1,1=3x3,2=5x5) 1
height 光柱高度(单位:格) 2

光柱将放置一个光块——我们会比看起来更宽地搜索以避免障碍物,因为光块不能放置在藤蔓、高草、梯子等物体内部。

命令

命令 描述 权限
/dynlight help 显示可用命令 -
/dynlight enable 为你自己启用动态光照 dynlight.use
/dynlight disable 为你自己禁用动态光照 dynlight.use
/dynlight info 显示活动光源数量 dynlight.admin
/dynlight stats 显示详细统计信息 dynlight.admin
/dynlight reload 重新加载配置 dynlight.admin
/dynlight regen 重新生成所有光源 dynlight.admin

记分板标签光源

任何拥有匹配 dynlight:<level> 记分板标签的实体都会发出光线。无需 API 依赖——只需通过命令或其他插件添加标签即可。

格式: dynlight:<level> 或 dynlight:<level>:<radius>:<height>

参数 范围 描述
level 1–15 光照等级
radius 0–5 水平搜索半径(可选,默认来自实体配置)
height 1–10 垂直搜索高度(可选,默认来自实体配置)

示例:

/summon armor_stand ~ ~ ~ {Tags:["dynlight:15"]}
/summon armor_stand ~ ~ ~ {Tags:["dynlight:10:3:5"]}

注意:/tag 命令不支持标签名中的冒号——在召唤时使用 NBT Tags,或通过其他插件以编程方式添加标签。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源