无边框方块

无边框方块图标

一个允许你在无边框全屏窗口中游玩 Minecraft 的模组。这意味着你可以在另一台显示器上与其他应用交互时保持游戏开启，甚至可以直接在 Minecraft 窗口上方进行操作，而不会让游戏最小化。

与其他“无边框全屏”模组不同，无边框方块拥有高度可配置性，不会增加你的输入延迟，并且明确支持所有主流平台——Linux、macOS，甚至 Windows，而不是只为某一类玩家提供勉强可用的体验，同时让其他玩家仿佛不存在一样。

使用方法

若要启用非独占全屏，请前往通常可以找到 Fullscreen 设置的 Video Settings 选项卡，然后将其切换为新增的选项之一：Borderless 或 Windowed——选择最适合你的即可。

根据你是否安装了 Sodium，你可能会在以下位置之一找到这些选项：

| 视频设置 | 视频设置（Sodium） |
| – | – |

此外，该模组还加入了两个新的启动参数 --borderless 和 --windowed，无论你当前的设置如何，它们都会分别强制游戏以无边框或窗口化全屏模式启动。

常见问题

我是 Windows 用户，而且……

这确实是个问题，我的朋友！不过说真的，如果你在使用无边框全屏时遇到问题，可以切换到窗口化全屏，看看哪种模式对你来说效果更好。

此外，通常建议将 CWB 与 Sodium 搭配使用，因为它可以修复许多硬件和驱动特有的问题，否则这些问题可能会影响你的使用体验。

在 Windows 上启用全屏后，我在物品栏中看不见鼠标光标。

如前文所述，你可以在视频设置中切换到窗口化全屏，因为标准全屏模式似乎无法在你的系统上正常工作。

不过值得注意的是，你所遇到的问题并非模组本身的问题，而是你系统的问题，你或许能够自行修复。人们经常报告在 Windows 上玩游戏时光标变得不可见，常见于以下场景：

使用 Medal 时
在 Windows 11 上使用 OBS，并为来源启用了 “Windows 10+ 捕获方法” 时
在控制面板中启用了 “显示指针轨迹” 选项时
由于常见原因，例如驱动程序损坏和/或过时

该模组似乎无法与 Sodium 配合使用。

请确保你已安装 Sodium 和 CWB 的最新版本，并确认 Sodium 设置中的 Fullscreen Mode 选项提供了四个选项：Off、Exclusive、Borderless 和 Windowed。如果缺少其中任何一个，或者该设置本身只是一个简单的开关，那么你使用的模组版本已经过时。

不过别担心！即使你无法更新，也始终可以通过按下 Ctrl + Shift + P 从 Sodium 的自定义界面访问原版视频设置——在那里你就能找到修改过的全屏设置。

事实上，如果你只是通过按下 F11 来切换全屏，例如，你应该会立即直接进入无边框模式，因为它默认被设置为你的首选全屏模式。

在 Linux 上，我想让浏览器打开的画中画窗口保持在游戏窗口之上。然而，当我将焦点切回 Minecraft 时，它总是跑到游戏窗口后面。

由于 FreeDesktop 规范定义的堆叠顺序，符合规范的桌面环境（如 KDE Plasma （罕见的 GNOME 胜利））会将画中画窗口置于获得焦点的全屏应用程序之后。幸运的是，你始终可以通过窗口规则来更改想要保持在游戏上方的窗口所分配的层级。以下是为 Firefox 执行此操作的示例：

KDE Plasma 窗口规则示例

配置

该模组提供了一个简单的配置界面，如果你安装了 YACL 或 Cloth Config，即可访问该界面：

模组设置

否则，你可以通过直接编辑 cwb.json 文件来进行配置，该文件存储在模组加载器的默认配置目录中：

{
    // 指定游戏应以窗口化、独占全屏、无边框全屏还是窗口化全屏模式启动。
    //
    // 应为以下之一："OFF"、"EXCLUSIVE"、"BORDERLESS" 或 "WINDOWED"。
    "fullscreenMode": "OFF",

    // 指定当玩家尝试使用快捷键（例如 F11）切换到全屏时，
    // 游戏应进入独占全屏模式还是无边框全屏模式。
    //
    // 应为 "EXCLUSIVE"、"BORDERLESS" 或 "WINDOWED" 之一。
    "preferredFullscreenMode": "BORDERLESS",

    // 指定是否推迟进入全屏模式，直到 Minecraft 完全加载完毕。
    //
    // 启用此选项可能会带来更流畅的启动过程，并且可以修复某些罕见问题：
    // 在驱动程序有缺陷的系统上，某些窗口无法立即以不同于默认分辨率的分辨率进入全屏模式。
    "useDelayedFullscreen": true,

    // 指定在屏幕坐标可相对于像素坐标进行缩放的平台上（例如 macOS 和 Wayland (Linux)），
    // 是否使用全分辨率帧缓冲。
    //
    // 禁用此选项可能会显著提升性能，但会牺牲图像质量。
    "useScaledFramebuffer": true,

    // 在受支持的平台（例如 macOS）上，指定在非独占全屏模式下是否自动隐藏 Dock，
    // 以便通过将鼠标移到屏幕边缘来显示它，而不是完全禁用它。
    "autoHideDock": false,

    // 在受支持的平台（例如 macOS）上，指定在非独占全屏模式下是否自动隐藏菜单栏，
    // 以便通过将鼠标移到屏幕边缘来显示它，而不是完全禁用它。
    "autoHideMenuBar": false,

    // 当启用 "pauseOnLostFocus" 时，指定其效果是否也应适用于多人游戏会话，
    // 在这些会话中游戏无法真正暂停。
    //
    // 注意："pauseOnLostFocus" 是原版选项，应在标准的 "options.txt" 文件中查找。
    "pauseOnLostFocusDuringMultiplayer": true,

    // 控制当 "fullscreenMode" 设置为 "EXCLUSIVE" 时启用哪种全屏模式。
    "exclusiveFullscreenType": "@default",

    // 控制当 "fullscreenMode" 设置为 "BORDERLESS" 时启用哪种全屏模式。
    "borderlessFullscreenType": "@borderless",

    // 控制当 "fullscreenMode" 设置为 "WINDOWED" 时启用哪种全屏模式。
    "windowedFullscreenType": "@windowed",

    // 提供针对 Linux 操作系统的配置覆盖。
    // 此部分中定义的属性优先于其顶层对应项。
    "linux": {
        "exclusiveFullscreenType": "minecraft:default",
        "borderlessFullscreenType": "linux:borderless",
        "windowedFullscreenType": "minecraft:maximized"
    },

    // 提供针对 macOS 操作系统的配置覆盖。
    // 此部分中定义的属性优先于其顶层对应项。
    "macos": {
        "exclusiveFullscreenType": "minecraft:default",
        "borderlessFullscreenType": "macos:borderless",
        "windowedFullscreenType": "macos:windowed"
    },

    // 提供针对 Windows 操作系统的配置覆盖。
    // 此部分中定义的属性优先于其顶层对应项。
    "windows": {
        "exclusiveFullscreenType": "minecraft:default",
        "borderlessFullscreenType": "minecraft:windowed",
        "windowedFullscreenType": "windows:windowed"
    }
}

全屏类型

| 名称 | 描述 |
|——|————-|
| minecraft:default | Minecraft 的默认独占全屏模式。

该模式具有出色的性能和极低的延迟，但易用性较差——每当游戏窗口失去焦点时，游戏都会自动最小化。 |
| minecraft:windowed | 一种窗口化全屏模式，其性能和用户体验特性因平台而异。

在 Windows 上，这通常是游玩游戏的最佳方式，因为它能够提供无边框全屏体验的典型优势，同时几乎不会带来性能和延迟损失；不过，一些用户可能会遇到每当游戏窗口获得或失去焦点时出现恼人的闪烁问题。

在 其他平台 上，此模式可能导致明显的性能下降和/或易用性问题，例如系统程序坞始终可见，甚至显示在游戏画面之上。 |
| minecraft:maximized | 一种窗口化全屏模式，会将游戏变为最大化的无边框窗口。

此模式的性能和用户体验特性可能因平台而异，但通常可以预期其延迟会略高于默认的独占全屏模式，因为大多数常用的窗口合成器都会对所有窗口化应用施加隐式 V-Sync。

最适合搭配已禁用程序坞和/或菜单栏、或设置为自动隐藏的系统使用，也适合喜欢让它们保持可见的玩家。 |
| linux:borderless | Linux 和其他类 Unix 系统的默认无边框全屏模式。

该模式具有出色的性能和极低的延迟，且没有已知缺点。 |
| macos:borderless | macOS 的默认无边框全屏模式。

该模式的性能尚可，但由于操作系统会对所有窗口化应用施加隐式 V-Sync，其延迟会略高于默认的独占全屏模式。 |
| macos:windowed | macOS 的默认窗口化全屏模式。

与 macos:borderless 不同，此模式会始终保留菜单栏可见，这对于不喜欢新款 MacBook 上的刘海遮挡部分游戏画面的用户可能很有用。

该模式的性能尚可，但由于操作系统会对所有窗口化应用施加隐式 V-Sync，其延迟会高于独占全屏模式。 |
| windows:windowed | Windows 的默认窗口化全屏模式。

与 minecraft:windowed 不同，此模式不会出现闪烁问题，但也不具备该模式的性能优势。

由于 Windows 会对所有窗口化应用施加隐式 V-Sync，其延迟高于默认的独占全屏模式。此外，一些用户可能会遇到严重的性能下降，因为 Windows 有时会丢弃窗口化应用提供的帧，而不是将其渲染出来，尤其是在执行 Windows 认为比渲染这些帧更重要的后台任务时，例如下载更新，或为 Windows Recall 截取的活动截图建立索引。 |

“AI”政策

本项目（以及我的其他任何项目）不接受由“AI”生成或借助“AI”完成的贡献。

虽然许可证并未禁止此类行为，但我希望自己的作品能够以最真实的开源形式存在——让所有人都可以修改和再分发。因此，我请求你不要将我的项目用作训练数据，也不要使用上述技术修改它们，即使只是出于严格的个人用途。

正如这个世界中经常发生的那样，违反我的意愿不会受到任何后果。唯一的例外，是这会让我更加确信普通“AI”用户的本质确实如此。

许可证

根据MIT 许可证的条款授权。

Cubes Without Borders

截图

介绍