
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...
下载 XTransfer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 XTransfer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 XTransfer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 XTransfer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 XTransfer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 XTransfer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 XTransfer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 XTransfer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新增
- 使用临时暂存目录进行事务性文件迁移,以确保数据完整传输(全部成功或全部失败)
- 使用
ScheduledExecutorService实现非阻塞重试机制,并支持配置每次重试之间的延迟时间 - 当最终原子移动操作失败时,自动回滚备份文件
- 在传输失败时清理暂存目录,防止残留临时文件
- 新增
FilePair辅助类,用于封装每个迁移文件的源路径、临时目标路径、最终目标路径以及关键/可选标志
修复
- 因递归调用
copyWithRetry在重试等待期间占用工作线程而导致的线程池阻塞问题 - 单次传输操作中部分文件成功而其他文件失败导致的数据不一致问题(不再允许部分传输)
- 在主数据复制之前未创建备份文件,从而可能导致目标玩家原始数据丢失的问题
更改
copyWithRetry现使用ScheduledExecutorService进行延迟重试,而非在主执行器池上进行递归调用copyFile现在仅执行一次复制尝试并立即返回,重试逻辑由外部处理transferPlayerData及相关方法已被替换为transferAllFiles、copyAllToTemp和moveTempToTarget,以支持事务性迁移- 备份创建及可选文件传输(统计信息、进度)已整合到统一的事务性流程中
- 为提升清晰度,将
ExecutorService重命名为executor;新增scheduler字段用于延迟重试调度
移除
- 阻塞工作线程的递归重试逻辑(
copyWithRetry通过thenCompose自我调用) - 单独的
backupIfNeeded、transferMainData、transferExtraData和transferFile方法,已合并至transferAllFiles及其辅助方法中 - 允许出现部分传输状态的直接文件覆盖方式
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧