前车灯

🔦 车头灯全亮

一个为你的角色配备头戴式车头灯的 Minecraft 模组——内置全亮开关，并支持完整的多人游戏同步。

 

🇬🇧 English · 🇷🇺 Русский

---

关于

车头灯全亮为你的角色头部添加两道车头灯光束，并允许你通过按键一键开启全亮视野。光束会跟随你头部的旋转，被实心方块遮挡，并且服务器上的其他人都能看到——所以大家总能知道你的灯是否亮着。

Minecraft	1.21.1
模组加载器	NeoForge 21.1.244+
Java	21
模组 ID	headlights_fullbright
适用端	客户端与服务器（两端均需安装）
作者	peacefull02（又名 softboundless）

功能

• 🔦 两道头戴式光束，实时跟随你头部的偏航角和俯仰角
• 💡 一键全亮——车头灯亮起的瞬间，世界在你眼中立即变得明亮
• 🌐 多人游戏完全同步——其他人能看到你的光束，并知道你何时开启了灯光
• 👁️ 第一人称友好——在第一人称视角下隐藏，在第三人称和他人视角中可见
• 🧱 真实遮挡——光束会被实心方块阻挡，但可穿透水、玻璃和迷雾
• ⌨️ 可自定义按键——默认为 H 键，可在控制设置中更改
• 🕶️ 兼容光影——已通过 Complementary 和 BSL 验证

工作原理

• 开启车头灯会仅为你启用全亮效果——其他人的亮度不会改变，他们只会看到你的光束。
• 关闭车头灯会同时停用两者。
• 你的车头灯状态在死亡、受伤和传送（包括维度切换）后依然保持——只有重新连接世界或服务器时才会重置为关闭。
• 每道光束从头中部附近发出，延伸至最多 16 格，并沿长度方向平滑渐隐至透明。这是纯视觉效果——不会在方块上放置实际光源。

Freecam 兼容性

车头灯全亮可选与 Freecam Spectator 集成——这不是强制依赖，没有安装该模组也能正常运行。当 Freecam 的旁观者模式激活时，你的车头灯光束会跟随自由漂浮的旁观者头部，而不是停留在你原本冻结的身体上。

光影兼容性

已测试并确认兼容 Complementary 和 BSL。其他光影包很可能也正常，但尚未经过明确验证。

从源码构建

项目使用 Gradle 包装器，唯一的前置条件是 JDK 21。

./gradlew build        # 构建 jar → build/libs/
./gradlew runClient    # 启动客户端进行测试
./gradlew runServer    # 启动专用服务器进行测试

（Windows：使用 gradlew.bat 代替 ./gradlew）

基于官方 NeoForge MDK 模板构建，使用 ModDevGradle（而非 NeoGradle）。

许可证

本项目采用 Softboundless Mod 许可证 1.0 授权。 通常允许修改、再分发、分支、移植以及在整合包中使用。 但禁止在第三方 Minecraft 整合包中使用 Freakland 名称。 完整条款请参阅 LICENSE。

致谢

由 peacefull02（又名 softboundless）创作。