English

---

TelegramLink — Minecraft Plugin

Link Telegram accounts to Minecraft nicknames. Compatible with Spigot / Paper 1.8 – 26.1.2.

---

Quick Start

1. Put TelegramLink.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

---

config.yml — All Settings

language: en.yml         # language file: en.yml / ru.yml / your_file.yml

bot:
  token: "YOUR_TOKEN"
  username: "YourBot"
  proxy:
    enabled: false       # true if Telegram is blocked
    type: HTTP           # HTTP or SOCKS5
    host: 127.0.0.1
    port: 8080
    username: ""
    password: ""

database:
  type: sqlite           # sqlite or mysql
  sqlite-file: telegramlink.db

code-expiry-minutes: 10

notifications:
  join: true             # notify on player join
  quit: true             # notify on player quit
  death: false           # notify on player death

---

Russian

---

TelegramLink — Плагин для Minecraft

Привязка Telegram-аккаунта к Minecraft-нику. Совместим со Spigot / Paper 1.8 – 26.1.2.

---

Быстрый старт

1. Положите TelegramLink.jar в папку plugins/
2. Запустите сервер
3. Откройте plugins/TelegramLink/config.yml и вставьте токен бота
4. Выполните /tlinkreload или перезапустите сервер

---

Получить токен бота

1. Откройте Telegram → найдите @BotFather → напишите /newbot
2. Введите имя и username бота
3. Скопируйте токен вида 123456789:AAFxxxxx

---

Как привязать аккаунт

1. Игрок пишет в Minecraft:    /tlink
   → Получает код:              A3K9PQ

2. Игрок пишет боту Telegram:  A3K9PQ
   → Бот отвечает:              ✅ Аккаунт привязан!

Код действует 10 минут (настраивается в config.yml).

---

Мультиязычность

При первом запуске языковые файлы автоматически создаются в plugins/TelegramLink/lang/:

plugins/TelegramLink/
├── config.yml       ← выбор языка здесь
└── lang/
    ├── ru.yml       ← русский
    └── en.yml       ← английский

Выбор языка в config.yml:

language: ru.yml   # или en.yml

Можно создать собственный перевод — скопируйте ru.yml в lang/de.yml, переведите и укажите language: de.yml.

После смены языка: /tlinkreload — перезапуск сервера не нужен.

---

Прокси (если api.telegram.org заблокирован)

Актуально для российских хостингов. Включите в config.yml:

bot:
  proxy:
    enabled: true
    type: HTTP       # или SOCKS5
    host: 1.2.3.4
    port: 8080
    username: ""     # оставить пустым если авторизация не нужна
    password: ""

---

Команды

Minecraft

Команда	Описание	Право
/tlink	Сгенерировать код привязки	telegramlink.use
/tunlink	Отвязать Telegram	telegramlink.use
/tlinklist [ник]	Список / статус игрока	telegramlink.admin
/tlinkadmin link <ник> <tg_id>	Привязать вручную	telegramlink.admin
/tlinkadmin unlink <ник>	Отвязать вручную	telegramlink.admin
/tlinkreload	Перезагрузить конфиг + язык	telegramlink.admin

Telegram-бот

Команда	Описание
/start	Приветствие
/link	Инструкция по привязке
/unlink	Отвязать аккаунт
/status	Статус привязки
A3K9PQ	Ввести код напрямую

---

config.yml — Все настройки

language: ru.yml         # язык: ru.yml / en.yml / ваш_файл.yml

bot:
  token: "ВАШ_ТОКЕН"
  username: "ВашБот"
  proxy:
    enabled: false       # true если Telegram заблокирован
    type: HTTP           # HTTP или SOCKS5
    host: 127.0.0.1
    port: 8080
    username: ""
    password: ""

database:
  type: sqlite           # sqlite или mysql
  sqlite-file: telegramlink.db

code-expiry-minutes: 10

notifications:
  join: true             # уведомление о входе на сервер
  quit: true             # о выходе
  death: false           # о смерти