SkvsInventory

SkvsInventory
Cross-server inventory synchronization for Paper/Spigot, backed by an SKVS HTTP server.

Keep a player's inventory, armor, offhand, ender chest, XP and health/hunger perfectly in sync across every server in your network — no proxy plugin messaging, no Redis, no MySQL boilerplate. Just point every server at the same SKVS instance and go.

️ Requires SKVS
This plugin does not store data itself — it's a thin sync/backup layer on top of SKVS, a fast, embedded, multi-database SQL engine (Rust core + Node.js/Express HTTP API) with real transactions, indexes, and peer-to-peer replication. Install and configure SKVS first: https://github.com/Titanius69/skvs

✨ Features

• Real-time cross-server sync — saves on virtually every inventory-affecting event (pickup, drop, click, drag, craft, furnace extraction, item consume/break, hand swap, hotbar switch), not just on join/quit.
• Smart debouncing — rapid bursts of events (e.g. sorting a chest) collapse into a single HTTP write instead of one per click.
• Last-write-wins conflict resolution — every save is timestamped, so the most recent change always wins, even under lag or a heavy thread-pool backlog.
• Configurable sync scope — choose exactly what gets synced: inventory, armor, offhand, ender chest, experience, health & hunger.
• Automatic backup history — rolling per-player snapshot history on death, join, quit, and a configurable periodic timer, independent of the live sync data.
• In-game backup browser GUI — admins can browse, preview, and restore any player's past inventory straight from a chest GUI.
• Configurable retention — old backups are pruned automatically after N days (or kept forever).
• Fail-safe by design — optionally kicks a player instead of loading a blank inventory if SKVS is unreachable, preventing item loss/duplication.
• Shared connection config — one plugins/.skvs/config.txt file, readable by any SKVS-backed plugin on the server without any extra library.
• Lightweight — no external dependencies beyond the Paper API; talks to SKVS over plain HTTP.

⚙️ Requirements

• Paper or a Paper-fork server, 1.20+
• Java 17+
• A running SKVS server that this plugin (and any other SKVS-backed plugins) can reach over HTTP

Commands

Command	Description
/skvsinventory reload	Reload configuration and reconnect to SKVS
/skvsinventory status	Show connection info and pending-save count
/skvsinventory sync <player|all>	Force an immediate save
/skvsinventory backup <player>	Open the backup browser GUI
/skvsinventory backup <player> <yyyy-MM-dd> <HH:mm>	Jump the browser to a specific point in time
/skvsinventory backup now <player>	Take a manual backup immediately

Aliases: /skvsinv, /sinv

Permissions

Permission	Default	Description
skvsinventory.admin	op	Manage SkvsInventory (reload/sync/status)
skvsinventory.backup	op	Browse, restore, and export inventory backups

Installation

1. Drop SkvsInventory.jar into your plugins/ folder.
2. Start the server once to generate plugins/.skvs/config.txt and plugins/SkvsInventory/config.yml.
3. Fill in your SKVS connection details in plugins/.skvs/config.txt (shared by all SKVS-backed plugins).
4. Adjust config.yml to taste (what to sync, debounce timing, backup schedule, retention).
5. /skvsinventory reload or restart.