MythicItemSync

**MythicItemSync** is a lightweight, performance-focused utility plugin designed to automatically keep **MythicMobs items synchronized** across player inventories. It safely updates Mythic items after MythicMobs reloads and during gameplay interactions, while **preserving enchantments (including unsafe), durability, and custom NBT / PersistentDataContainer data** added by players or other plugins. The plugin uses a **queue-based, tick-safe synchronization engine** to prevent lag and performance spikes on live servers. Mythic items are updated in real time when players take them from containers (such as chests or shulker boxes), with **anti-spam cooldown protection** to prevent abuse. Nested shulker boxes are supported with configurable depth limits for safety. All sync activity is written to a **dedicated log file (`logs/sync.log`)** with timestamps and execution time, keeping the console and player chat completely clean. Every feature is fully configurable through `config.yml`, with **bilingual EN / VI comments** for easy setup. Designed for **Paper / Spigot 1.21+** servers running MythicMobs. --- ## **Commands** * `/mythicitemsync` * `/msync` * `/mis` ### Command List * `/msync sync <player|all>` Manually synchronize MythicMobs items for a specific player or all online players. * `/msync reload` Reload the plugin configuration and language files. * `/msync status` View current sync queue size and running sync tasks. --- ## **Permissions** | Permission | Description | | ----------------------- | ------------------------------------ | | `mythicitemsync.use` | Access basic MythicItemSync commands | | `mythicitemsync.sync` | Allows manual item synchronization | | `mythicitemsync.reload` | Allows reloading the plugin | | `mythicitemsync.admin` | Full access to all plugin features | > **Note:** > `mythicitemsync.admin` includes all other permissions.