Minecraft Borderless Window
一个面向 NeoForge 1.21.1 的轻量级客户端模组,为 Minecraft 添加了无边框全屏功能,用一套完整的三模式系统取代了独占全屏切换——同时提供了一系列 Minecraft 原生未暴露的视频与生活质量选项。
功能特性
窗口设置
- 三种屏幕模式:窗口化、无边框以及 Minecraft 原生的独占全屏。
- 可配置的 F11 键:用于切换无边框、切换独占全屏,或循环遍历所有三种模式。
- HDR 友好:避免了在启用 Windows HDR 时,独占全屏(以及粗糙的无边框实现)所导致的黑屏闪烁和色彩配置文件切换问题。
- 多显示器感知:应用效果基于窗口当前所在的显示器,而非始终作用于主显示器。
视频与生活质量
- FPS 叠加层:显示当前 FPS,或在最近 15 秒内以单行显示最小/平均/最大 FPS。支持屏幕任意角落。它直接采样游戏自身的计数器,因此始终与 F3 界面一致,并尊重垂直同步(VSync)和帧率限制;当 F3 界面打开时,该叠加层会自动隐藏。
- 雾气开关:地形雾(距离雾化效果,包括下界浓重的雾气)、水面、熔岩和细雪均可独立控制。失明和黑暗状态带来的雾气效果不受影响,以确保这些状态效果按预期工作。
- 云层高度:可在 y=64 至 y=320 之间调整云层高度。在默认设置下,每个维度保持其自身的高度;完全没有云层的维度——如下界、末地以及其他模组的无云维度——无论设置如何,均保持无云状态。
- 屏幕覆盖层移除:可移除游泳时覆盖在视野上的水纹纹理,以及燃烧时覆盖在视野上的火焰纹理。火焰还提供智能模式,仅在拥有防火抗性时隐藏火焰。在实体方块内部显示的窒息覆盖层不受此功能影响。
- 视角晃动分离:Minecraft 会统一开启或关闭所有视角晃动。在此模组中,摄像机和手持物品的晃动是独立的,摄像机还增加了一种仅垂直模式,保留上下颠簸但消除左右摇摆和倾斜——地平线保持水平,而这正是导致大多数人晕动症的主要原因。
配置与兼容性
- 内置配置界面:可从模组菜单更改所有设置(选择模组 → 点击 Config 按钮)。无需其他模组支持。
- Sodium 集成(可选):安装 Sodium 0.8.x 后,其视频设置中的“全屏”复选框将被替换为“屏幕模式”选择器,且本模组会在其配置界面中获得专属分区及每功能的详细页面。完全基于 Sodium 官方 Config API 构建——无需依赖脆弱且侵入性强的 Mixin 来修改 Sodium 内部逻辑。同时也兼容 Reese's Sodium Options。
- 零强制依赖:无论是否安装 Sodium 均可正常运行。
- 持久化保存:所有设置均在会话之间保持记忆(保存在
config/borderlesswindow.json)。
- 多语言支持:所有字符串均位于标准语言文件中(已包含
en_us、es_mx、es_es——欢迎贡献翻译)。
为什么需要无边框?
独占全屏会改变显示器实际的显示模式,从而导致 Alt+Tab 切换缓慢、HDR 模式下出现黑屏闪烁、分辨率不同步错误,以及游戏重启时窗口状态异常。无边框全屏实际上是一个大小与显示器匹配且无装饰边框的窗口:视觉效果完全一致,但 Alt+Tab 切换即时响应,且永远不会出现分辨率不同步的问题。
配置说明
- 游戏中(无 Sodium): 模组菜单 → Borderless Window → Config。所有选项集中在一个按功能分组的可滚动列表中:窗口、FPS 叠加层、雾气、云层、屏幕覆盖层和晃动。更改立即生效。
- 游戏中(有 Sodium): 视频设置 → “Screen Mode” 选项(替换 Sodium 的全屏复选框)以及包含六个页面的“Borderless Window”分区。
- 配置文件:
config/borderlesswindow.json。如果模组陷入某种奇怪的状态,请删除此文件并重新启动——默认值将安全重新生成。
所有设置默认还原为原版行为,因此安装或更新本模组不会在游戏外观上产生任何变化,除非你主动进行设置。
关于晃动的说明: 摄像机和手部选项是对 Minecraft 原生“视角晃动”设置的细化,而非替代。如果在 Minecraft 的视频设置中将“视角晃动”关闭,则不会有任何晃动效果,这两个选项也将不再生效。
要求
- Minecraft 1.21.1
- NeoForge 21.1.x
- (可选)Sodium 0.8.0+ 用于视频设置集成
许可证
MIT LICENSE
Minecraft Borderless Window
A lightweight client-side mod for NeoForge 1.21.1 that adds borderless fullscreen to Minecraft, replacing the exclusive fullscreen toggle with a proper 3-mode system — plus a set of video and quality-of-life options Minecraft doesn't expose.
Features
Window
- Three screen modes: Windowed, Borderless, and Minecraft's regular exclusive Fullscreen.
- Configurable F11: toggle Borderless, toggle exclusive Fullscreen, or cycle through all three modes.
- HDR-friendly: avoids the black-screen flash and colour profile switch that exclusive fullscreen (and naive borderless implementations) cause with Windows HDR enabled.
- Multi-monitor aware: applies on the monitor the window is currently on, not always the primary one.
Video and quality of life
- FPS overlay: the current FPS, or a single line with the Min / Avg / Max over the last 15 seconds. Any screen corner. It samples the game's own counter, so it always matches F3 and respects VSync and FPS caps, and it hides itself while F3 is open.
- Fog toggles: Terrain (the distance haze, including the Nether's thick fog), Water, Lava and Powder Snow, each independent. Fog from Blindness and Darkness is never affected, so those effects still work as intended.
- Cloud height: raise or lower the cloud layer between y=64 and y=320. On Default every dimension keeps its own height, and dimensions with no clouds at all — the Nether, the End, cloudless dimensions from other mods — stay that way at any setting.
- Screen overlays: remove the water texture drawn over your view while swimming, and the flames drawn while burning. Fire also has a smart mode that hides the flames only while Fire Resistance is active. The suffocation overlay shown inside solid blocks is never touched.
- Split view bobbing: Minecraft turns bobbing on or off for everything at once. Here the camera and the held item are separate, and the camera adds a Vertical Only mode that keeps the up-and-down bounce while removing the sway and the tilt — the horizon stays level, which is the part that causes motion sickness for most people.
Configuration and compatibility
- Config screen included: change everything from the Mods menu (select the mod → Config button). No other mod needed.
- Sodium integration (optional): with Sodium 0.8.x installed, the "Fullscreen" checkbox in its video settings is replaced by a "Screen Mode" selector, and the mod gets its own section with per-feature pages. Built entirely on Sodium's official Config API — no fragile mixins into Sodium internals. Also plays nice with Reese's Sodium Options.
- Zero required dependencies: works with or without Sodium.
- Persistent: all settings are remembered between sessions (
config/borderlesswindow.json).
- Translatable: all strings live in standard lang files (
en_us, es_mx, es_es included — contributions welcome).
Why borderless?
Exclusive fullscreen changes your monitor's actual display mode, which causes slow alt-tabbing, black-screen flashes with HDR, resolution desync bugs, and broken window states when the game restarts. Borderless fullscreen is just a window sized to your monitor with no decorations: it looks identical, but alt-tab is instant and nothing ever desyncs.
Configuration
- In game (no Sodium): Mods menu → Borderless Window → Config. Every option lives in one scrollable list grouped by feature: Window, FPS Overlay, Fog, Clouds, Screen Overlays and Bobbing. Changes apply instantly.
- In game (with Sodium): Video Settings → the "Screen Mode" option (replaces Sodium's fullscreen checkbox) and the "Borderless Window" section with its six pages.
- Config file:
config/borderlesswindow.json. If the mod ever gets stuck in a weird state, delete this file and restart — defaults are regenerated safely.
Every setting defaults to vanilla behavior, so installing or updating the mod never changes how the game looks until you ask it to.
Note on bobbing: the camera and hand options refine Minecraft's own "View Bobbing" setting rather than replacing it. With View Bobbing turned off in Minecraft's video settings, nothing bobs and these two options have no effect.
Requirements
- Minecraft 1.21.1
- NeoForge 21.1.x
- (Optional) Sodium 0.8.0+ for the video settings integration
License
MIT LICENSE
评论 0
登录后参与评分
还没有评论,来抢沙发吧