Better Light

模组

· 作者 KaiStudio

Better Light 为 Minecraft 带来了沉浸式的便携照明体验。

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

最新 1.20.x-1.0.1 · 1.20.6 · Forge

一键开服(送7天)

Better Light

Better Light 为 Minecraft 带来了沉浸式、可便携的照明体验。将灯笼挂在腰间,双手自由;行走、奔跑和跳跃时,它会自然摆动;只需右键点击即可直接从地面拾取火把或灯笼,无需破坏和重新放置。

该模组旨在成为原版生存的自然延伸——无需制作新方块,没有臃肿的用户界面,只是在你已有的物品上叠加更智能、更具物理感的照明方式。它轻量且完全支持多人游戏,所有 gameplay 效果均在服务端运行,仅视觉效果由客户端处理。

功能

? 动态光照

你手持或佩戴在腰间的任何发光物品都会向世界中投射真实的光线,而不仅仅是照亮你的手。光线平滑地渐入渐出,而非生硬地开关,并随你的移动而跟随。它自动识别任何原版或模组中的发光物品。当光源位于腰间而非手中时,亮度会适当降低,并受可配置的最大半径限制。

? 腰带槽位

将火把或灯笼固定在腰带上以解放双手照明。按住 Shift 并右键点击空气(手中持有光源或已装备)可装备或卸下,或在控制菜单中绑定专用热键(默认:N)。装备的物品会在角色模型上清晰可见,并在你移动、转身和跳跃时根据其惯性摆动——详见下方的 物理效果。

?️ 即时拾取

右键点击已放置的火把、灵魂火把、灯笼或灵魂灯笼,即可直接将其收入背包——无需挖掘动画,不会意外破坏方块,也不需要工具。

? 可见装备渲染

腰带上的灯笼不仅仅是一个状态效果——它会在你的角色模型上渲染(兼容默认皮肤和窄体皮肤),位置和角度经过调整,自然地置于臀部高度。

?️ 摆动物理效果

两套独立的基于弹簧的物理系统让灯笼感觉栩栩如生:

  • 腰带灯笼物理 — 响应你自己的移动和视角转动,可配置强度、刚度、阻尼和最大摆动角度。
  • 悬挂灯笼物理 — 世界中任何悬挂在链条上的灯笼都会在模拟风中摇摆,考虑雨水、雷暴和夜间以增加运动感,而在下界或末地藏起来的灯笼则几乎静止不动。悬挂灯笼上方的链条会与其作为一个整体刚性单摆一起移动,最多达到可配置的链条长度。

? 怪物对光的反应

可选地,腰间点亮的灯笼会让附近的怪物更容易从更远的地方注意到你——但光线也会削弱它们,当它们在附近徘徊时施加周期性的虚弱效果。检测范围、追踪范围加成和虚弱增幅均可配置,并且可以完全关闭此效果。

✨ 装饰性彩色光晕(API)

其他模组可以为自己的发光物品注册自定义光晕颜色。由于 Minecraft 的光照引擎只支持单一亮度值(不支持全 RGB),这通过物品附近的微妙粒子效果实现,而非真正的彩色光——但对于拥有自定义灯笼的整合包来说,这是一个不错的点缀。

⚙️ 完全可配置

上述几乎所有数值——亮度、半径、更新频率、腰带位置和旋转、摆动手感、风力、怪物效果范围——都通过 Forge 的配置系统暴露出来,并可针对每个世界(公共设置)或每个客户端(仅限客户端的渲染选项)进行调整。在游戏中,物品栏中的齿轮按钮还会打开一个快速设置屏幕,用于实时调整腰带高度、侧向偏移、前向偏移和旋转。

控制

操作 默认值
切换腰带灯笼(装备/卸下) Shift + 右键(空手)
切换腰带灯笼(热键) N (可禁用/重新绑定)
打开腰带设置 物品栏屏幕中的齿轮按钮
拾取已放置的火把/灯笼 右键点击方块

配置

Better Light 将其设置分为两个配置文件,首次启动时在 config/ 目录下生成:

公共 (betterlight-common.toml) — 服务端权威,影响所有玩家:

  • dynamicLightEnabled, multiplayerEnabled, updateIntervalTicks
  • brightnessMultiplier, maxLightLevel, beltDimming
  • itemLightOverrides — 添加或覆盖任何物品的亮度等级,例如 "minecraft:blaze_rod=8"
  • instantTorchPickup
  • monsterLightEffectEnabled, monsterLightDetectionRange, monsterLightDetectionBonus, monsterLightWeaknessAmplifier, monsterLightWeaknessDurationTicks

客户端 (betterlight-client.toml) — 本地渲染和手感,玩家之间不同步是安全的:

  • 腰带定位:beltHeightOffset, beltSideOffset, beltForwardOffset, beltRotationOffset, useKeybindForBelt
  • 腰带摆动物理:swingEnabled, swingIntensity, swingStiffness, swingDamping, swingMaxAngle
  • 悬挂灯笼物理:hangingLanternPhysicsEnabled,风力/速度/刚度/阻尼/最大角度/最大速度,影响距离,最大链条长度,以及雨、雷暴和夜间的乘数
  • 装饰性彩色光晕:coloredLightEnabled,粒子间隔,粒子缩放

大多数玩家永远不需要触碰这些文件——默认设置开箱即用,感觉恰到好处——但它们为那些想要微调性能或手感的人,或为调整平衡的整合包作者提供了便利。

面向模组开发者

Better Light 提供了一个小型公共 API(com.kaistudio.betterlight.api.IBetterLightAPI),供其他模组接入,可通过 BetterLightAPI.getInstance() 获取。它允许其他模组:

  • 注册或注销物品作为自定义光源,并设置其光照等级
  • 将自定义方块注册为动态光源
  • 读取或设置玩家腰带上的物品,或以编程方式切换它
  • 查询当前配置状态(是否启用动态光、摆动设置、怪物效果设置等)
  • 为发光物品注册装饰性发光颜色
  • 查询给定位置的风力暴露情况,以便将自定义效果(如蜡烛闪烁)与 Better Light 用于悬挂灯笼的风力模拟同步
IBetterLightAPI api = BetterLightAPI.getInstance();
if (api != null) {
    api.registerLightSource("mymod:glowing_item", 12);
    api.registerColoredLightSource("mymod:glowing_lantern", 0.2f, 0.6f, 1.0f);
    api.togglePlayerBelt(player);
}

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源