SyncShield

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

• /mclink <code>
  Links your Discord account using the code from /syncshield link.

• /rcon <command>
  Executes a server console command (Requires a role configured in discord-admin-roles).

# =========================================================
# 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

WIP - Work in progress
❌ - Not implemented
✅ - Done