无边框窗口

无边框窗口

一个用于 NeoForge 1.21.1 的轻量级客户端模组，为 Minecraft 添加无边框全屏功能，将独占全屏切换替换为完善的三模式系统——外加一系列 Minecraft 未提供的视频和便利性选项。

功能特性

窗口

• 三种屏幕模式：窗口化、无边框，以及 Minecraft 常规的独占全屏。
• 可配置 F11 按键：切换无边框、切换独占全屏，或循环切换全部三种模式。
• HDR 友好：避免独占全屏（以及简陋的无边框实现）在启用 Windows HDR 时导致的黑屏闪烁和色彩配置文件切换。
• 多显示器感知：应用于窗口当前所在的显示器，而非总是一号主显示器。

视频与便利性

• FPS 浮层：显示当前 FPS，或在最近 15 秒内以单行显示最小/平均/最大 FPS。可置于任意屏幕角落。它采样游戏自身的计数器，因此始终与 F3 一致，并且尊重垂直同步和 FPS 上限；当 F3 打开时它自动隐藏。
• 雾效开关：地形（距离雾，包括下界的浓雾）、水、熔岩和细雪，各自独立控制。失明和黑暗效果产生的雾永远不会受影响，因此这些状态效果仍能按预期工作。
• 云层高度：在 Y=64 与 Y=320 之间升高或降低云层。设为“默认”时，每个维度保持各自的高度；而在完全没有云层的维度——如下界、末地，以及来自其他模组的无云维度——在任何设置下都保持原样。
• 屏幕覆盖层：移除游泳时覆盖在视野上的水纹理，以及燃烧时绘制的火焰纹理。火焰还有一个智能模式，仅在拥有防火效果时隐藏火焰。在固体方块内显示的窒息覆盖层永远不会被改动。
• 视角摆动分离：Minecraft 会同时开关所有内容的摆动。此处可将视角与手持物品的摆动分开设置，并且视角模式增加仅垂直选项，保留上下晃动的同时移除摇晃和倾斜——地平线保持水平，这正是大多数人感到晕动的部分。
• 附魔等级数字显示：Minecraft 只内置到 X 的罗马数字，超出部分会显示类似 enchantment.level.11 的原始文本——而等级最高可达 255。此功能修复了该问题，并允许你选择显示样式：X 以上使用罗马数字、更高的使用阿拉伯数字；始终使用罗马数字；或始终使用数字。已提供高等级翻译的资源包仍可继续正常工作。

配置与兼容性

• 内置配置界面：可从模组菜单（选择模组 → 配置按钮）更改所有选项。无需其他模组。
• Sodium 集成（可选）：当安装了 Sodium 0.8.x 时，其视频设置中的“全屏”复选框会被替换为“屏幕模式”选择器，并且本模组会获得一个具有按功能分页的独立分区。完全基于 Sodium 官方的 Config API 构建——没有对 Sodium 内部实现使用脆弱的 mixin。同时与 Reese's Sodium Options 兼容。
• 零强制依赖：无论是否安装 Sodium 均可运行。
• 持久化：所有设置都会在会话之间保留（config/borderlesswindow.json）。
• 可翻译：所有文本均位于标准语言文件中（包含 en_us、es_mx、es_es——欢迎贡献翻译）。

为何选择无边框？

独占全屏会改变显示器实际的显示模式，这会导致切换窗口缓慢、HDR 黑屏闪烁、分辨率失步错误，以及游戏重启时窗口状态异常。无边框全屏只是一个尺寸与显示器相同且没有装饰的窗口：外观上完全相同，但切换窗口是即时的，且永远不会出现失步问题。

配置

• 游戏中（无 Sodium）：模组菜单 → 无边框窗口 → 配置。所有选项集中在一个可按功能分组的可滚动列表中：窗口、FPS 浮层、雾、云、屏幕覆盖层、摆动和附魔等级显示样式。更改即时生效。
• 游戏中（有 Sodium）：视频设置 → “屏幕模式”选项（替换 Sodium 的全屏复选框）以及“无边框窗口”分区，内含七个页面。
• 配置文件： config/borderlesswindow.json。如果模组陷入异常状态，删除此文件并重启——默认设置会被安全地重新生成。

每个设置都默认为原版行为，因此安装或更新模组永远不会改变游戏的外观，除非你主动要求。

关于摆动的说明：视角和手持物品选项是细化 Minecraft 自身的“视角摆动”设置，而非替代它。若在 Minecraft 的视频设置中关闭“视角摆动”，则所有摆动都会消失，这两个选项也将无效。

需求

• Minecraft 1.21.1
• NeoForge 21.1.x
• （可选）Sodium 0.8.0+ 用于视频设置集成

许可证

MIT 许可证