# LinkSyncPlugin
**LinkSyncPlugin** is a powerful and lightweight Minecraft plugin that allows **two player accounts** to **share the same data** through an intermediate UUID. Built for **Spigot-based servers**, it ensures that only one account can be online at any given time — perfect for players with alt accounts or migrated usernames.
---
## Features
✅ **Shared Player Data**
Both accounts access the same inventories, ender chests, and plugin data (e.g. PlayerVaults).
✅ **Intermediate UUID Storage**
Uses a third, "linked" UUID as a data hub to sync information between accounts.
✅ **Single Session Enforcement**
Ensures only one of the linked accounts can join at a time. The other is blocked if already in use.
✅ **Plugin Compatibility**
Direct file-level integration with supported plugins (e.g. `vaults.yml` from PlayerVaults).
---
## How It Works
[ Account A ] ←→ [ Intermediate UUID ] ←→ [ Account B ]
- When Account A logs out, data is saved to the intermediate UUID.
- When Account B logs in, it loads that data from the intermediate UUID — and vice versa.
- Only one account can be online at a time. Attempts to bypass this are blocked.
---
## Supported Data Sync
| Data Type | Synced? | Notes |
|---------------------|----------|------------------------------------------------------------------|
| Player Inventories | ✅ | Includes hotbar & armor |
| Ender Chest | ✅ | Fully synced |
| PlayerVaults | ✅ | Syncs (PlayerVaultX), you can modify code to sync others |
| Location | ✅ | Sycned even dimensions |
.........
> You can expand this with more plugins and data types as needed.
---
## ⚙️ Installation
1. Download the latest version of **LinkSyncPlugin**.
2. Drop the `.jar` file into your server's `plugins/` folder.
3. Restart the server to generate the config files.
4. Configure your linked UUID pairs in the `config.yml`.
---
License
MIT License © 2025 — Yue
This plugin is open source and free to use or modify.