---

👋 Welcome to Velthoric

Velthoric is a project dedicated to bringing advanced, high-performance physics to Minecraft.

Important Note: Right now, this mod is a Proof of Concept. This means we are currently testing what’s possible and building the foundation. It is a work in progress, but it won't stay this way forever. We have big plans to turn this into a fully-fledged, stable physics engine for the community.

💥 What makes this mod special?

We aren't just adding simple animations. Velthoric integrates the professional Jolt Physics engine (via JoltJNI) directly into Minecraft. This allows for interactions that feel heavy, realistic, and incredibly smooth.

Current Features:

• True Rigid and Soft Bodies: Interact with solid objects, or play with deformable things like cloth and ropes.
• Working Vehicles: Drive cars and motorcycles that feature actual suspension and wheel physics.
• Realistic Ragdolls: Watch living entities react to the world with physical skeletal systems.
• Buoyancy: Objects actually float in water and lava based on their weight and shape.
• World Interaction: Convert standard blocks into dynamic physics objects that fall and collide.
• Optimized Performance: Built using a "Structure of Arrays" (SoA) architecture to handle thousands of objects without killing your frame rate.
• Persistence: Everything stays where it is. Physics bodies are saved with your world and synced perfectly between the server and the client.

---

🎮 How to play with it

You can test the engine right now using these commands:

• /vxsummon: Spawn objects like boxes, ropes, or marbles.
  • Try this to test a vehicle: /vxsummon velthoric:car ~ ~ ~ (Use F3 + B to see where to sit).
• /vxtest: A quick way to spawn debug setups like chain grids or soft bodies.
• /vxkill: Use this to clean up. You can target specific types of objects or everything nearby.
  • Example: /vxkill @x[type=velthoric:box,limit=5,sort=nearest]

🔧 Tools included

We’ve added several tools to help you manipulate the world:

• PhysicsGun: Grab, move, and throw objects around.
• Magnetizer: Push or pull things with magnetic force.
• Launchers: Special tools to shoot boxes or ragdolls into the air.
• ChainCreator: Link objects together or anchor them to the ground.

Hint: You can press TAB while holding any tool to open a menu and tweak settings like strength and range.

---

💻 Supported Platforms

Because Velthoric relies on native code for the physics engine, it currently supports:

• Windows (x86_64)
• Linux (x86_64 and Arm64)
• MacOS (x86_64 and Arm64)

Warning: Any other platforms, such as 32-bit systems or Android, are not supported and will result in a crash.

⚠️ Feedback and Bug Reports

If you find a bug or a compatibility issue, please let us know on the issue tracker:

---

🙏 Acknowledgments

This project wouldn't be possible without these amazing resources:

• JoltJNI: The JNI bindings for Jolt Physics.
• Jolt Physics: The powerful engine behind it all.