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);
}
Better Light
Better Light brings immersive, portable lighting to Minecraft. Clip a lantern to your belt and keep both hands free, watch it sway naturally as you walk, run, and jump, and grab torches or lanterns straight off the ground with a single right-click instead of breaking and re-placing them.
The mod is built to feel like a natural extension of vanilla survival — no new blocks to craft, no bulky UI, just smarter, more physical lighting layered on top of the items you already use. It's lightweight and fully multiplayer-friendly, with every gameplay effect running on the server and only the visuals handled client-side.
Features
? Dynamic lighting
Any light-emitting item you're holding — or wearing on your belt — casts real light into the world, not just onto your hand. Light fades smoothly in and out rather than snapping on and off, follows you as you move, and automatically respects any vanilla or modded item that emits light. It also dims appropriately when the source is on your belt rather than in your hand, capped by a configurable maximum radius.
? Belt slot
Attach a torch or lantern to your belt to light your way hands-free. Equip or unequip it by holding Shift and right-clicking with empty air (with a light source in hand, or already worn), or bind a dedicated hotkey (default: N) from the Controls menu. The equipped item is visibly modeled on your character and swings with its own inertia as you move, turn, and jump — see Physics below.
?️ Instant pickup
Right-click a placed torch, soul torch, lantern, or soul lantern and it's collected straight into your inventory — no mining animation, no accidental block breaking, no tool required.
? Visible equipment rendering
The lantern on your belt isn't just a stat effect — it's rendered on your character model (compatible with both default and slim skins), positioned and angled to sit naturally at hip level.
?️ Swinging physics
Two independent spring-based physics systems make lanterns feel alive:
- Belt lantern physics — reacts to your own movement and camera turns, with configurable intensity, stiffness, damping, and maximum swing angle.
- Hanging lantern physics — any lantern hung from a chain in the world sways in a simulated wind, factoring in rain, thunderstorms, and nighttime for extra motion, while lanterns tucked away in the Nether or the End stay nearly still. Chains above a swinging lantern move together with it as a single rigid pendulum, up to a configurable chain length.
? Monsters react to light
Optionally, a lit lantern on your belt makes you easier for nearby monsters to notice from farther away — but the light also weakens them, applying a periodic Weakness effect while they linger nearby. Detection range, the follow-range bonus, and the Weakness amplifier are all configurable, and the effect can be turned off entirely.
✨ Decorative colored glow (API)
Other mods can register a custom glow color for their own light-emitting items. Since Minecraft's lighting engine only supports a single brightness value (not full RGB), this is implemented as a subtle particle effect near the item rather than true colored light — but it's a nice finishing touch for modpacks with custom lanterns.
⚙️ Fully configurable
Nearly every number above — brightness, radius, update frequency, belt position and rotation, swing feel, wind strength, monster-effect ranges — is exposed through Forge's config system and tunable per-world (common) or per-client (client-only rendering options). In-game, an in-inventory gear button also opens a quick settings screen for adjusting belt height, side offset, forward offset, and rotation on the fly.
Controls
| Action |
Default |
| Toggle belt lantern (equip/unequip) |
Shift + Right-click (empty hand) |
| Toggle belt lantern (hotkey) |
N (can be disabled/rebound) |
| Open belt settings |
Gear button in the inventory screen |
| Pick up a placed torch/lantern |
Right-click the block |
Configuration
Better Light splits its settings into two config files, generated on first launch under config/:
Common (betterlight-common.toml) — server-authoritative, affects all players:
dynamicLightEnabled, multiplayerEnabled, updateIntervalTicks
brightnessMultiplier, maxLightLevel, beltDimming
itemLightOverrides — add or override light levels for any item, e.g. "minecraft:blaze_rod=8"
instantTorchPickup
monsterLightEffectEnabled, monsterLightDetectionRange, monsterLightDetectionBonus, monsterLightWeaknessAmplifier, monsterLightWeaknessDurationTicks
Client (betterlight-client.toml) — local rendering and feel, safe to differ between players:
- Belt positioning:
beltHeightOffset, beltSideOffset, beltForwardOffset, beltRotationOffset, useKeybindForBelt
- Belt swing physics:
swingEnabled, swingIntensity, swingStiffness, swingDamping, swingMaxAngle
- Hanging lantern physics:
hangingLanternPhysicsEnabled, wind strength/speed/stiffness/damping/max angle/max velocity, influence distance, max chain length, and weather/time-of-day multipliers for rain, thunder, and night
- Decorative colored glow:
coloredLightEnabled, particle interval, particle scale
Most players will never need to touch these files — the defaults are tuned to feel right out of the box — but they're there for anyone who wants to fine-tune performance or feel, or for pack authors adjusting balance.
For Mod Developers
Better Light exposes a small public API (com.kaistudio.betterlight.api.IBetterLightAPI) for other mods to hook into, retrieved via BetterLightAPI.getInstance(). It lets other mods:
- Register or unregister an item as a custom light source, with its own light level
- Register a custom block as a dynamic-light source
- Read or set a player's belt item, or toggle it programmatically
- Query the current config state (dynamic light enabled, swing settings, monster-effect settings, etc.)
- Register a decorative glow color for a light-emitting item
- Query wind exposure at a given position, to sync custom effects (like a candle flicker) with the same wind simulation Better Light uses for hanging lanterns
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
登录后参与评分
还没有评论,来抢沙发吧