owocraft

This is a Fabric mod for Minecraft 1.21.1 that provides direct integration with the OWO Haptic Suit, delivering comprehensive physical feedback based on specific in-game enviromental sensations and damage types.

This mod was done as a commission for BamBaeYoh. You can find the public release video below:

⚠️ Platform Requirement

This mod was developed and tested exclusively for Windows. Compatibility on other operating systems (ex: Linux, Mac) has not been tested and may not be officially supported due to the OWO haptic vest API layer only targetting Windows.

You must use Java 23 or later on both the client and the server due to use of newer JVM features as mentioned in technical details.

✨ Features

30+ Haptic Sensations: Integration with all damage types and some unique sensation events, including:

• Combat: Impacts from punches, arrows, swords, explosions, and large hostile mobs (Warden, Ender Dragon).
• Environmental: Sensations for rain, speed, being submerged, and area effects (Nether, Sculk Shrieker).
• Damage/Status: Feedback for fall damage, void damage, suffocation, poison, wither, and freezing.

Customizable Configuration: A robust config system allows players to control the experience through Mod Menu config:

• Enable or disable individual sensations.
• Set priority rules for sensations when multiple events occur simultaneously (e.g., an attack overriding light rain).
• Control whether a sensation runs until completion or can get interrupted
• Configure if a default sensation runs

⚙️ Technical Implementation

The mod uses a modern Java API built with Project Panama to efficiently interface with the OWO C++ bindings, along with an integrated JPython interpreter for flexible scripting and fine-tuning of haptic effects through Python.

All scripts exist under owocraft/py/minecraft, which are completely flexible to modify as needed.

If you're a developer looking to add your own scripts with your own mod, you're welcome to check out API implementation details at https://github.com/SebaSphere/owocraft/blob/master/src/main/java/dev/sebastianb/owocraft/client/OwocraftClient.java