WhitelistInTelegram
Add players to your server's whitelist seamlessly and secure player access directly from Telegram.
Add players to your server's whitelist seamlessly and secure player access directly from Telegram.
WhitelistInTelegram is a lightweight, robust, and modern solution that bridges your Minecraft server with a Telegram Bot. It allows players to safely register themselves on the whitelist by simply sending their nickname to a designated Telegram chat, private message (DM), or a specific group topic.
Perfect for vanilla, SMP, and cross-play servers!
✨ Features
- Fully Automated Whitelisting — Players simply send their nickname in Telegram, and the bot automatically executes the whitelist command.
- Geyser & Floodgate Support — Automatically converts spaces to underscores (e.g. Player Name → Player_Name) for Bedrock compatibility.
- Telegram Topics Support — Restrict the bot to a specific forum topic/thread inside your Telegram group.
- Smart /id & /start Commands — Instantly get your Chat ID and Thread ID in a copyable format.
- ⚡ Dynamic Reload — Reload configuration and language files without restarting the Telegram connection.
- Full Localization — English and Russian language files are fully customizable.
- Zero Dependencies — No databases or external services required.
⚙ Compatibility
Minecraft Versions
- 1.21 – 1.21.11
- Paper
- Purpur
- Spigot
- Bukkit
Commands
| Command | Description |
| /wit | Displays the main command and available subcommands. |
| /wit reload | Safely reloads the plugin configuration and language files. |
Permissions
| Permission | Default | Description |
| wit.wit | OP | Allows access to the main command. |
| wit.reload | OP | Allows reloading the plugin configuration and language files. |
⚙ Configuration
The plugin automatically generates a clean configuration and customizable language files.
Spoiler: config.yml
# ╔══════════════════════════════════════════════╗
# ║ WhitelistInTelegram ║
# ║ by Cuamp ║
# ╠══════════════════════════════════════════════╣
# ║ Version : 1.9 ║
# ║ Author : Cuamp, Zontik ║
# ║ TG : @zontfamily ║
# ╚══════════════════════════════════════════════╝
lang: "en_US"
bot-token: "YOUR_TELEGRAM_BOT_TOKEN"
chat-id: -1001234567890
thread-id: -1
command-template: "whitelist add %player%"
Code (Text):
# ╔══════════════════════════════════════════════╗
# ║ WhitelistInTelegram ║
# ║ by Cuamp ║
# ╠══════════════════════════════════════════════╣
# ║ Version : 1.9 ║
# ║ Author : Cuamp, Zontik ║
# ║ TG : @zontfamily ║
# ╚══════════════════════════════════════════════╝
lang: "en_US"
bot-token: "YOUR_TELEGRAM_BOT_TOKEN"
chat-id: -1001234567890
thread-id: -1
command-template: "whitelist add %player%"
Spoiler: lang/en_US.yml
prefix: "[WhitelistInTelegram] "
bot-started: "Telegram bot has been successfully started!"
bot-stopped: "Telegram bot has been stopped."
invalid-nickname: "Error: Received invalid nickname from Telegram: %player%"
player-added: "Player %player% has been successfully added to the whitelist!"
plugin-reloaded: "Plugin configuration and languages have been reloaded!"
no-permission: "You do not have permission to execute this command!"
tg-start-message: " *Hello!* Here is your chat information..."
tg-player-added: "✅ Player %player% has been successfully added to the whitelist!"
tg-invalid-nickname: "❌ Error: Invalid Minecraft nickname: %player%"
Code (Text):
prefix: "[WhitelistInTelegram] "
bot-started: "Telegram bot has been successfully started!"
bot-stopped: "Telegram bot has been stopped."
invalid-nickname: "Error: Received invalid nickname from Telegram: %player%"
player-added: "Player %player% has been successfully added to the whitelist!"
plugin-reloaded: "Plugin configuration and languages have been reloaded!"
no-permission: "You do not have permission to execute this command!"
tg-start-message: " *Hello!* Here is your chat information..."
tg-player-added: "✅ Player %player% has been successfully added to the whitelist!"
tg-invalid-nickname: "❌ Error: Invalid Minecraft nickname: %player%"
❤️ Why WhitelistInTelegram?
- Very Lightweight — Optimized asynchronous tasks keep the server's main thread lag-free.
- Fault-Tolerant — Automatically reconnects to Telegram if the connection is interrupted.
- Safe Markdown Handling — Prevents Telegram formatting issues with player nicknames.
- Perfect for Crossplay — Supports Java and Bedrock servers through Geyser/Floodgate.
Stay Updated
Follow the project for updates and future plugins.
Telegram:
https://t.me/zontfamily
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1, 26.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 Spigot — 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.
WhitelistInTelegram is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Downloaded 20 times (via Spigot). Download it and open it directly in the game.