
0 这到底是什么?
一款旨在在玩家名称或 UUID 之间传输玩家数据的新插件。此前我未发现其他插件能处理此问题,因此我自己开发了一款并上传至此,以帮助任何需要此功能的服务器管理员。
1 功能特性
1.1 智能 UUID 检测
自动从以下来源检测 UUID:
- 在线玩家
- usercache.json(针对正版玩家)
- 离线模式下的 UUID 生成
1.2 完整的数据传输
传输所有原版玩家数据:
- 玩家物品栏和末影箱 (
playerdata/)
- 统计数据 (
stats/)
- 进度 (
advancements/),适用于 1.13 及以上版本
1.3 安全且可靠
- 在覆盖前创建自动备份
- 踢出在线玩家以防止数据被覆盖(可配置)
- 异步文件操作——无服务器卡顿!
2 命令与权限节点
2.1 命令
-
/xtransfer - 显示版本信息
-
/xtransfer transfer <旧名称> <新名称> - 按玩家名称进行转移
-
/xtransfer transferuuid <旧UUID> <新UUID> - 按 UUID 进行转移
-
/xtransfer list - 列出所有玩家数据文件
-
/xtransfer list <玩家> - 显示特定玩家的文件
-
/xtransfer reload - 重新加载配置
-
/xtransfer help - 显示帮助信息
/xtf = /transfer = /xtransfer
## 2.2 权限节点
```markdown
- xtransfer.manage - 允许使用所有 XTransfer 命令(默认:op)
3 配置
# 插件启用时显示标志
show_logo: true
# 世界设置
world:
# 手动指定世界名称(仅在自动检测为 false 时使用)
name: "world"
# 从服务器自动检测世界名称
auto-detect: true
# 传输设置
transfer:
# 传输统计文件
stats: true
# 传输进度文件(1.13+)
advancements: true
# 备份设置
backup:
# 在覆盖之前创建现有文件的备份
create: true
# 备份文件的后缀
suffix: ".old"
# 在线玩家处理
# 如果为 true,则在转移前踢出在线玩家
# 如果为 false,显示警告但继续操作
kick-online-player: true
# 语言设置
language: "en"
# 调试模式(仅在排查问题时启用)
debug: false
# 消息 - 您可以在此自定义所有消息
messages:
# 英文消息
en:
no-permission: "&c您没有权限!"
usage-header: "&9&lX&f&lTransfer &f&l帮助"
usage-transfer: "&7/xtransfer transfer &f<旧名称> <新名称>"
usage-transferuuid: "&7/xtransfer transferuuid &f<旧 UUID> <新 UUID>"
usage-list: "&7/xtransfer list &f[玩家]"
usage-reload: "&7/xtransfer reload"
usage-help: "&7/xtransfer help"
reload-success: "&a✓ 配置已重新加载!"
transfer-start: "&e正在启动异步传输..."
looking-up: "&e正在查询 &f{old} &e与 &f{new} &e的 UUID..."
uuid-not-found: "&c未能找到以下玩家的 UUID:&f{name}"
try-uuid: "&7尝试使用 /xtransfer transferuuid 并直接提供 UUID"
invalid-uuid: "&c无效的 UUID 格式!用法:/xtransfer transferuuid <旧-UUID> <新-UUID>"
uuid-example: "&7示例:12345678-1234-1234-1234-123456789012"
source-data-missing: "&c源玩家 {name} ({uuid}) 没有数据文件!"
transfer-from: "&7来自:&f{name} &7({uuid})"
transfer-to: "&7目标:&f{name} &7({uuid})"
transfer-file: "&7文件:&f{file}"
backup-created: "&7已将现有文件备份至:&f{file}"
transfer-success: "&a✓ 玩家数据转移成功!"
transfer-stats: "&7✓ 已转移统计文件"
transfer-advancements: "&7✓ 已转移进度文件"
transfer-error: "&c转移过程中出错:{error}"
folder-not-found: "&c未找到玩家数据文件夹:{path}"
source-not-found: "&c未找到源文件:{file}"
source-location: "&7搜索位置:{path}"
player-online-warning: "&e⚠ 警告:玩家 {player} 在线!其退出时数据可能会被覆盖。"
player-kicked: "&e✓ 已为进行数据转移而踢出玩家 {player}。"
kick-message: "&c您的数据正在转移中,请在几秒后重新加入。"
no-files: "&e未找到任何玩家数据文件"
list-header: "&6=== 玩家数据文件 ({count}) ==="
list-more: "&7... 还有 {count} 个"
list-entry: "&7{name} &8- {uuid}"
list-unknown: "&8{uuid} &7(未知)"
files-header: "&6=== {player} 的文件 ==="
file-playerdata: "&7玩家数据:{status}{size}"
file-stats: "&7统计信息:{status}"
file-advancements: "&7进度:{status}"
# 其他语言...

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...
评论 0
登录后参与评分
还没有评论,来抢沙发吧