0 What the heck is this?

A new plugin designed to transfer players' data between names or UUIDs. I didn't find any other plugin can handle this problem before, so I made my own one and uploaded it to here to help anyone who needs this feature for his/her server.

1 Features

1.1 Smart UUID Detection

Automatically detects UUIDs from:

• Online players
• usercache.json (for premium players)
• Offline-mode UUID generation

1.2 Complete Data Transfer

Transfers all vanilla player data:

• Player inventory and Ender Chest (playerdata/)
• Statistics (stats/)
• Advancements (advancements/) for 1.13+

1.3 Safe & Reliable

• Creates automatic backups before overwriting
• Kicks online players to prevent data overwrite (configurable)
• Asynchronous file operations - no server lag!

2 Commands and Permission Nodes

2.1 Commands

- /xtransfer                          - Show version info
- /xtransfer transfer <old-name> <new-name>  - Transfer by player names
- /xtransfer transferuuid <old-uuid> <new-uuid> - Transfer by UUIDs
- /xtransfer list                      - List all player data files
- /xtransfer list <player>              - Show files for specific player
- /xtransfer reload                     - Reload configuration
- /xtransfer help                       - Show the help message

/xtf = /transfer = /xtransfer

2.2 Permission Nodes

- xtransfer.manage - Allows using all XTransfer commands (default: op)

3 Config

# Show logo when plugin enabled
show_logo: true

# World settings
world:
  # Manual world name (only used if auto-detect is false)
  name: "world"
  # Automatically detect world name from server
  auto-detect: true

# Transfer settings
transfer:
  # Transfer statistics files
  stats: true
  # Transfer advancements files (1.13+)
  advancements: true

  # Backup settings
  backup:
    # Create backup of existing files before overwriting
    create: true
    # Suffix for backup files
    suffix: ".old"

  # Online player handling
  # If true, kick online players before transfer
  # If false, show warning but continue
  kick-online-player: true

# Language settings
language: "en"

# Debug mode (enable only for troubleshooting)
debug: false

# Messages - You can customize all messages here
messages:
  # English messages
  en:
    no-permission: "&cYou don't have permission!"
    usage-header: "&9&lX&f&lTransfer &f&lHelp"
    usage-transfer: "&7/xtransfer transfer &f<old-name> <new-name>"
    usage-transferuuid: "&7/xtransfer transferuuid &f<old-uuid> <new-uuid>"
    usage-list: "&7/xtransfer list &f[player]"
    usage-reload: "&7/xtransfer reload"
    usage-help: "&7/xtransfer help"
    reload-success: "&a✓ Configuration reloaded!"
    transfer-start: "&eStarting async transfer..."

    looking-up: "&eLooking up UUIDs for &f{old} &eand &f{new}&e..."
    uuid-not-found: "&cCould not find UUID for: &f{name}"
    try-uuid: "&7Try using /xtransfer transferuuid with direct UUIDs"
    invalid-uuid: "&cInvalid UUID format! Use: /xtransfer transferuuid <old-uuid> <new-uuid>"
    uuid-example: "&7Example: 12345678-1234-1234-1234-123456789012"

    source-data-missing: "&cSource player {name} ({uuid}) has no data file!"

    transfer-from: "&7From: &f{name} &7({uuid})"
    transfer-to: "&7To: &f{name} &7({uuid})"
    transfer-file: "&7File: &f{file}"
    backup-created: "&7Backed up existing file to: &f{file}"
    transfer-success: "&a✓ Successfully transferred player data!"
    transfer-stats: "&7✓ Transferred stats file"
    transfer-advancements: "&7✓ Transferred advancements file"
    transfer-error: "&cError during transfer: {error}"

    folder-not-found: "&cPlayer data folder not found: {path}"
    source-not-found: "&cSource file not found: {file}"
    source-location: "&7Looked in: {path}"

    player-online-warning: "&e⚠ Warning: Player {player} is online! Data may be overwritten when they log out."
    player-kicked: "&e✓ Player {player} has been kicked for data transfer."
    kick-message: "&cYour data is being transferred. Please rejoin in a few seconds."

    no-files: "&eNo player data files found"
    list-header: "&6=== Player Data Files ({count}) ==="
    list-more: "&7... and {count} more"
    list-entry: "&7{name} &8- {uuid}"
    list-unknown: "&8{uuid} &7(unknown)"

    files-header: "&6=== Files for {player} ==="
    file-playerdata: "&7Player Data: {status}{size}"
    file-stats: "&7Stats: {status}"
    file-advancements: "&7Advancements: {status}"

  # Other language...