🚀 WhitelistInTelegram

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 just type their nickname in Telegram, and the bot automatically executes the whitelist command.
• 👥 Geyser & Floodgate Support — Automatically handles space-to-underscore conversions (e.g., Player Name \(\rightarrow\) Player_Name) for seamless Bedrock edition integration.
• 📂 Group Topic (Threads) Compatibility — Restrict the bot to look for nicknames only inside a specific forum topic/thread within your Telegram group.
• 💬 Smart /id & /start Commands — Type /id in any chat or topic, and the bot replies with copiable Chat ID and Thread ID.
• ⚡ Seamless Dynamic Reload — Configuration changes via /wit reload apply instantly in memory without dropping the Telegram connection or causing long-polling errors.
• 🌍 Full Localization (EN/RU) — Every message in the console and inside Telegram is 100% customizable via en_US.yml and ru_RU.yml.
• 📦 Zero External Server Dependencies — Works out of the box with your server software.

⚙️ Compatibility

Minecraft Versions

1.21 – 1.21.11

Server Software

Paper | Purpur | Spigot | Bukkit

🎮 Commands

🔑 Permissions

⚙️ Configuration & Customization

The plugin generates a clean configuration structure along with customizable language files.

config.yml

# ╔══════════════════════════════════════════════╗
# ║              WhitelistInTelegram             ║
# ║                   by Cuamp                   ║
# ╠══════════════════════════════════════════════╣
# ║ Version : 1.9                                ║
# ║ Author  : Cuamp, Zontik                      ║
# ║ TG      : @zontfamily                        ║
# ╚══════════════════════════════════════════════╝

# [en] The language of the plugin. Files are located in the "lang" folder (without .yml extension).
# [ru] Язык плагина. Файлы находятся в папке "lang" (указывать без расширения .yml).
lang: "en_US"

# [en] Token of your Telegram bot received from @BotFather.
# [ru] Токен вашего Telegram бота, полученный от @BotFather.
bot-token: "YOUR_TELEGRAM_BOT_TOKEN"

# [en] Chat ID (for groups it usually starts with -100, for private chat with bot it is positive number).
# [ru] ID чата (для групп обычно начинается с -100, для личного чата с ботом - положительное число).
chat-id: -1001234567890

# [en] Thread/Topic ID inside a supergroup.
# Set -1 if you want to use regular group, private chat (DM) or general topic.
# [ru] ID темы/топика внутри супергруппы.
# Укажите -1, если используете обычную группу, личный чат с ботом или общую тему (General).
thread-id: -1

# [en] Command execution template. %player% will be replaced by nickname.
# [ru] Шаблон выполнения команды. %player% будет автоматически заменен на никнейм.
command-template: "whitelist add %player%"

📋 Customizing Language Files (lang/en_US.yml)

You can use specialized placeholders and Telegram's Markdown ( `for copiable text, *for bold, _for italic) to completely change the bot's appearance in Telegram:

# =========================================================================
# WhitelistInTelegram Translation File (English)
# 
# PLACEHOLDERS EXPLANATION:
# %player%    - Returns the Minecraft player's nickname.
# %chat_id%   - Returns the Telegram Chat ID.
# %thread_id% - Returns the Telegram Topic (Thread) ID, or -1 if none.
# =========================================================================

# --- Console & Chat Messages ---
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!"

# --- Telegram Bot Responses ---
tg-start-message: "👋 *Hello!* Here is your chat information:\n\n• Chat ID (copiable): `%chat_id%`\n• Topic ID (copiable): `%thread_id%`\n\n_Copy these values and paste them into your config.yml!_"
tg-player-added: "✅ Player %player% has been successfully added to the whitelist!"
tg-invalid-nickname: "❌ Error: Invalid Minecraft nickname: %player%"

❤️ Why WhitelistInTelegram?

• Very lightweight & fast — Written with optimal async scheduler tasks to prevent main thread ticks lagging.

• Fault-Tolerant (Auto-Reconnect) — If Telegram servers lag or internet blinks, the bot safely reconnects on its own without spamming or crashing your game server.

• No Markdown Parsing Crashes — Safely sanitizes nickname formatting characters (_ and *) so Bedrock/Java names never break Telegram's API rendering.

• Perfect for Bedrock/Java Crossplay — Makes vanilla whitelisting completely hands-free for admins.

💬 Stay Updated

Follow the project for updates, announcements, and future plugins.

Telegram Channel:

https://t.me/zontfamily