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:

# 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:

mvn clean package

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