Balebot

Zen

Zen bridges Minecraft chat with Bale messenger groups through the official Bale Bot API Messages sent in-game appear in Bale, and messages sent in Bale are delivered directly to Minecraft

Features

• Two-Way Chat Bridge — Synchronize messages between Minecraft and Bale in real time.

• Official Bale Bot API Integration — Uses Bale's official API for communication.

• Retry System — Automatic exponential backoff for failed API requests

• Per-Event Control — Enable or disable individual bridge events:

  • Chat messages
  • Player joins
  • Player leaves
  • Death messages
  • Advancements

• Rate Limiting — Token-bucket based protection against spam and API abuse

• Improved Logging — Detailed console output with actionable error information

• Thread-Safe Architecture — Designed for concurrent message processing and validation

• Long Polling Support — Efficient update retrieval with offset tracking

• Banned Word Filter — Block configured words before they reach either platform

• Player Ignore List — Exclude selected players from the bridge

• Custom Formatting — Supports placeholders and Minecraft color formatting

• Lightweight & Configurable — Simple setup with minimal overhead

Commands

Configuration

bale:
  token: "YOUR_BALE_BOT_TOKEN"
  group-id: "YOUR_GROUP_ID"
  api-base: "https://tapi.bale.ai"
  poll-interval: 3
  timeout: 30

Supported Placeholders

Installation

1. Create a Bale bot and obtain its API token
2. Add the bot to your Bale group
3. Retrieve the group ID from Bale updates
4. Place the plugin JAR into your server's plugins directory
5. Start the server to generate configuration files
6. Edit plugins/Zen/config.yml and enter your token and group ID
7. Restart the server

How It Works

Minecraft → Bale

Messages sent by players in Minecraft are forwarded directly to the configured Bale group

Requirements

• Java 21+
• Bukkit, Spigot, Paper, or compatible server software
• Valid Bale Bot Token
• Bale Group ID

License

This project is released under the MIT License