{"id":153756,"date":"2026-06-09T10:48:11","date_gmt":"2026-06-09T07:48:11","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/"},"modified":"2026-06-09T10:48:11","modified_gmt":"2026-06-09T07:48:11","slug":"tgauth2","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/","title":{"rendered":"TgAuth2"},"content":{"rendered":"

# TgAuth \u2014 Telegram Authentication<\/p>\n

> **Server-side only.** Players authenticate via Telegram on every login. No client mod needed.<\/p>\n

—<\/p>\n

## How it works<\/p>\n

### New player \u2014 first time setup<\/p>\n

1. Player opens Telegram \u2192 sends `\/start` to the bot
\n2. Bot checks the whitelist \u2192 issues a **6-digit code**
\n3. Player joins the server \u2192 types `\/tgauth link `
\n4. Account is permanently linked to their Telegram<\/p>\n

### Returning player \u2014 every login<\/p>\n

```
\nJoin server
\n \u2502
\n \u25bc
\nSame device as last time? (IP-based session, valid 12 hours)
\n \u251c\u2500\u2500 YES \u2192 Auto login, no Telegram needed \u2705
\n \u2514\u2500\u2500 NO \u2192 Bot sends confirmation to Telegram:
\n [\u2705 Yes] [\u274c No]
\n \u2502 \u2502
\n Logged in \u2705 Kicked \u274c
\n```<\/p>\n

---<\/p>\n

## Features<\/p>\n

- \ud83d\udd10 **Per-login Telegram confirmation** \u2014 every new device requires approval
\n- \ud83d\udcbe **12-hour device sessions** \u2014 same IP = no prompt within the session window
\n- \ud83d\udccb **Whitelist by Telegram ID** \u2014 only approved users can register
\n- \ud83e\udd16 **Inline keyboard buttons** \u2014 Yes\/No directly in Telegram chat
\n- \u23f1 **Configurable timeout** \u2014 kick if no response within N seconds
\n- \ud83d\udd27 **Admin commands** \u2014 manage whitelist, force-approve, clear sessions
\n- \ud83d\udcbf **Persistent data** \u2014 links survive server restarts (`world\/data\/tgauth_players.json`)<\/p>\n

---<\/p>\n

## Setup<\/p>\n

**1. Create a Telegram bot**<\/p>\n

Open @BotFather \u2192 `\/newbot` \u2192 copy the token.<\/p>\n

**2. Get Telegram IDs of your players**<\/p>\n

Each player writes to @userinfobot \u2192 copies their `Id`.<\/p>\n

**3. Configure** `config\/tgauth-server.toml`<\/p>\n

```toml
\n[bot]
\n botToken = \"1234567890:AAH...\"
\n botUsername = \"MyServerAuthBot\"<\/p>\n

[whitelist]
\n telegramIds = [\"123456789\", \"987654321\"]<\/p>\n

[session]
\n durationHours = 12
\n```<\/p>\n

**4. Restart the server.** Done.<\/p>\n

---<\/p>\n

## Commands<\/p>\n

### Players<\/p>\n

| Command | Description |
\n|---|---|
\n| `\/tgauth link ` | Link Telegram account (new players) |
\n| `\/tgauth status` | Show link status and active session |<\/p>\n

### Operators (OP 2+)<\/p>\n

| Command | Description |
\n|---|---|
\n| `\/tgauth admin whitelist list` | List all whitelisted Telegram IDs |
\n| `\/tgauth admin whitelist add ` | Add a Telegram ID |
\n| `\/tgauth admin whitelist remove ` | Remove a Telegram ID |
\n| `\/tgauth admin unlink ` | Unlink a player's Telegram account |
\n| `\/tgauth admin force ` | Force-approve a pending login |
\n| `\/tgauth admin sessions ` | Show active device sessions |
\n| `\/tgauth admin clearsessions ` | Invalidate all device sessions |
\n| `\/tgauth admin reload` | Reload whitelist from config |<\/p>\n

---<\/p>\n

## Compatibility<\/p>\n

| | |
\n|---|---|
\n| **Minecraft** | 1.21.1 |
\n| **Loader** | NeoForge |
\n| **Side** | Server only |
\n| **Java** | 21+ |<\/p>\n

---<\/p>\n

## FAQ<\/p>\n

**Can players be on the same network?**
\nYes. The fingerprint combines IP + UUID, so two players from the same NAT have different fingerprints.<\/p>\n

**What happens if a player uses a VPN?**
\nTheir IP changes \u2192 session invalidated \u2192 Telegram confirmation required on next login.<\/p>\n

**Does this work with offline mode servers?**
\nYes, matching is done by UUID which NeoForge provides in both online and offline mode.<\/p>\n

**Is the bot token stored securely?**
\nIt lives in `config\/tgauth-server.toml` on your server \u2014 keep that file private.<\/p>\n","protected":false},"excerpt":{"rendered":"

Server-side Telegram authentication for NeoForge 1.21.1. Players verify via Telegram bot on every login with 12-hour device sessions.<\/p>\n","protected":false},"featured_media":153757,"template":"","meta":{"_minecraft_slug":"tgauth2","_minecraft_project_id":"KKuMrYyB","_minecraft_author":"annimir","_minecraft_license":"Apache-2.0","_minecraft_downloads":5,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"tgauth2.zip","_minecraft_size_bytes":3167611,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:19:58.401706Z","_minecraft_date_created":"2026-05-12T06:37:22.275989Z","_minecraft_date_modified":"2026-05-04T06:00:05.973947Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/tgauth2","_minecraft_icon_attachment_id":153757,"_minecraft_imported_at":"2026-06-09T07:48:12+00:00","_minecraft_import_hash":"23997313bc0a659f96f10b88307400d9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[158,867,92],"mod_loader":[160],"minecraft_version":[37],"class_list":["post-153756","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-neoforge","mod_category-social","mod_category-utility","mod_loader-neoforge","minecraft_version-1-21-1"],"yoast_head":"\nTgAuth2 - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"TgAuth2 - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Server-side Telegram authentication for NeoForge 1.21.1. Players verify via Telegram bot on every login with 12-hour device sessions.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tgauth2\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tgauth2\\\/\",\"name\":\"TgAuth2 - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tgauth2\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tgauth2\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/tgauth2-icon-0d9cb22e04996091893c52eb6f66c91c659d3d78_96.webp\",\"datePublished\":\"2026-06-09T07:48:11+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tgauth2\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tgauth2\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tgauth2\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/tgauth2-icon-0d9cb22e04996091893c52eb6f66c91c659d3d78_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/tgauth2-icon-0d9cb22e04996091893c52eb6f66c91c659d3d78_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tgauth2\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"TgAuth2\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"TgAuth2 - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/","og_locale":"en_US","og_type":"article","og_title":"TgAuth2 - Minecraft","og_description":"Server-side Telegram authentication for NeoForge 1.21.1. Players verify via Telegram bot on every login with 12-hour device sessions.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/","name":"TgAuth2 - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/tgauth2-icon-0d9cb22e04996091893c52eb6f66c91c659d3d78_96.webp","datePublished":"2026-06-09T07:48:11+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/tgauth2-icon-0d9cb22e04996091893c52eb6f66c91c659d3d78_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/tgauth2-icon-0d9cb22e04996091893c52eb6f66c91c659d3d78_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/tgauth2\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"TgAuth2"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/153756","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/153757"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=153756"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=153756"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=153756"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=153756"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}