🦍 ViveMonkeCraft

Minecraft 1.21.4 · Fabric · QuestCraft / Vivecraft 1.2.x Only

What It Does

ViveMonke(Quest)Craft brings Gorilla Tag-style locomotion to QuestCraft/Vivecraft 1.2.x. Grab walls, floors, and ceilings with your VR controllers, then physically push and pull yourself through the world. Releasing your grip while moving quickly converts your momentum into a jump.

Intended Experience

ViveMonkeCraft is inspired by Gorilla Tag locomotion but adapted for Minecraft's physics, collision system, and world scale. As a result, movement will feel similar in concept but not identical to Gorilla Tag.

✨ Features

• Gorilla Tag-style hand-grab locomotion
• Physical climbing, swinging, and wall push-off
• Momentum-based throw/jump on release
• Two physics modes: stable Speed-based (default) and GT-Physics (Beta), a faithful anchor-based port of the official GorillaLocomotion algorithm
• Real Monke: shrink your collision box to fit through 1-block tunnels (client + server enforced)
• Monke Model: render players legless with a tunable torso/arms/head, synced so everyone with the mod sees it
• Hand-model clamping: your hands plant on the block surface instead of sinking in
• Step assist: instant step-up onto ledges, or the classic upward boost
• Ice wall & ice floor physics (with an experimental "ice floor acts like ice wall" toggle)
• Adjustable gravity (zero-G capable) and air/ground/floor friction
• VR comfort vignette + grip smoothing (motion-sickness reduction)
• Optional lowered camera so your hand hitboxes line up with your real hands
• Hand-hitbox markers (green/red) for learning the grab range
• Barrier blocks are invisible to the mod, so admins can wall off areas
• Built-in presets: Tutorial, Default, Long Arms, Zero Gravity, Speed Run
• Configure every setting in-game with /vmc set, no Mod Menu/Cloth needed
• Auto-applies the Default preset on first launch

🖥️ Compatibility

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

Not compatible with:

• Non-VR gameplay other than seeing your friends without legs
• Other Minecraft versions
• Other Vivecraft major versions

The mod automatically disables itself when VR is not active.

🎮 Platform notes

• QuestCraft / Vivecraft 1.2.x only: On non-VR clients the mod detects VR is inactive and does nothing except show other player models without legs.
• Cloth Config and Mod Menu are optional soft dependencies. Without them, use /vmc set or edit the .properties file.

Multiplayer

• Singleplayer & "Open to LAN" / Essential works with just this client mod; a LAN host automatically authorizes guests, no extra files for anyone.
• Dedicated servers: the mod stays off until the server installs the companion ViveMonke server mod. This is a deliberate server-side opt-in, so it can't be used on servers that haven't allowed it.

💡 Server Control 💡

The companion server mod lets admins fully disable the mod, set hard speed caps (enforced server-side), choose which op level bypasses limits, and raise the allowed limits for everyone (push strength, reach, gravity, etc.). Players without cheats/operator access are otherwise clamped to safe defaults, so editing the config can't gain an unfair edge.

📐 e = ∑∞ⁿ⁼⁰ ¹ₙ 🤓 Movement physics

🧊 Ice Physics

• Ice is grabbable on all faces but too slippery to climb. You slide off rather than stick.
• Ice walls/ceilings can be pushed off for momentum, but not used as reliable climbing surfaces.
• Ice is frictionless with a speed cap of player speed × 0.4.
• Experimental: an option to make ice floors behave like ice walls (pure push-off, no glue).

🛠️ Configuration

Three ways to change settings. All write to the same .minecraft/config/vivemonkecraft.properties file:

1. Mod Menu + Cloth Config: full slider/toggle screen from the Mods list, organized into Presets, Movement, GT-Physics, Reach & Body, Jump & Gravity, and Visual pages. Includes the preset dropdown.

2. /vmc set <setting> <value>: change any setting by name in-game (tab-completes). Works without Mod Menu or Cloth Config.

3. Edit the .properties file directly, then run /vmc reload (or toggle the mod off/on).

Presets: Tutorial (easiest to move), Default, Long Arms, Zero Gravity, Speed Run. Selectable in-game; the Default preset is applied automatically on first launch.

🥽 QuestCraft Installation

• Use the QuestCraft built-in mod loader.
• With files: use SideQuest and drop this mod into the mods folder.

📥 PC Vivecraft Installation

1. Install Minecraft 1.21.4.
2. Install Java 21.
3. Install Fabric Loader 0.19.3.
4. Install Vivecraft 1.2.x.
5. Place ViveMonke(Quest)Craft in your mods folder.
6. (Optional) Install Mod Menu and Cloth Config for the graphical settings menu.
7. Launch the game in VR.

Commands

You can also bind a "Toggle" key (unbound by default) in Controls or a Vivecraft radial-menu slot.

Credits

Open Sourced Project Credits & License