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.