FurinSyncInv

FurinSyncInv
Written by AI, manually tested.
Cross-server data sync · Automatic backups · Player items never lost
Paper / Folia ready | MySQL + Redis dual storage | Auto-adapts to 11 languages

Plugin community (QQ): 961650477
Discord: discord.gg/jktye5jmCR

Seamless Cross-Server Experience
When players switch between any sub-server, their data follows automatically — inventory, ender chest, XP, potion effects, stats, and achievements fully sync. The moment they land is exactly how they left it. No more "changing servers means starting over".

• MySQL authoritative storage + Redis high-speed cache: dual-write architecture — a failure in one storage doesn't affect the other; cache read failures automatically fall back to MySQL and refill, giving data a safety net.
• Cross-server lock + heartbeat detection: prevents players being online on two servers at once from overwriting each other's data; a server whose heartbeat times out is treated as offline and its lock is released.
• Double timeout safety net: admins can force-unlock with one click when a lock goes wrong; players locked for too long can self-unlock — zero deadlock burden.
• Auto-save: scheduled saves to the database (interval configurable), saves on logout, no progress ever lost.

Smart Backup System
Automatic, on-join, and on-logout backup triggers — all configurable, all stored in MySQL, browsable anytime.

• Smart deduplication: backups are skipped automatically when data is identical to the last one, saving database space and I/O.
• Retention auto-cleanup: expired backups are deleted automatically day by day, never bloating.
• Fully async writes: Hikari connection pool + async database writes, with no impact on game performance.

GUI Backup Management

• Four-layer GUI menu: main menu → type list → inventory/ender selection → view. Everything is clear at a glance.
• Hover for details: source server, time, world, coordinates, and backup ID all visible on hover.
• Item extraction: take whichever items you want, Shift-click to pick one up.
• One-click packed export: backup items are boxed up automatically and placed directly into the admin's inventory.

Quick Shulker Box
Right-click to open a shulker box in your inventory and edit it, with contents written back to the item in real time.

• Nesting prevention: shulker boxes / maps / bundles cannot be placed inside.
• Anti-movement: dropping, moving slots, executing commands, and chatting are all disabled while open.

LobbyGames Integration
Deeply compatible with a popular minigame plugin: player data is saved instantly when entering a minigame; auto-save and scheduled backups are paused during minigames, keeping competitive data pristine.

Native-Level Experience
11 built-in languages: Simplified Chinese, Traditional Chinese (Taiwan), Traditional Chinese (Hong Kong), English, German, French, Spanish, Japanese, Korean, Russian, Portuguese. The player's client language is detected automatically — speak Chinese and get Chinese, speak English and get English; servers can also force a single language.

⚙️ Built for Ops

• Auto config updates: plugin upgrades automatically merge new config options, keep your modified values, keep comments, and clean up old keys.
• Fully async I/O + region thread safety: perfectly adapted to Folia region scheduling — lag? Never heard of it.
• Debug diagnostics commands: check sync status, cross-server locks, and Redis/MySQL connectivity in one go; console Debug output can be toggled anytime with /furinsyncinv debug and persisted to config.
• Standalone server.yml: multi-server identifiers managed separately — cross-server locks and backup sources are clearly distinguishable.

Commands & Permissions
Commands

• /furinsyncinv unlock — player self-unlock (after being locked by a cross-server lock past the time limit)
• /furinsyncinv unlock <player> — admin force-unlocks another player
• /furinsyncinv backup <player> — admin opens the backup management menu
• /furinsyncinv debug — admin toggles console Debug output
• /furinsyncinv debug <player> — admin views sync diagnostics
• /furinsyncinv reload — admin reloads the config

Permission Nodes

• furinsync.unlock.self — player self-unlock, granted to all players by default
• furinsync.shulker.use — quick shulker box, granted to all players by default
• furinsync.admin — admin permission (force-unlock others / backup / debug / reload), OP-only by default

Regular players can only unlock themselves — they cannot unlock other players. Unlocking others, as well as backups, debug, and reload, all require furinsync.admin.