ViveMonkeCraft

Gorilla Tag-inspired locomotion for Minecraft VR.

Supported versions

Platform	Minecraft	Vivecraft
QuestCraft	1.21.4-1.21.5	1.2.x
PCVR	1.21.9-26.2	1.3.x

---

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

Feature	Description
Grab Detection	Hand sphere (0.12 block radius) extended by handReachMultiplier for comfortable grabbing
Swing Measurement	Uses real controller movement instead of extended reach
Pull Strength	Adjustable movement multiplier (ignored by GT-Physics)
GT-Physics	Anchor-based GorillaLocomotion movement with configurable drag, push strength, unstick distance, and ice slip
Throw / Jump	Swing speed converts into launch velocity, capped by maxJumpSpeed
Grip Smoothing	Reduces controller tracking jitter
Wall Slide	Gradually slides you down walls while preserving momentum
Floor Stickiness	Controls how much momentum is lost when touching the ground
Air & Ground Friction	Fully configurable
Gravity	Adjustable from normal gravity to zero-G
Step Assist	Instantly climbs small ledges or provides an upward boost
Real Monke	0.5 block collision box without changing model size or reach
Barrier Handling	Barrier blocks are ignored by the locomotion system
GUI Guard	Menus temporarily suspend movement

---

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

Command	Description
/vmc	Toggle ViveMonkeCraft
/vmc on	Enable the mod
/vmc off	Disable the mod
/vmc set <setting> <value>	Change any setting
/vmc reload	Reload the configuration
/vmc gravity <0-1>	Change gravity (operator only)

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

Project	License
Another-Axiom/GorillaLocomotion	MIT
GorillaVR Community/gorillalocomotion-VR-MINECRAFT	MIT

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.