SyIDChange

SyIDChange

A Minecraft plugin for 1.21.x, supporting Purpur and Paper, designed to help players who have changed their names migrate their data.

Author

Shiyuan

Features

Use `/sychange <old_name> <new_name>` to migrate inventory data from the old username to the new username.

Supported data migration: - ✅ Inventory Data (Required) - ✅ AuthMe Password - ✅ Residence Claims - ✅ Vault Balance - ✅ PlayerTitle Titles

Installation

1. Place the plugin into your server's `plugins` folder 2. Restart the server or use a plugin manager to load it 3. The plugin will automatically create configuration files

Usage

Commands

``` /sychange <old_name> <new_name> ```

Permissions

- `syidchange.use` - Allows using the data migration command (Default: OP) - `syidchange.admin` - Allows using all administrative features (Default: OP)

Example

``` /sychange OldName NewName ```

This will migrate all data from `OldName` to `NewName`.

Dependencies

Required: - Paper/Purpur 1.21.x

Optional (Soft Dependencies): - Vault + Economy Plugin - For migrating balances - AuthMe - For migrating login passwords - Residence - For migrating claims - PlayerTitle - For migrating titles

Configuration

Configuration file located at `plugins/SyIDChange/config.yml`:

```yaml

Enable debug mode

debug: false

Backup data before migration

backup-before-migrate: true

Migration settings

migration: inventory: true # Inventory data authme: true # AuthMe password residence: true # Residence claims vault: true # Vault balance playertitle: true # PlayerTitle titles ```

Notes

1. Backup is important! Please backup your server data before using this plugin 2. Original player data files will be renamed to `.dat.migrated_timestamp` as backup 3. If the new player already has data, a backup will be created before overwriting 4. It is recommended to perform migration when the player is offline

Compilation

Compile using Maven:

```bash mvn clean package ```

The compiled plugin will be located at `target/SyIDChange-1.0.0.jar`