旋转 - 更好的第三人称与自由视角相机

Swivel 是一个适用于 Minecraft 的小型客户端模组，支持 Fabric、NeoForge 和 Forge，并兼容 Fabric 上的 Mod Menu。

支持的版本：Fabric 上为 1.20 至 26.3，NeoForge 上为 1.21 至 26.3，Forge 上为 1.20.1。

功能

第三人称

• 环绕相机 - 在背后第三人称视角（F5）下，鼠标会围绕你的角色摆动相机，而不是转动角色。
• 朝视线方向行走 - W 键会朝相机朝向的方向行走，你的角色会平滑地转向行走的方向。转向速度决定转向的快慢。
• 奔跑时摆动（可选） - 一旦你开始移动，鼠标只会摆动相机，你的角色会保持同一方向继续奔跑，因此你可以在奔跑途中回头或看向角色的脸。按下不同的移动键即可朝相机所看的方向前进。
• 朝指向处瞄准 - 攻击、挖掘、放置方块以及拉弓、弩或三叉戟时，你的角色会转向准星所覆盖的位置，服务器也会看到相同的瞄准方向，因此箭矢会飞向你指向的地方。
• 第三人称准星（可选） - 显示你将会击中、挖掘或使用的内容。
• 抬高相机（可选） - 将相机稍微抬离角色眼睛上方，这样你的头就不会挡住准星。遇到天花板时会停止。
• 相机距离可在 2 到 12 格之间调整，并具有平滑的墙壁碰撞：墙壁会立即将相机拉近，一旦脱离则平滑地滑回。
• 侧移模式（可选） - 你的角色保持面向相机方向并侧步移动，就像射击游戏那样。
• 载具、飞行和游泳 - 鞘翅飞行会朝相机方向操控，马和猪会跟随相机，船和矿车保持自己的控制方式而相机保持自由，游泳则随相机上下移动。
• 在第一人称中保持视角 - 切换回第一人称时会看向相机原本所看的方向。

自由视角

• 在第一人称中按住左 Alt 即可四处张望而不转动角色。你会继续朝原来的方向行走，松开后视角会平滑地移回。
• 在第三人称中，按住同一按键可在摆动相机的同时保持奔跑方向固定，松开后相机会摆回。
• 自由视角时准星会隐藏，因为它不再显示你将会击中的内容。如果你愿意也可以保留它。
• 当环绕相机关闭时，在 Minecraft 自带的第三人称视角中也能使用。

Swivel 仅是客户端模组：服务器上无需安装任何内容。

控制

按键	默认	作用
自由视角（按住）	左 Alt	四处张望而不转动角色
切换环绕相机	未绑定	开启或关闭环绕相机
相机回正	未绑定	将相机摆回角色身后

可在选项 > 控制 > 按键绑定中更改，或使用 Swivel 设置中的按键绑定...按钮。

安装

Fabric

1. 为你的 Minecraft 版本安装 Fabric Loader。
2. 将 Fabric API 和对应你版本的 Fabric Swivel jar 放入你的 mods 文件夹。
3. 启动游戏。

可选：添加 Mod Menu 以获得设置界面（模组 > Swivel > 配置）。

NeoForge

1. 为你的 Minecraft 版本安装 NeoForge。
2. 将对应你版本的 NeoForge Swivel jar 放入你的 mods 文件夹。
3. 启动游戏。设置界面位于模组 > Swivel > 配置。

Forge

1. 为 Minecraft 1.20.1 安装 Forge。
2. 将 Forge Swivel jar 放入你的 mods 文件夹。
3. 启动游戏。设置界面位于模组 > Swivel > 配置。

设置

设置	范围	默认	作用
环绕相机	开 / 关	开	围绕角色摆动第三人称相机。关闭则使用 Minecraft 普通的第三人称视角
转向速度	1 - 10	6	你的角色转向行走方向的快慢。10 为立即转向
相机距离	2 - 12	4	相机位于角色身后的距离，以格为单位
平滑碰撞	开 / 关	开	墙壁将相机推近后平滑地滑回
抬高相机	开 / 关	开	将相机抬到角色眼睛上方
相机高度	0 - 1.5	0.5	抬高的相机位于眼睛上方的距离，以格为单位
行走时侧移	开 / 关	关	保持面向相机方向并侧步移动
奔跑时摆动	开 / 关	关	在鼠标摆动相机时保持同一方向奔跑
显示准星	开 / 关	开	在第三人称中显示准星
在第一人称中保持视角	开 / 关	开	切换回第一人称时看向相机原本所看的方向
隐藏准星（自由视角）	开 / 关	开	自由视角时隐藏准星

使用设置界面（Fabric 上为 Mod Menu，NeoForge 和 Forge 上为模组列表），更改会立即生效，并在关闭界面时保存。界面中还有一个重置为默认值按钮。

没有 Mod Menu 时，你可以编辑游戏文件夹中的 config/swivel.json 并重启游戏：

{
  "enabled": true,
  "turnSpeed": 6,
  "distance": 4.0,
  "raiseCamera": true,
  "height": 0.5,
  "strafe": false,
  "swivelWhileRunning": false,
  "smoothCollisions": true,
  "crosshair": true,
  "alignOnExit": true,
  "hideCrosshairInFreeLook": true
}

超出范围的值会被自动修正。如果文件损坏，游戏仍会以默认值启动，你的旧文件会保留为 swivel.json.broken。

许可证

MIT