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

Command	Permission	Description
/zen reload	zen.admin	Reload plugin configuration
/zen status	zen.admin	Display bridge status
/zen info	zen.admin	Show plugin information
/bale <message>	zen.bale	Send a message directly to the connected Bale group

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

Placeholder	Description
%player%	Minecraft player name
%displayname%	Minecraft display name
%message%	Message content
%username%	Bale username

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