
概述
SyncShield 通过 Telegram 和/或 Discord 为 Minecraft 登录添加双重身份验证(2FA),阻止未验证玩家加入,并允许管理员通过交互式按钮批准登录。Telegram 和 Discord 机器人完全模块化且可选——你可以仅使用 Telegram、仅使用 Discord,或同时使用两者。它还提供了 Telegram & Discord ↔ Minecraft 聊天同步、跨平台工单和举报系统,以及使用 Monocraft 像素字体对物品栏、物品、末影箱、已书写书籍和成就进行 3D 图像渲染,并支持完整的俄语/英语本地化。
优势
- 模块化架构:独立控制 Telegram 和 Discord 集成的开关(
telegram-enabled 与 discord-enabled)。
- 强大的 2FA 保护:为 OP 强制启用 2FA,并可选择为绑定的非 OP 玩家启用。
- 紧凑的 6 位验证码:通过
/mclink <code>、/start <code> 或直接聊天,使用 6 位代码(如 A3F9X2)快速绑定账号。
- 不区分大小写输入:绑定功能接受大写和小写代码(
a3f9x2 / A3F9X2)。
- 统一的自动所有者与管理员分配:绑定第一个 OP 账号会自动分配
owner-id 并填充 admin-ids / discord-admin-ids。
- 自动配置迁移:包含
config-version,可安全地从旧配置自动迁移(生成 config_*_backup.yml 备份)。
- Monocraft 字体与 RU/EN 本地化:使用
Monocraft.ttf 进行高清像素渲染,自动提供附魔、描述文本、耐久度和书页内容的俄语翻译。
- 完全自定义:每条消息均可自定义,开箱即用即支持
English 和 Russian 语言环境。
- 跨平台工单与举报系统:游戏内
/ticket 和 /report 命令配合 Telegram 和 Discord 的交互式按钮(Claim / Close)、定向线程回复、/ticket chat <msg> 以及游戏内 /ticket close。
- 控制台 RCON 访问:Telegram 和 Discord 中的
/rcon <command>,基于角色/ID 的权限控制和允许列出的命令。
- 3D 图像渲染:将
[inv]、[item]、[ender]、已书写书籍和成就渲染为高质量 PNG 图片,并发送至 Telegram 和 Discord。
快速设置
- 将
syncshield-*.jar 放入服务器的 plugins/ 文件夹,然后启动服务器一次。
- 编辑
config.yml,填入你的 Telegram bot-token 和/或 Discord discord-bot-token。
- 编辑
config.yml 中的 telegram-enabled 与 discord-enabled 值。
- 运行
/syncshield reload 或重启服务器。
- 在游戏中运行
/syncshield link 以生成你的 6 位绑定码。
- 将你的代码(通过
/mclink 或直接发送文本消息)发送给 Telegram 或 Discord 机器人,以绑定账号并获得管理员权限。
命令
Minecraft 命令
-
/syncshield link (别名: /ss link)
生成一个 6 位的一次性代码,用于将你的 Minecraft 账号绑定到 Telegram/Discord。
-
/syncshield settings <always|session|whitelist|disabled>
设置你的个人 2FA 保护模式。
-
/syncshield reload
重新加载 config.yml 和消息文件。自动迁移旧版配置。需要 syncshield.admin 权限。
-
/syncshield config <key> <value>
从游戏内控制台或聊天中直接设置配置值。需要 syncshield.admin 权限。
-
/syncshield debug rebake-textures
强制重新烘焙 3D 方块和物品纹理,仅在遇到渲染错误或升级到新版 Minecraft 时使用。需要 syncshield.debug 权限。
-
/ticket <message>
向管理员打开支持工单。同步至 Telegram 和 Discord。
-
/ticket chat <message>
将聊天消息发送到你活跃的工单线程中(在 Telegram 和 Discord 中)。
-
/ticket close
关闭你当前的支持工单。
-
/report <player> <reason>
向管理员举报一名玩家。同步至 Telegram 和 Discord。
Telegram 命令
-
/start
显示带有快捷操作按钮的主交互菜单。
-
/mclink <code>
使用来自 /syncshield link 的代码绑定你的 Telegram 账号。
-
/players
列出在线玩家并提供快捷管理选项(仅限管理员)。
-
/settings
打开 2FA 模式配置菜单(仅限管理员)。
-
/rcon <command>
执行服务器控制台命令(仅限管理员,当 rcon-enabled: true 时可用)。
Discord 命令
权限
| 权限 |
描述 |
默认值 |
syncshield.use |
允许通过 /syncshield link 绑定账号 |
true |
syncshield.ticket |
允许通过 /ticket 打开工单 |
true |
syncshield.report |
允许通过 /report 举报玩家 |
true |
syncshield.admin |
允许重新加载和修改插件设置(/syncshield reload, /syncshield config) |
op |
syncshield.debug |
允许运行调试命令(/syncshield debug) |
op |
配置示例
# =========================================================
# SyncShield 配置文件
# ---------------------------------------------------------
# 支持的服务器版本:1.16.X - 1.21.X (Paper/Spigot API)。
# =========================================================
# --- 请勿编辑(可能会导致故障) ---
config-version: 2
# =========================================================
# ⚙️ 插件配置(通用设置)
# =========================================================
# 插件默认语言 (en / ru)
language: en
# 操作员(OP)的 2FA 模式:always, session, whitelist, disabled
op-2fa-mode: session
# 已关联账户的非 OP 玩家的 2FA 模式:always(始终)、session(会话)、whitelist(白名单)、disabled(禁用)
non-op-2fa-mode: disabled
# 会话过期时间(小时,仅适用于 'session' 模式)
session-expiry-hours: 12
# 数据存储加密(SQLite)
data-encryption: true
# 在控制台中启用调试输出
debug: false
# Minecraft Ticket & Report System 的主开关
ticket-system-enabled: true
# 启用方块物品烘焙(用于精确的 3D 方块物品渲染)
bake-block-items-on-startup: true
bake-block-items-log-progress: true
# =========================================================
# ✈️ TELEGRAM 配置(机器人及同步设置)
# =========================================================
telegram-enabled: true
bot-token: "YOUR_BOT_TOKEN_HERE"
owner-id: 0
admin-ids: []
private-only: true
rcon-enabled: true
# Telegram <-> Minecraft 聊天同步
chat-sync-enabled: false
chat-sync-chat-ids: []
chat-sync-topics: []
chat-sync-chat-enabled: true
chat-sync-join-leave-enabled: true
chat-sync-death-enabled: true
chat-sync-from-mc: true
chat-sync-from-tg: true
chat-sync-render-inventory: true
chat-sync-render-ender: true
chat-sync-render-items: true
chat-sync-render-books: true
chat-sync-render-advancements: true
# Telegram 工单通知(聊天或主题 ID)
ticket-telegram-chat-id: 0
ticket-telegram-topic-id: 0
# =========================================================
# ? DISCORD 配置(机器人及同步设置)
# =========================================================
discord-enabled: false
discord-bot-token: "YOUR_DISCORD_BOT_TOKEN_HERE"
discord-admin-roles: []
discord-admin-ids: []
discord-rcon-enabled: true
# Discord <-> Minecraft 聊天同步
discord-chat-sync-enabled: false
discord-chat-sync-channel: 0
discord-chat-sync-chat-enabled: true
discord-chat-sync-join-leave-enabled: true
discord-chat-sync-death-enabled: true
discord-chat-sync-from-mc: true
discord-chat-sync-from-dc: true
discord-chat-sync-render-inventory: true
discord-chat-sync-render-ender: true
discord-chat-sync-render-items: true
discord-chat-sync-render-books: true
discord-chat-sync-render-advancements: true
# Discord 工单通知频道 ID
discord-ticket-channel: 0
路线图
| 状态 |
功能 |
关键任务 |
| ✅ |
工单/报告系统 |
在 Minecraft、Telegram 和 Discord 中实现工单/报告系统 |
| ✅ |
旧版支持 |
将逻辑移植到较旧的 Minecraft 版本 |
| ✅ |
Telegram RCON 反馈 |
向 Telegram RCON 添加命令反馈 |
| ✅ |
聊天同步(Telegram) |
集成 Telegram <-> Minecraft 聊天 |
| ✅ |
Discord 2FA |
添加 Discord 登录批准功能 |
| ✅ |
聊天同步(Discord) |
集成 Discord <-> Minecraft 聊天 |
| ✅ |
Discord RCON |
集成 Discord RCON 功能 |
| ❌(计划于 1.6 版本) |
应用认证 |
支持 Google Auth、Authy 等 |
| ❌(计划于 1.7/1.8 版本) |
多加载器支持 |
支持 Quilt、Fabric、Forge 和 NeoForge |
| ❌(计划于 1.8/1.9 版本) |
AI 功能 |
AI 聊天审核、工单/报告处理等 |
| WIP |
Discord 管理 |
统一 Discord 和 Telegram 账户管理选项 |
| WIP |
Discord 按频道工单 |
为每个工单自动创建新频道/线程 |
| WIP |
Telegram 按主题工单 |
为每个工单自动创建新主题(仅限超级群组) |
WIP - 开发中
❌ - 未实现
✅ - 已完成

Overview
SyncShield adds 2FA verification to Minecraft logins via Telegram and/or Discord, blocks unverified joins, and lets admins approve logins via interactive buttons. Both Telegram and Discord bots are completely modular and optional — you can use Telegram only, Discord only, or both simultaneously. It also provides Telegram & Discord ↔ Minecraft chat sync, cross-platform ticket and report systems, and 3D image rendering of inventories, items, ender chests, written books, and advancements using the Monocraft pixel font with full Russian/English localization.
Advantages
- Modular Architecture: Independent toggles (
telegram-enabled & discord-enabled) for Telegram and Discord integrations.
- Strong 2FA Protection: Enforces 2FA for OPs and optionally for linked non-OP players.
- Compact 6-Character Codes: Instant account linking with 6-character codes (
A3F9X2) via /mclink <code>, /start <code>, or direct chat.
- Case-Insensitive Entry: Linking accepts codes in both uppercase and lowercase (
a3f9x2 / A3F9X2).
- Unified Auto-Owner & Admin Assignment: Linking the first OP account automatically assigns
owner-id and populates admin-ids / discord-admin-ids.
- Automatic Config Migration: Includes
config-version with automatic, safe migration from older configurations (config_*_backup.yml).
- Monocraft Font & RU/EN Localization: High-definition pixel rendering using
Monocraft.ttf with automatic Russian translations for enchantments, lore descriptions, durability, and book pages.
- Full customization - Every message is customizable with
English and Russian locales out-of-the-box.
- Cross-Platform Ticket & Report System: In-game
/ticket and /report commands with Telegram & Discord interactive buttons (Claim / Close), targeted thread replies, /ticket chat <msg>, and /ticket close in-game.
- Console RCON Access: Telegram and Discord
/rcon <command> with Role / ID based permissions and allowlisted commands.
- 3D Image Rendering: Renders
[inv], [item], [ender], written books, and advancements into high-quality PNG images delivered to Telegram and Discord.
Quick Setup
- Put
syncshield-*.jar into your server's plugins/ folder and start the server once.
- Edit
config.yml with your Telegram bot-token and/or Discord discord-bot-token.
- Edit
config.yml telegram-enabled & discord-enabled values.
- Run
/syncshield reload or restart the server.
- In-game, run
/syncshield link to generate your 6-character link code.
- Send your code (
/mclink or just text message) to the Telegram or Discord bot to link your account and receive admin access.
Commands
Minecraft Commands
-
/syncshield link (Alias: /ss link)
Generates a 6-character one-time code to link your Minecraft account to Telegram/Discord.
-
/syncshield settings <always|session|whitelist|disabled>
Sets your personal 2FA protection mode.
-
/syncshield reload
Reloads config.yml and message files. Automatically migrates older config versions. Requires syncshield.admin.
-
/syncshield config <key> <value>
Sets a configuration value directly from in-game console or chat. Requires syncshield.admin.
-
/syncshield debug rebake-textures
Forces a fresh bake of 3D block and item textures, use only when encountering rendering errors or updating to a newer Minecraft version. Requires syncshield.debug.
-
/ticket <message>
Opens a support ticket with administrators. Syncs to Telegram and Discord.
-
/ticket chat <message>
Sends a chat message into your active ticket thread in Telegram and Discord.
-
/ticket close
Closes your active support ticket.
-
/report <player> <reason>
Reports a player to administrators. Syncs to Telegram and Discord.
Telegram Commands
-
/start
Displays the main interactive menu with quick action buttons.
-
/mclink <code>
Links your Telegram account using the code from /syncshield link.
-
/players
Lists online players with quick admin management options (Admins only).
-
/settings
Opens 2FA mode configuration menu (Admins only).
-
/rcon <command>
Executes a server console command (Admins only, when rcon-enabled: true).
Discord Commands
Permissions
| Permission |
Description |
Default |
syncshield.use |
Allows linking account via /syncshield link |
true |
syncshield.ticket |
Allows opening tickets via /ticket |
true |
syncshield.report |
Allows reporting players via /report |
true |
syncshield.admin |
Allows reloading and modifying plugin settings (/syncshield reload, /syncshield config) |
op |
syncshield.debug |
Allows running debug commands (/syncshield debug) |
op |
Config Example
# =========================================================
# SyncShield Configuration File
# ---------------------------------------------------------
# Supported server versions: 1.16.X - 1.21.X (Paper/Spigot API).
# =========================================================
# --- DO NOT EDIT (Will probably break something) ---
config-version: 2
# =========================================================
# ⚙️ PLUGIN CONFIG (General Settings)
# =========================================================
# Default Language for the plugin (en / ru)
language: en
# 2FA mode for Operators (OPs): always, session, whitelist, disabled
op-2fa-mode: session
# 2FA mode for non-OP players who have linked their account: always, session, whitelist, disabled
non-op-2fa-mode: disabled
# Session expiry in hours (only for 'session' mode)
session-expiry-hours: 12
# Data storage encryption (SQLite)
data-encryption: true
# Enable debug outputs in the console
debug: false
# Master switch for Minecraft Ticket & Report System
ticket-system-enabled: true
# Block item baking (for accurate 3D block item renders)
bake-block-items-on-startup: true
bake-block-items-log-progress: true
# =========================================================
# ✈️ TELEGRAM CONFIG (Bot & Sync Settings)
# =========================================================
telegram-enabled: true
bot-token: "YOUR_BOT_TOKEN_HERE"
owner-id: 0
admin-ids: []
private-only: true
rcon-enabled: true
# Telegram <-> Minecraft Chat Sync
chat-sync-enabled: false
chat-sync-chat-ids: []
chat-sync-topics: []
chat-sync-chat-enabled: true
chat-sync-join-leave-enabled: true
chat-sync-death-enabled: true
chat-sync-from-mc: true
chat-sync-from-tg: true
chat-sync-render-inventory: true
chat-sync-render-ender: true
chat-sync-render-items: true
chat-sync-render-books: true
chat-sync-render-advancements: true
# Telegram Ticket Notifications (Chat or Topic ID)
ticket-telegram-chat-id: 0
ticket-telegram-topic-id: 0
# =========================================================
# ? DISCORD CONFIG (Bot & Sync Settings)
# =========================================================
discord-enabled: false
discord-bot-token: "YOUR_DISCORD_BOT_TOKEN_HERE"
discord-admin-roles: []
discord-admin-ids: []
discord-rcon-enabled: true
# Discord <-> Minecraft Chat Sync
discord-chat-sync-enabled: false
discord-chat-sync-channel: 0
discord-chat-sync-chat-enabled: true
discord-chat-sync-join-leave-enabled: true
discord-chat-sync-death-enabled: true
discord-chat-sync-from-mc: true
discord-chat-sync-from-dc: true
discord-chat-sync-render-inventory: true
discord-chat-sync-render-ender: true
discord-chat-sync-render-items: true
discord-chat-sync-render-books: true
discord-chat-sync-render-advancements: true
# Discord Ticket Notifications Channel ID
discord-ticket-channel: 0
Roadmap
| Status |
Feature |
Key Task |
| ✅ |
Ticket/report system |
Implement a ticket/report system in Minecraft, Telegram & Discord |
| ✅ |
Legacy Support |
Port logic to older Minecraft versions |
| ✅ |
Telegram RCON Feedback |
Add command feedback to Telegram RCON |
| ✅ |
Chat Sync (Telegram) |
Integrate Telegram <-> Minecraft chat |
| ✅ |
Discord 2FA |
Add Discord login approval functions |
| ✅ |
Chat Sync (Discord) |
Integrate Discord <-> Minecraft chat |
| ✅ |
Discord RCON |
Integrate Discord RCON functionality |
| ❌ (Planned for 1.6) |
App Authentication |
Support Google Auth, Authy, etc. |
| ❌ (Planned for 1.7/1.8) |
Multi-Loader Support |
Support Quilt, Fabric, Forge, and NeoForge |
| ❌ (Planned for 1.8/1.9) |
AI functionality |
AI chat moderation, ticket / report handling, etc. |
| WIP |
Discord management |
Unify Discord & Telegram account management options |
| WIP |
Discord per-channel tickets |
Add automatic creation of a new channel / thread for each ticket |
| WIP |
Telegram per-topic tickets |
Add automatic creation of a new topic for each ticket (supergroups only) |
WIP - Work in progress
❌ - Not implemented
✅ - Done
评论 0
登录后参与评分
还没有评论,来抢沙发吧