SpinMod

================================================================================

SPIN MOD FOR BONELAB

(Meta Quest Version)

================================================================================

Thank you for downloading the Spin Mod for BONELAB!

This mod adds a powerful, physics-based spinning and throwing mechanic to any

object you hold. Charge up an object in your hand, spin it at high speeds,

launch it forward with pinpoint accuracy, and recall it back like a boomerang!

--------------------------------------------------------------------------------

1. INSTALLATION GUIDE (META QUEST)

--------------------------------------------------------------------------------

Requirements: BONELAB installed on Quest with MelonLoader.

1. Connect your Meta Quest headset (Quest 2 / Quest 3 / Quest Pro) to your PC

or phone via USB cable.

2. Open your file manager (or CX File Explorer / SideQuest / Mobile File Manager).

3. Navigate to the exact directory path on your Quest storage:

melonloader-com.StressLevelZero.BONELAB-Mods

4. Copy and paste the "Spin.dll" file directly into this folder.

(Note: You can safely rename the .dll file to anything you like).

5. Launch BONELAB on your Meta Quest headset and enjoy!

--------------------------------------------------------------------------------

2. HOW TO USE THE MOD (CONTROLS)

--------------------------------------------------------------------------------

STEP 1: ARMING THE SPIN

- Quick-tap the B button (or Top Face Button) on your Touch controller 4 TIMES in rapid succession.

- A notification reading "SPIN READY - Hold Right/Left Grab" will pop up on your screen.

- You now have 12 seconds to grab an object before the armed state expires.

STEP 2: CHARGING & SPINNING

- Grab any object (ball, weapon, prop, etc.) using your Grip Trigger while armed.

- The object will immediately lock to your hand and begin spinning at high angular velocity.

- A notification "SPIN! - Active" confirms the charge is in progress.

STEP 3: LAUNCHING / SHOOTING

- Simply RELEASE the Grip Trigger!

- The object will immediately shoot forward at high velocity directly toward where your VR headset (camera) is facing.

- The thrown object will keep its high-speed rotation during flight, creating devastating impact physics.

STEP 4: HOMING RETURN (BOOMERANG MECHANIC)

- Once the object is in flight, wait a fraction of a second (default delay: 0.3s).

- PRESS AND HOLD the Grip Trigger on the hand you used to throw it.

- The object will alter its trajectory and fly directly back toward your hand!

- Catch it when it gets close, or release the grip to let it fly past.

--------------------------------------------------------------------------------

3. BONEMENU CONFIGURATION & SETTINGS

--------------------------------------------------------------------------------

You can customize the mod's behavior directly in-game using BoneMenu:

1. Open your preferences radial menu in BONELAB and select "BoneMenu".

2. Navigate to the "Spin" sub-page.

Available Options:

- Enabled (True/False):

Toggles the mod on or off without needing to delete the file.

- Throw Speed (Default: 30):

Adjusts the launch speed of the projectile when released. Higher values result

in faster, longer-distance throws. Lower values make it easier to control in

tight indoor maps.

- Homing Speed (Default: 35):

Adjusts the speed at which the thrown object flies back toward your hand when

holding the Grip trigger.

================