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`:
```yaml
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           # о смерти