Ultimate Telekinesis

Grab, hold, release, and throw movable BONELAB objects with either controller. Configure controls and physics in a custom galaxy-themed control panel opened from BoneMenu. The mod is designed for BONELAB on Quest and PCVR with MelonLoader/LemonLoader.

Author: GravWarden

Requires a compatible BONELAB MelonLoader/LemonLoader installation and BoneLib for its BoneMenu entry.

Controls

• Telekinesis is enabled by default. Aim with your selected controller and squeeze its trigger to grab a movable object.
• By default, squeeze the trigger again to release. Enable Hold Trigger to Grab in the in-game menu to hold while squeezed and drop when released.
• While holding an object, squeeze that controller's grip to throw it.
• Open BoneMenu > ULTIMATE TELEKINESIS > Open Control Panel to show the galaxy menu. Opening BoneMenu alone will not open the panel.
• In Controls, select the menu hand used to point at controls and select them with that controller's trigger.

Only objects with a non-kinematic Rigidbody can be grabbed. Static scenery blocks grabs. The default grab range is 10 meters, and the grabbed point stays about 2.5 meters in front of the controller. Held objects preserve their original gravity setting when released or thrown. BoneLib is required for the BoneMenu control-panel option and also provides optional collision protection between held objects and the player rig.

In-game menu

The world-space galaxy menu has Core, Controls, Physics, and Status pages. It provides power, grab mode and hand selection, configurable menu hand, gravity, trigger/grip sensitivity, range, hold distance, pull strength/speed, throw speed, and live controller diagnostics. Settings persist in MelonLoader preferences. When the menu is open, grab input is paused so menu selections cannot also grab or release objects.

Installation

Thunderstore Mod Manager

After the package is available on Thunderstore, find Ultimate Telekinesis in the BONELAB community and select Install with Mod Manager.

Manual installation

1. Install a compatible LemonLoader/MelonLoader setup and BoneLib for BONELAB.
2. Extract the downloaded package ZIP.
3. Copy Mods/UltimateTelekinesis.dll directly into BONELAB's Mods folder. Do not leave it inside an extra nested folder.
4. Launch BONELAB and open the panel from BoneMenu.

Install either Ultimate Telekinesis or Ultimate Telekinesis 2, not both. They use the same controller grab inputs and are alternative packages.

Troubleshooting

• If the mod does not load, check the latest MelonLoader/LemonLoader log for assembly-loading errors.
• If the control panel option is missing, confirm BoneLib is installed and check the loader log for BoneMenu registration errors.
• Confirm UltimateTelekinesis.dll is directly inside the active BONELAB Mods folder.
• If grabbing does not work, try a nearby movable object; static scenery and objects with a kinematic Rigidbody cannot be grabbed.
• Make sure the selected controller is tracked and active. The mod can read either analog trigger/grip values or their button features.
• If input or grabbing still fails, open Status and check controller/pose/trigger readings; lower trigger/grip sensitivity in Controls if needed.
• If the controller pose is temporarily lost while holding an object, it is automatically released safely after a short grace period.
• Use Core > Power to turn telekinesis on or off.

License

This project is licensed under the MIT License. See LICENSE.

Version history

See CHANGELOG.md.