✨ XBullet ✨ - Physics Engine for Minecraft 1.20.1 Forge

XBullet is an experimental physics mod for Minecraft 1.20.1, built upon the Bullet Physics library and specifically its libbulletjme adaptation. The mod is currently in a very early Alpha stage. Its primary goal is to introduce more realistic physics into Minecraft, including authentic collisions and physics-based movement for objects.

⚠️ Important Warning: This mod is still in early Alpha development and may contain numerous bugs or lead to unexpected behavior. This is a very early test build that has the potential to corrupt worlds. Physics objects may also render incorrectly.

It is currently intended solely for testing purposes. Please report any bugs, crashes, or unusual behavior to help improve the mod!

🎯 Planned Features & Current Status

XBullet has extensive future plans, with features being implemented incrementally.

• Implements a realistic physics engine within Minecraft.
• Utilizes the Bullet Physics library (specifically the libbulletjme port).
• Establishes fundamentals for realistic collisions and physical movement.
• Supports Minecraft Forge 1.20.1.
• Future versions will provide a usable API for other developers to interact with the physics engine.

➡️ Usage (Creating Physics Objects)

To demonstrate basic physics and create physics objects, acquire the physics_creator_stick:

1. Obtain the physics_creator_stick from the creative inventory.
2. Right-click any block in the world to transform it into a physics object, complete with realistic collisions and movement.

🐛 Reporting Bugs

If you encounter a bug, crash, or unexpected behavior, please report it! Your detailed feedback is invaluable.

Provide as much detail as possible, including:

• Minecraft version
• Forge version
• List of other installed mods
• Steps to reproduce the issue
• Crash reports (if available)

📜 Disclaimer & Important Notes

• This mod is in Alpha stage, and its use is entirely at your own risk.
• All features and implementations are not final and are subject to significant changes in future updates.
• How to Delete Physics Objects (Current Method): Currently, physics objects cannot be removed normally within the game. To delete them, you must navigate to your Minecraft world folder and delete the file named xbullet.dat in the data folder. Note: This will delete all physics objects for that specific world. A more integrated removal method will be implemented in future updates.

🙏 Credits

• Sincere thanks to the developers of Bullet Physics and especially the maintainers of the libbulletjme port, which forms the fundamental basis for this mod.

✨ Enjoy testing and experimenting! ✨

We eagerly await your feedback to continue developing and improving XBullet! 😊