Minegasm is a client-side Minecraft (Java Edition) Forge mod that provides haptic feedback to enhance the gameplay experience.

This mod is intended for adults only. By downloading and using this mod, you agree that you are of legal age in your country.

Download

  • Discontinued versions: 1.20.1, 1.16.3, 1.14.4, 1.13.2. Old releases that support those versions can be found on the release page.
  • Deprecated versions (might be removed in future releases): 1.17.1, 1.18.2
  • While 1.17.1 can use both Java 16 or 17, we recommend Java 17.

We will be switching to NeoForge from 1.21 onwards. Please stay tuned for updates.

Dependencies

  1. Intiface Central: https://intiface.com/central/
  2. Minecraft Forge: the versions mentioned on the corresponding Forge column above are the tested versions (newer versions are probably okay)

How to Use

  1. Make sure you have all the dependencies installed.
  2. Download the JAR file and put it in your mods directory. If you don’t know where your mods directory is, you can simply open your Minecraft, click the ‘Mods’ button on the main menu, then click ‘Open Mods Folder’.
  3. Run the Intiface Central and start the server (ws://localhost:12345). For advanced users, it is possible to use an Intiface server on a different endpoint by specifying it in the Minegasm config file.
  4. Turn on the device.
  5. Start Minecraft and connect to a world. If everything works properly, you should see a message stating that Minegasm is connected to your device when you enter the world. If the connection fails, go back to Intiface Central and make sure that the Server Status shows that the server is running. To force Minegasm to retry to connect, leave the world and then re-enter.
  6. Have fun!

For more detailed instructions, please see the setup page.

Known Issues

  • In-game config menu is missing for 1.17, 1.18, 1.19, and 1.20. The mod can still be configured manually by editing the config file.
  • The mod has only undergone limited testing in multiplayer mode and it might not work with some mods.

Make sure to check out our issue tracker for all the known issues and their status. The troubleshooting page provides suggestions of things to do if you encounter any issues.

Supported Devices

In theory, this mod should be compatible with any devices on this list: IoST Index – Vibrators with Buttplug.io Support

It has been confirmed by the developers to work with:

Note that at the moment it doesn’t work with any other devices that are not vibrators.

Configuration

Minegasm is configurable through the Mods > Config screen, as well as by manually editing the minegasm-client.toml config file. The config page explains this in further details.

Gameplay Modes

Mode Description
NORMAL The device will vibrate when you attack other entities, mine, or gain XP.
MASOCHIST The device will vibrate when you’re hurt or dying.
HEDONIST The device will vibrate on all events defined in other modes, except dying (this is replaced, instead, by having the toy vibrate when you’re full and healthy).
CUSTOM The device will vibrate depending on the intensity levels configured by the user.

Support

In principle, we do not provide any dedicated (technical) supports. If you need any assistance, you can use the discussion page. Alternatively, you can join our Discord server and ping @RSwoop in the appropriate channel in the Minegasm Mod section, but please be advised that he might not always be able to help you.

If you have any suggestions or found any bugs, please post them to our issue tracker on GitHub. Please try to be as descriptive as possible and include your debug.log (please remove any references to your username first if that matters). The debug.log file is typically under the logs directory of your minecraft instance. In the vanilla installation on Windows, it is typically on <drive>:\Users\<username>\AppData\Roaming\.minecraft.

Some (newer and generally more actively maintained) projects based on or inspired by Minegasm:

Project Description
Minegasm-fabric A Fabric port of Minegasm
mInetiface A rewrite of Minegasm with extra features

Please check them out and see if they fit your needs better.

Did you create a fork and want to be listed here? Open a pull request!

Acknowledgements

Our thanks to the following people, whose assistance have been instrumental in the development of this mod.

Contributors

  • RSwoop
  • blackspherefollower
  • Sour-o7

Credits

  • qdot for the buttplug library
  • Lone_Destroyer for the original logo