FsDynamicLight

FsDynamicLight

此模组中的每束光都由资源包控制——物品和实体的光照等级存储在 assets/fsdynamiclight/ 目录下的纯 JSON 文件中，按下 F3+T 即可立即应用更改，无需重启游戏。

简而言之：手持物品、掉落物和燃烧中的生物会投射出平滑、自然衰减的动态光照，性能表现出色——而具体哪些物体会发光，完全由你决定。

动态光源

1. 基于方块的光源（自动）

任何具备静态默认光照等级且可放置为方块物品，在手持、穿戴或掉落时会自动发出对应光照——无需额外配置。原版的实际数值会在运行时从方块的默认状态（26.2）中测得：

光照等级	方块
15	信标、营火、潮涌核心、铜灯、斑驳的铜灯、氧化的铜灯、风化的铜灯、涂蜡的铜灯、涂蜡的斑驳铜灯、涂蜡的氧化铜灯、涂蜡的风化铜灯、荧石、南瓜灯、灯笼、光源方块、赭黄蛙明灯、珠光蛙明灯、海晶灯、菌光体、翠绿蛙明灯
14	铜火把、末地烛、火把
10	哭泣的黑曜石、灵魂营火、灵魂灯笼、灵魂火把
7	附魔台、末影箱、红石火把
6	海泡菜、幽匿催发体、宝库
5	紫水晶簇
4	大型紫水晶芽
3	岩浆块
2	萤火虫灌木丛、中型紫水晶芽
1	酿造台、棕色蘑菇、龙蛋、末地传送门框架、小型紫水晶芽、幽匿感测体、校频幽匿感测体

默认状态不可靠的动态光照方块（例如红石灯、铜灯泡、蜡烛）已被排除在此列表之外——如果你希望它们发光，请在配置文件中进行设置。

2. 自定义物品光照（配置文件）

没有默认方块光照但外观明显发光（或你想要覆盖默认设置的方块）的物品：

光照等级	物品
12	烈焰棒、发光浆果、荧石粉、熔岩桶
8	龙息、回响碎片、火焰弹、荧光墨囊
4	末影之眼、发光地衣、光灵箭
2	岩浆膏

3. 实体光照（配置文件）

实体没有默认光照——所有发光的实体都在这里定义：

光照等级	实体
12	悦灵、烈焰人、末影水晶、烟花火箭
8	龙焰、末影人、火球、发光鱿鱼、岩浆怪、循声守卫
4	嘎枝、潜影贝子弹、小火球、光灵箭

4. 运行时行为

行为	光照等级
燃烧中的实体（任何着火的生物或物品）	15
立方体生物（史莱姆 / 岩浆怪）	配置文件中的数值按体型大小缩放
生物实体的装备栏	检查全部 6 个栏位（主手、副手、盔甲）

配置

两个配置文件都是资源包内的纯 JSON 文件。请将你的资源包文件放置在：

• assets/fsdynamiclight/item_light/light_levels.json — 物品光照
• assets/fsdynamiclight/entity_light/light_levels.json — 实体光照

更改会在资源重载后生效——按下 F3+T 即可，无需重启。

格式

{
  "15": ["minecraft:glowstone", "minecraft:lantern"],
  "12": ["minecraft:blaze_rod", "minecraft:lava_bucket"],
  "8":  ["minecraft:glow_ink_sac"],
  "0":  ["minecraft:torch"]
}

字段	类型	描述
"0" ~ "15"	整数键	光照等级（0–15，15 为最高亮度）
值	字符串数组	应发出此光照的已注册物品或实体 ID

注意事项：

• 无效的光照等级和未知的 ID 会被跳过，并在日志中输出警告。
• 配置文件会覆盖自动方块光照：将物品设置为 "0"（或任何其他数值）会优先于其方块默认值，因此你可以调暗或调亮任何方块物品。
• 可放置为方块且具有静态默认光照的物品无需列入配置——它们本身就会发光。