TelegramLink — Minecraft Plugin

Link Telegram accounts to Minecraft nicknames.

---

Quick Start

1. Put TelegramLink-X.X.X.jar into plugins/
2. Start the server
3. Open plugins/TelegramLink/config.yml and insert your bot token
4. Run /tlinkreload or restart the server

---

Getting a Bot Token

1. Open Telegram → find @BotFather → send /newbot
2. Enter a name and username for the bot
3. Copy the token that looks like 123456789:AAFxxxxx

---

How Linking Works

1. Player types in Minecraft:   /tlink
   → Receives a code:            A3K9PQ

2. Player sends to Telegram bot: A3K9PQ
   → Bot replies:                ✅ Account linked!

Code is valid for 10 minutes (configurable in config.yml).

---

Multilanguage

Language files are automatically extracted to plugins/TelegramLink/lang/ on first run:

plugins/TelegramLink/
├── config.yml       ← choose language here
└── lang/
    ├── ru.yml       ← Russian
    └── en.yml       ← English

Set the language in config.yml:

language: en.yml   # or ru.yml

You can create a custom translation — copy en.yml to lang/de.yml, translate it, and set language: de.yml.

To apply changes: /tlinkreload — no server restart needed.

---

Proxy (if api.telegram.org is blocked)

Common on Russian hosting providers. Enable in config.yml:

bot:
  proxy:
    enabled: true
    type: HTTP       # or SOCKS5
    host: 1.2.3.4
    port: 8080
    username: ""     # leave blank if no auth required
    password: ""

---

Commands

Minecraft

Command	Description	Permission
/tlink	Generate a link code	telegramlink.use
/tunlink	Unlink Telegram account	telegramlink.use
/tlinklist [player]	List all links / check player	telegramlink.admin
/tlinkadmin link <player> <tg_id>	Link manually	telegramlink.admin
/tlinkadmin unlink <player>	Unlink manually	telegramlink.admin
/tlinkreload	Reload config + language file	telegramlink.admin

Telegram Bot

Command	Description
/start	Welcome message
/link	Linking instructions
/unlink	Unlink account
/status	Check link status
A3K9PQ	Enter code directly