ViveMonkeCraft

---

Minecraft 1.21.4-1.21.5 · Fabric · QuestCraft / Vivecraft 1.2.X Only

---

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

---

What It Does

ViveMonkeCraft 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 - 1.21.8
• Fabric Loader 0.19.3
• QuestCraft
• Vivecraft 1.2.x

---

• Minecraft 1.21.9 - 26.1.2
• PCVR
• ViveCraft 1.3.X

---

Not compatible with:

• Non-VR gameplay other than seeing your friends without legs

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.
• The server mod is on my GitHub page/in Source.

---

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

Feature	Detail
Grab detection	Hand touch sphere (radius 0.12 blocks) extended by handReachMultiplier so you can reach surfaces without fully reaching in real life
Swing measurement	Uses your real hand position (not the extended one) so reach doesn't make motion twitchy
Pull strength	Configurable (Default ≈ 2.5×). Swing a little, move more. Ignored in GT-Physics anchor mode, which is always 1:1
GT-Physics (Beta)	Hands anchor in world space and your body is dragged to keep them planted; tunable drag gain, push strength, unstick distance, ice slip
Throw / jump	On release, if averaged swing speed > threshold, you're flung at swing × jumpMultiplier, hard-capped at maxJumpSpeed
Grip smoothing	Low-pass filter on grip velocity to kill VR tracking noise and reduce motion sickness
Wall slide	Low wall-stickiness slides you down; the slide ramps in over ~½ s so quick pushes keep momentum but you can't hover one-handed
Floor stickiness	1.0 = stop dead on contact, 0.0 = full momentum kept
Ground / air friction	Tunable; air friction 0.0 = launches carry speed indefinitely
Gravity multiplier	Scales gravity while not gripping. 0.0 = zero-G float; op-locked via /vmc gravity
Step assist	Clears ledges while moving: instant step-teleport onto the block, or an upward boost
Real Monke	Collision box capped to 0.5 blocks (1-block tunnels) without shrinking your model, width, or reach
Barriers	Barrier blocks are invisible to the mod, so you can barricade areas it can't bypass
GUI guard	Opening any menu (inventory, chat, settings) fully suspends locomotion so you never drift

---

🧊 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)(Its quite Broken still).

---

🛠️ 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 ViveMonkeCraft 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 ViveMonkeCraft in your mods folder.
6. (Optional) Install Mod Menu and Cloth Config for the graphical settings menu.
7. Launch the game in VR.

---

</> Commands

Command	Effect
/vmc	Toggle the mod on/off
/vmc on / /vmc off	Enable / disable explicitly
/vmc set <setting> <value>	Change any setting in-game (tab-completes)
/vmc reload	Reload the config file
/vmc gravity <0–1>	Change gravity multiplier live (operator-gated)

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

---

Credits

Credits
LaggyBoi
Claude Code is heavily used in this project

---

Open Sourced Project Credits & their License

OpenSourceCredits	License
Kerestell Smith/Another Axiom, Another-Axiom/GorillaLocomotion	MIT
unbaswastaken/GorillaVR Community, gorillalocomotion-VR-MINECRAFT its in the zip file	MIT

Vivecraft is LGPLv3 and is accessed at runtime via reflection only. It is
not bundled or modified by this mod; players supply their own Vivecraft/QuestCraft.

Not affiliated with Another Axiom or Gorilla Tag. "Gorilla Tag" is referenced only to
describe the movement style.