Spatial GUI

一款客户端 Minecraft 模组，可将屏幕变为沉浸式 3D 显示，并支持完全可配置的第一人称和第三人称模式。

特性

通用

• 可视化编辑器
• 针对模组兼容性的逐屏幕启用和禁用列表
• 可选屏幕后方世界模糊
• 屏幕投影阴影
• 可配置的 HUD 和快捷栏可见性
• 可调节的 GUI 缩放、渲染缩放、屏幕不透明度和 FOV 感知缩放
• 屏幕打开动画
• FOV 覆盖
• 自动检测相机模式，根据视角切换相机模式

第一人称模式

• 准星和鼠标模式
• 屏幕位置、距离、缩放和旋转均可配置
• 可配置的屏幕打开动画
• 曲面屏幕选项，尤其适合添加大型 GUI 扩展的模组，例如 JEI

第三人称模式

• 相机和屏幕位置、距离、缩放和旋转均可配置
• 可配置的角色身体旋转
• 平滑相机过渡和可配置的屏幕打开动画
• 相机被遮挡时可选回退到第一人称

依赖

| 加载器 | 模组 |
|——–|———————–|
| 全部 | YACL |
| Fabric | Fabric API & Mod Menu |

配置

通过按键绑定（默认未绑定）、Mod Menu 或配置文件打开配置。
Spatial GUI 有许多选项，值得逐一查看，以便将模组调整到符合你的偏好。

对于高级用户和整合包作者，支持通过 config/spatial-gui/profiles.json5 进行逐屏幕配置档案。该文件包含文档说明。

可视化编辑器

Spatial GUI 内置可视化编辑器，可让你实时配置屏幕位置、缩放、旋转等。你还可以为不同屏幕创建和管理档案。在配置中按下按钮进入编辑器模式，或在控制中将其绑定到按键。

档案选择器

你可以为特定屏幕分配不同的编辑器档案。在屏幕打开时按下档案选择器按键（默认为反引号/波浪号）即可选择档案。

兼容性

Spatial GUI 是客户端模组，无需安装在服务端。

但是，并不保证与所有模组兼容。Spatial GUI 会修改 GUI 和相机渲染，这可能会与同样修改这些内容的模组冲突。

如果你发现与其他模组存在可复现的不兼容问题，请在 GitHub 上报告，以便进行调查。报告问题有助于让模组对所有人更好！

警告：不支持 Lunar Client。Lunar Client 会以与 Spatial GUI 不兼容的方式修改 Minecraft 的渲染效果。虽然它并非完全不兼容，大多数情况下仍可运行，但使用 Lunar Client 导致的问题将不予处理。

常见问题

| 问题 | 答案 |
|————————————————-|—————————————————————————————————————————————————————————————————————–|
| Spatial GUI 支持多人游戏吗？ | 支持。其他玩家和服务器都不需要安装 Spatial GUI。 |
| Spatial GUI 会带来游戏优势吗？ | Spatial GUI 主要用于视觉效果，不会添加或自动执行游戏机制。某些设置会改变摄像机的行为，因此是否允许在特定服务器上使用，取决于该服务器的规则。 |
| Spatial GUI 与 _____ 兼容吗？ | 应该兼容！不过无法保证兼容性，尤其是会修改 GUI、摄像机或渲染效果的模组。如果你遇到与某个特定模组相关的问题，欢迎在 GitHub 上反馈。 |
| 为什么我的 GUI 表现异常？ | 可能是其他已安装的模组不兼容。尝试找出相关模组，然后查看 GitHub 上现有的问题，或提交新问题并附上复现步骤。 |
| 为什么我的 GUI 模糊不清？ | 这通常是由其他模组或客户端导致的。试着找出造成问题的模组，或者在客户端设置中查找“模糊”和“背景”等选项。 |
| 我可以在整合包中使用 Spatial GUI 吗？ | 可以。欢迎在整合包中使用 Spatial GUI，无需额外授权。无法保证它与其他模组的兼容性。 |
| Spatial GUI 纯粹是视觉效果吗？ | 几乎完全是。Spatial GUI 会改变现有界面和摄像机的呈现方式。有一项设置会让你的视角在关闭 GUI 后继续保持旋转，因此可能会改变角色的朝向。 |

备注

• 欢迎在 GitHub 上提出功能建议或报告漏洞。
• 欢迎在整合包中使用 Spatial GUI，无需额外授权。请注意，它与部分模组的兼容性可能有所不同。

特别感谢：

vibing：贡献了所有 GitHub 代码
Dizabanik：修复了大量代码问题并进行了改进
BUILDLCS：提供巴西葡萄牙语翻译
suheckii：提供俄语翻译
22SSendo & jankeverse：提出了特别棒的功能建议
以及所有报告漏洞或提出功能建议的人 🙂