🦍 ViveMonkeCraft

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

Minecraft 1.21.9 - 26.2 · Fabric · PCVR /ViveCraft 1.3.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

ViveMonkeCraft

Gorilla Tag-inspired locomotion for Minecraft VR.

Supported versions

What is ViveMonkeCraft?

ViveMonkeCraft brings Gorilla Tag-style locomotion to Minecraft VR. Grab walls, floors, and ceilings with your VR controllers, then physically push and pull yourself through the world. Release your grip while moving to convert your momentum into a jump.

The movement is inspired by Gorilla Tag but adapted to Minecraft's physics, collision system, and world scale. It feels familiar while remaining designed specifically for Minecraft.

Features

Movement

• Gorilla Tag-style hand locomotion
• Physical climbing, swinging, and wall push-offs
• Momentum-based jumping
• Two movement modes:
  • Speed Physics (default)
  • GT-Physics (Beta) using a faithful port of GorillaLocomotion's anchor system
  • Instant or boosted step assist
  • Adjustable gravity, friction, and movement strength
  • Zero-gravity support

Body & Reach

• Real Monke mode shrinks your collision box to fit through 1-block tunnels
• Monke Model removes player legs and synchronizes the model across players using the mod
• Adjustable arm reach
• Lowered camera option for improved hand alignment
• Hand hitbox markers for learning grab range
• Hand clamping keeps your hands planted on block surfaces

Ice Physics

• Ice walls and ceilings can be pushed off
• Ice cannot be reliably climbed
• Slippery movement with configurable behavior
• Experimental option for ice floors to behave like ice walls

Comfort

• Grip smoothing to reduce tracking noise
• Comfort vignette for motion sickness reduction
• GUI guard disables locomotion while menus are open

Customization

• Built-in presets:
  • Tutorial
  • Default
  • Long Arms
  • Zero Gravity
  • Speed Run
  • Every setting can be changed in-game
  • Default preset is automatically applied on first launch

Compatibility

Supported

• QuestCraft
• Vivecraft
• Fabric

Not supported

• Non-VR gameplay (except seeing other players' Monke models)

The mod automatically disables itself whenever VR is not active.

Multiplayer

Singleplayer / LAN / Essential

Works immediately with only the client mod.

If you host a LAN world or use Essential, connected players are automatically authorized without installing anything else.

Dedicated Servers

Dedicated servers require the ViveMonke Server companion mod.

Without the server mod installed, ViveMonkeCraft remains completely disabled. This prevents it from being used on servers that have not explicitly enabled it.

The server mod is available on this GitHub repository.

Movement Physics

Ice Physics

• Ice can be grabbed from any side.
• Ice walls and ceilings are too slippery to climb.
• Ice can still be used to push yourself away.
• Sliding speed is capped at 40% of player speed.
• Experimental option allows ice floors to behave like ice walls.

Configuration

All configuration methods edit the same file:

config/vivemonkecraft.properties

Graphical Menu

Install Mod Menu and Cloth Config for a complete settings interface.

Commands

Use commands without installing any additional mods.

/vmc
/vmc on
/vmc off
/vmc reload
/vmc set <setting> <value>
/vmc gravity <0-1>

Manual Editing

Edit the properties file directly, then run:

/vmc reload

Installation

QuestCraft

• Install using the QuestCraft built-in mod loader.

Or

• Copy the mod into the mods folder using SideQuest.

PCVR

1. Install Java 21.
2. Install Fabric Loader.
3. Install Vivecraft.
4. Place ViveMonkeCraft in the mods folder.
5. (Optional) Install Mod Menu and Cloth Config.
6. Launch Minecraft in VR.

Commands

A toggle key can also be assigned in Minecraft Controls or added to a Vivecraft radial menu.

Credits

• LaggyBoi — Creator
• Claude Code — Development assistance

Open Source Credits

The GorillaVR project source is included in this repository.

Licensing

Vivecraft is licensed under LGPLv3.

ViveMonkeCraft accesses Vivecraft through runtime reflection only. Vivecraft is not bundled or modified and must be installed separately.

Disclaimer

ViveMonkeCraft is not affiliated with Another Axiom or Gorilla Tag.

"Gorilla Tag" is referenced solely to describe the style of locomotion.