Velthoric

Velthoric brings high-performance physics to Minecraft using the full Jolt Physics engine via JoltJNI. Move, collide, and interact with rigid and soft bodies, ropes, and cloth, all with persistent worlds and a powerful developer API.

⚡ Core Features

The entire system is built on a highly performant Structure of Arrays (SoA) architecture to handle thousands of objects efficiently.

• Rigid & Soft Bodies: Full simulation of solid objects as well as deformable things like cloth and ropes.
• Drivable Vehicles: Cars and motorcycles with working suspension and wheel physics.
• Collision Detection: Efficient broad and narrow phase detection that supports complex shapes and convex hulls.
• Humanoid Ragdolls: Create physical ragdolls from living entities.
• Buoyancy: Objects float in water and lava based on their volume and density.
• Block Conversion: Convert any standard Minecraft block into a dynamic physics object.
• Constraints: Connect bodies using joints and other physics constraints.
• Raycasting: Precise ray and shape casting against the physics world.
• Persistence: Physics bodies are saved with the world and synchronized efficiently between server and client.

🛠️ Developer API

Create custom physics objects, control rendering, manipulate bodies, and extend the system.
Documentation can be found here.

🎯 Testing Commands

/vxsummon
Spawn built-in and custom objects: boxes, ropes, cloth, marbles and more.
Also works with any objects registered via the API.

Test Vehicles:
You can spawn a test car or motorcycle that you can drive using:

/vxsummon velthoric:car ~ ~ ~
/vxsummon velthoric:motorcycle ~ ~ ~

The seat is visible when you press F3 + B.

/vxtest
Quickly create predefined setups for dev & debugging.
Includes chained boxes, configurable soft bodies, box grids, and more.

/vxkill @x[...]
Remove physics objects matching a selector.
You can target objects by type, bodytype, distance, limit, and sort.

Example:

/vxkill @x[type=velthoric:box,limit=5,sort=nearest]

🔧 Included Tools

• PhysicsGun – Pick up, move, rotate, and yeet objects.
• Magnetizer – Pull or push objects where you aim.
• BoxThrower – Spawn and launch boxes instantly.
• ChainCreator – Connect two objects (or one to the ground) with a chain.

💻 Supported Platforms

• Windows x86_64
• Linux x86_64
• Linux Arm64
• MacOS x86_64
• MacOS Arm64

Note: All other platforms (e.g., 32-bit systems, Android) are not supported and will crash.

⚠️ Bug Reports & Mod Compatibility

Found a bug, crash, or an incompatible mod? Please report it on the issue tracker:

🙏 Acknowledgments

• JoltJNI - JNI bindings for Jolt Physics
• Jolt Physics - Physics engine