ViveMonkeCraft

ViveMonkeCraft

类《Gorilla Tag》风格的VR移动方式，适用于我的世界1.21.4-26.2 用双手抓住世界，摆动、攀爬并抛掷自己穿越其中——无需摇杆。

杂项

ViveMonkeCraft预览查看大图

🦍 ViveMonkeCraft

Minecraft 1.21.4-1.21.8 · Fabric · 仅限 QuestCraft / Vivecraft 1.2.X

Minecraft 1.21.9 - 26.2 · Fabric · 仅限 PCVR / ViveCraft 1.3.X

功能简介

ViveMonke(Quest)Craft 为 QuestCraft/Vivecraft 1.2.x 带来了《Gorilla Tag》风格的移动方式。使用 VR 控制器抓握墙壁、地板和天花板，然后通过身体动作在世界中推拉自己。在快速移动时松开抓握，会将你的动量转化为一次跳跃。

预期体验

ViveMonkeCraft 的灵感来源于《Gorilla Tag》的移动方式，但针对 Minecraft 的物理、碰撞系统和世界尺度进行了适配。因此，移动手感在概念上会相似，但不会与《Gorilla Tag》完全相同。

✨ 特性

  • 类似《Gorilla Tag》的手部抓握移动
  • 物理攀爬、摆动和墙壁蹬踏
  • 基于动量的松手投掷/跳跃
  • 两种物理模式：稳定的速度模式（默认）和 GT-Physics（测试版），后者是对官方 GorillaLocomotion 算法的忠实锚点移植
  • 真·猴子（Real Monke）：缩小你的碰撞箱以穿过 1 格宽的隧道（客户端和服务端共同强制）
  • 猴子模型：将玩家渲染为无腿形态，并提供可调的身体/手臂/头部，所有安装该模组的玩家可见并进行同步
  • 手部模型钳制：你的手会固定在方块表面，而不是陷入其中
  • 台阶辅助：可瞬间踏上台阶边缘，或使用经典的上托助力
  • 冰墙和冰面物理（带有实验性的“冰面像冰墙一样”开关）
  • 可调重力（支持零重力）以及空气/地面/地板摩擦力
  • VR 舒适度视场角限制 + 抓握平滑（减轻晕动症）
  • 可选降低相机高度，使手部命中判定与真实双手对齐
  • 手部命中框标记（绿色/红色），用于学习抓握范围
  • 屏障方块对该模组不可见，因此管理员可以隔离区域
  • 内置预设：教程、默认、长臂、零重力、速通
  • 无需 Mod Menu/Cloth Config，即可在游戏内通过 /vmc set 配置所有设置
  • 首次启动时自动应用默认预设

🖥️ 兼容性

  • Minecraft 1.21.4
  • Fabric Loader 0.19.3
  • QuestCraft
  • Vivecraft 1.2.x

不兼容：

  • 非 VR 游戏（除了能看见没有腿的朋友外）
  • 其他 Minecraft 版本
  • 其他 Vivecraft 主版本

当 VR 未激活时，模组会自动停用。

🎮 平台说明

  • 仅限 QuestCraft / Vivecraft 1.2.x：在非 VR 客户端上，模组检测到 VR 未激活，除显示其他玩家的无腿模型外不执行任何操作。
  • Cloth Config 和 Mod Menu 是可选的软依赖。没有它们，请使用 /vmc set 或编辑 .properties 文件。

多人游戏

  • 单人游戏和“对局域网开放”/ Essential 只需此客户端模组即可工作；局域网主机自动授权访客，无需任何额外文件。
  • 专用服务器：在服务器安装配套的 ViveMonke 服务端模组之前，该模组保持关闭状态。这是刻意的服务端选择加入机制，因此无法在未允许的服务器上使用。

💡 服务器控制 💡

配套的服务端模组允许管理员完全禁用该模组、设置硬性速度上限（由服务端强制）、选择哪个 op 等级可以绕过限制，并为所有玩家提高允许的限制（推力、触及范围、重力等）。否则，没有作弊/管理员权限的玩家将被限制在安全默认值内，因此修改配置不会获得不公平的优势。

📐 e = ∑∞ⁿ⁼⁰ ¹ₙ 🤓 移动物理

特性 详情
抓握检测 手部触碰球体（半径 0.12 格）通过 handReachMultiplier 延长，这样你无需在现实中完全伸出手即可触及表面
摆动测量 使用你的真实手部位置（非延长后的位置），因此触及范围不会导致动作抖动
拉力强度 可配置（默认 ≈ 2.5 倍）。小幅摆动，移动更多。在 GT-Physics 锚点模式下忽略，该模式始终为 1:1
GT-Physics（测试版） 双手在世界空间中锚定，身体被拖拽以保持双手不动；可调拖拽增益、推力、解除粘连距离、冰面滑动
投掷 / 跳跃 松开时，如果平均摆动速度 > 阈值，你会以 摆动 × jumpMultiplier 的速度被抛出，硬上限为 maxJumpSpeed
抓握平滑 对抓握速度应用低通滤波器，以消除 VR 追踪噪声并减轻晕动症
墙壁滑动 低墙壁粘性会使你滑下；滑动约在 ½ 秒内逐渐增强，因此快速推墙可保持动量，但无法单手悬停
地板粘性 1.0 = 接触时立即停止，0.0 = 完全保持动量
地面 / 空气摩擦 可调；空气摩擦 0.0 = 发射后无限期保持速度
重力倍率 在不抓握时缩放重力。0.0 = 零重力漂浮；通过 /vmc gravity 进行 op 权限锁定
台阶辅助 移动时清除台阶边缘：瞬间传送到方块上，或获得向上助推
真·猴子（Real Monke） 碰撞箱上限为 0.5 格（1 格隧道），而不会缩小你的模型、宽度或触及范围
屏障 屏障方块对该模组不可见，因此你可以设置它无法绕过的路障
界面保护 打开任何菜单（物品栏、聊天、设置）都会完全暂停移动，确保你不会漂移

🧊 冰面物理

  • 冰在所有面上都是可抓握的，但太滑无法攀爬。你会滑落而不是粘住。
  • 冰墙/天花板可以推离以获得动量，但无法用作可靠的攀爬表面。
  • 冰面是无摩擦的，速度上限为 玩家速度 × 0.4。
  • 实验性：一个选项可以让冰地板的行为像冰墙（纯推离，无粘连）。

🛠️ 配置

有三种更改设置的方式。所有方式都写入同一个 .minecraft/config/vivemonkecraft.properties 文件：

  1. Mod Menu + Cloth Config：从模组列表进入完整的滑块/开关界面，按预设、移动、GT-Physics、触及 & 身体、跳跃 & 重力和视觉效果页面进行组织。包含预设下拉菜单。

  2. /vmc set <setting> <value>：在游戏中通过名称更改任何设置（支持 Tab 补全）。无需 Mod Menu 或 Cloth Config 即可工作。

  3. 直接编辑 .properties 文件，然后运行 /vmc reload（或关闭/开启模组）。

预设： 教程（最容易移动）、默认、长臂、零重力、速通。可在游戏内选择；首次启动时自动应用默认预设。

🥽 QuestCraft 安装

  • 使用 QuestCraft 内置的模组加载器。
  • 如果使用文件：使用 SideQuest 并将此模组放入 mods 文件夹。

📥 PC Vivecraft 安装

  1. 安装 Minecraft 1.21.4。
  2. 安装 Java 21。
  3. 安装 Fabric Loader 0.19.3。
  4. 安装 Vivecraft 1.2.x。
  5. 将 ViveMonke(Quest)Craft 放入你的 mods 文件夹。
  6. （可选）安装 Mod Menu 和 Cloth Config 以使用图形化设置菜单。
  7. 以 VR 模式启动游戏。

命令

命令 效果
/vmc 切换模组的开/关
/vmc on / /vmc off 显式启用 / 禁用
/vmc set <setting> <value> 在游戏中更改任何设置（支持 Tab 补全）
/vmc reload 重新加载配置文件
/vmc gravity <0–1> 实时更改重力倍率（需管理员权限）

你也可以在控制设置中绑定一个“切换”键（默认未绑定），或在 Vivecraft 径向菜单中绑定一个槽位。

鸣谢

鸣谢
LaggyBoi
Claude Code 在此项目中大量使用

开源项目致谢与许可证

开源项目致谢 许可证
Kerestell Smith/Another Axiom, Another-Axiom/GorillaLocomotion MIT
unbaswastaken, gorillalocomotion-VR-MINECRAFT 它在压缩包内 MIT
Vivecraft team, VivecraftMod LGPLv3