Logo
TelegramLink
PluginMIT

TelegramLink

Linking a Telegram account to a Minecraft nickname

20
Downloads
1
Followers
1 months ago
Updated
📦
1
Versions
managementsocialutilitybukkitpaperpurpurspigot
Download Latestv1.0.0View on Modrinth

📖About TelegramLink

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