🪙 DonateIntegrate
Real-time donation integration for Minecraft 1.12.2.
Bring your stream directly into the game. Reward, react to, and recognize your supporters — live.
🎯 Mod Purpose
DonateIntegrate is a client-side Forge mod for Minecraft 1.12.2 that connects gameplay to donation platforms via WebSocket technology. The mod provides instant reactions to received donations directly within the game — an ideal solution for streamers who want to engage interactively with their audience through various creative methods.
⚙️ Features
- WebSocket connection to external donation systems
- Live updates in-game when a donation is received
- Customizable in-game messages or events triggered by donations
- Completely client-side implementation — no server installation required
- Support for configuration files in YAML and JSON formats
- Built-in SLF4J logging for debugging
📦 Installation
- Install Minecraft Forge 1.12.2
- Place the DonateIntegrate-2.0.4.jar file in the mods/ folder
- Launch Minecraft and configure the mod through the created configuration files (.dintegrate/)
💡 This mod works only on the client. Do not install it on a server!
🧩 Compatibility
| Feature | Support |
|---|---|
| Minecraft | 1.12.2 |
| Forge | ✅ Yes |
| Fabric/NeoForge | ❌ Not supported |
| Multiplayer | ✅ Works (client only) |
| Server side | ❌ Not required |
🧠 How It Works
DonateIntegrate uses built-in libraries:
- Java-WebSocket — for persistent connection to the donation channel
- Gson — for processing incoming JSON data
- SnakeYAML — for convenient configuration formatting
- SLF4J — for lightweight logging
You can define reactions to donations through configuration files, including in-game chat messages, sound effects, or even running scripts using Minecraft commands.
📁 Configuration
After the first mod launch, a folder is created (e.g., config/dintegrate/) with files in YAML and JSON formats for:
- WebSocket address and authorization parameters
- Command templates or actions for different donation levels
- Logging settings
📺 Usage Example
"When someone donates $5 or more, my Minecraft character thanks them in chat, and fireworks are launched in the game. It's a fun way to interact with viewers." — A streamer using DonateIntegrate
🛠️ License and Credits
- Developed by bogdan3000
- Based on open-source libraries
- Community contributions welcome (coming soon)
