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
- Create a Bale bot and obtain its API token
- Add the bot to your Bale group
- Retrieve the group ID from Bale updates
- Place the plugin JAR into your server's
pluginsdirectory - Start the server to generate configuration files
- Edit
plugins/Zen/config.ymland enter your token and group ID - 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
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as zen-1.0.3.jar — drop this file into the mods folder
- Download size: 32 KB
- Download link checked 24 Aug 2026 — working
These come from our own check of the pack file, not from the source page.