TgAuth2

TgAuth — Аутентификация через Telegram

Только серверная часть. Игроки проходят аутентификацию через Telegram при каждом входе. Клиентский мод не нужен.

Как это работает

Новый игрок — первичная настройка

1. Игрок открывает Telegram → отправляет /start боту
2. Бот проверяет вайтлист → выдаёт 6-значный код
3. Игрок заходит на сервер → вводит /tgauth link <код>
4. Аккаунт навсегда привязывается к его Telegram

Возвращающийся игрок — при каждом входе

Вход на сервер
    │
    ▼
То же устройство, что и в прошлый раз? (сессия по IP, действует 12 часов)
    ├── ДА → Автовход, Telegram не нужен ✅
    └── НЕТ → Бот отправляет подтверждение в Telegram:
                  [✅ Да]   [❌ Нет]
                  │              │
              Вход выполнен ✅    Кик ❌

---

Возможности

• 🔐 Подтверждение через Telegram при каждом входе — каждое новое устройство требует одобрения
• 💾 12-часовые сессии устройств — тот же IP = запрос не появляется в течение окна сессии
• 📋 Вайтлист по Telegram ID — зарегистрироваться могут только одобренные пользователи
• 🤖 Кнопки inline-клавиатуры — Да/Нет прямо в чате Telegram
• ⏱ Настраиваемый таймаут — кик, если нет ответа в течение N секунд
• 🔧 Админ-команды — управление вайтлистом, принудительное одобрение, очистка сессий
• 💿 Постоянное хранение данных — привязки сохраняются после перезапуска сервера (world/data/tgauth_players.json)

---

Настройка

1. Создайте Telegram-бота Откройте @BotFather → /newbot → скопируйте токен. 2. Получите Telegram ID ваших игроков Каждый игрок пишет @userinfobot → копирует свой Id. 3. Настройте config/tgauth-server.toml

[bot]
    botToken    = "1234567890:AAH..."
    botUsername = "MyServerAuthBot"

[whitelist] telegramIds = ["123456789", "987654321"]

[session] durationHours = 12

**4. Перезапустите сервер.** Готово.
---
## Команды
### Игроки
| Команда | Описание |
|---|---|
| `/tgauth link <код>` | Привязать аккаунт Telegram (новые игроки) |
| `/tgauth status` | Показать статус привязки и активную сессию |
### Операторы (OP 2+)
| Команда | Описание |
|---|---|
| `/tgauth admin whitelist list` | Показать все Telegram ID в вайтлисте |
| `/tgauth admin whitelist add <id>` | Добавить Telegram ID |
| `/tgauth admin whitelist remove <id>` | Удалить Telegram ID |
| `/tgauth admin unlink <игрок>` | Отвязать аккаунт Telegram игрока |
| `/tgauth admin force <игрок>` | Принудительно одобрить ожидающий вход |
| `/tgauth admin sessions <игрок>` | Показать активные сессии устройств |
| `/tgauth admin clearsessions <игрок>` | Сбросить все сессии устройств |
| `/tgauth admin reload` | Перезагрузить вайтлист из конфига |
---
## Совместимость
| | |
|---|---|
| **Minecraft** | 1.21.1 |
| **Загрузчик** | NeoForge |
| **Сторона** | Только сервер |
| **Java** | 21+ |
---
## FAQ
**Могут ли игроки быть в одной сети?**
Да. Отпечаток объединяет IP + UUID, поэтому у двух игроков за одним NAT отпечатки разные.
**Что будет, если игрок использует VPN?**
Его IP меняется → сессия сбрасывается → при следующем входе потребуется подтверждение через Telegram.
**Работает ли это на серверах в offline mode?**
Да, сопоставление идёт по UUID, который NeoForge предоставляет и в online, и в offline mode.
**Токен бота хранится безопасно?**
Он лежит в `config/tgauth-server.toml` на вашем сервере — держите этот файл в тайне.