? TransferX
TransferX 是一个轻量级的 Paper 插件,允许你利用 Minecraft 1.20.5 引入的内置传输数据包系统,直接在 Minecraft 服务器之间传输玩家。
忘掉复杂的代理设置吧——TransferX 提供了一种简单且现代化的方式,利用 Minecraft 原生的传输功能来连接多个 Paper 服务器。
⚡ 无需 Velocity。无需 BungeeCord。无需代理。
⸻
✨ 特性
✅ 直接的服务器间传输
✅ 针对 Paper 1.21.x 优化
✅ 可配置的目标服务器(servers.yml)
✅ 加入时和首次加入时自动路由
✅ 路由条件:
- permission_present
- permission_absent
✅ MiniMessage 支持
✅ 多语言支持(英语 & 德语)
✅ 命令补全
✅ 内置冷却时间与速率限制
✅ 防循环保护
✅ 忙碌状态保护
✅ 自动传输配置验证
✅ 自动检测 accept(s)-transfers 并发送管理员警告
✅ 受信任网络支持(可选)
✅ 安全的单次传输令牌系统
✅ 可选的仅传输服务器模式
✅ 面向开发者的公共 API
⸻
? 命令
/transfer <server>
将你自身传输到另一个已配置的服务器。
/transfer <player> <server>
将另一名玩家传输出去。
/transferall <server>
将所有在线玩家传输出去。
/transferreload
重新加载所有配置文件。
/transferlist
显示所有已配置的传输目标。
/transfernetwork
显示当前受信任网络的状态和配置。
⸻
⚙️ 配置
TransferX 会自动创建以下文件:
• config.yml
• servers.yml
• routes.yml
• network.yml
使用 servers.yml 定义你的传输目标,使用 routes.yml 创建自动路由,并使用 network.yml 配置可选的受信任网络系统。
⸻
? 受信任网络(可选)
TransferX 可以选择性地使用共享密钥和一次性传输令牌,在受信任的服务器之间安全地进行传输。
功能包括:
• 受信任服务器认证
• 安全的一次性传输令牌
• 可选的仅传输模式
• 重放攻击保护
• 自动令牌过期
受信任网络系统完全是可选的。即使没有它,直接传输也能正常工作。
⸻
? 开发者 API
TransferX 提供了一个简单的 API,允许其他插件发起传输并接收详细的返回结果状态。
非常适合自定义大厅、认证系统或网络插件。
⸻
? 要求
服务器
• Paper 1.20.5+
推荐
• Paper 1.21.x
Java
• Java 21
客户端
• Minecraft 1.20.5+
⸻
⚠️ 重要提示
每个目标服务器的 server.properties 中必须启用传输功能:
accept-transfers=true
(在较新的 Paper 版本中为 accepts-transfers=true)
否则 Minecraft 将会显示:
Connection failed while transferring to the server.
The server does not accept transfers.
⸻
? 安装
- 下载最新版本。
- 将 JAR 文件放入你的 Paper plugins 文件夹中。
- 启动服务器。
- 在 servers.yml 中配置你的服务器。
- (可选)在 network.yml 中配置你的受信任网络。
- 使用 /transferreload 重新加载或直接重启服务器。
⸻
? 计划中的特性
• ?️ 游戏内配置命令
• ? 配置导入与导出
• ? 交互式设置向导
• ? 平台兼容性(Purpur、Pufferfish 等)
• ? Minecraft 1.26 支持
• ? 扩展开发者 API
⸻
? 为什么选择 TransferX?
TransferX 专注于做一件事:快速、轻量且现代化的服务器传输。
无论你是连接一个简单的 Lobby 和 Survival 服务器,还是在构建完整的 Paper 网络,TransferX 都提供了一个干净的、原生的解决方案,且无需依赖代理。
? TransferX
TransferX is a lightweight Paper plugin that lets you transfer players directly between Minecraft servers using Minecraft’s built-in transfer packet system introduced in Minecraft 1.20.5.
Forget complex proxy setups – TransferX provides a simple and modern way to connect multiple Paper servers using Minecraft’s native transfer functionality.
⚡ No Velocity. No BungeeCord. No proxy required.
⸻
✨ Features
✅ Direct server-to-server transfers
✅ Optimized for Paper 1.21.x
✅ Configurable target servers (servers.yml)
✅ Automatic routing on Join and First Join
✅ Route conditions:
- permission_present
- permission_absent
✅ MiniMessage support
✅ Multi-language support (English & German)
✅ Command tab completion
✅ Built-in cooldown & rate limiting
✅ Anti-loop protection
✅ Busy-state protection
✅ Automatic transfer configuration validation
✅ Automatic accept(s)-transfers detection with administrator warnings
✅ Trusted Network support (optional)
✅ Secure one-time transfer token system
✅ Optional Transfer-Only server mode
✅ Public API for developers
⸻
? Commands
/transfer <server>
Transfer yourself to another configured server.
/transfer <player> <server>
Transfer another player.
/transferall <server>
Transfer every online player.
/transferreload
Reload all configuration files.
/transferlist
Show all configured transfer destinations.
/transfernetwork
Display the current Trusted Network status and configuration.
⸻
⚙️ Configuration
TransferX automatically creates:
• config.yml
• servers.yml
• routes.yml
• network.yml
Use servers.yml to define your transfer targets, routes.yml to create automatic routing, and network.yml to configure the optional Trusted Network system.
⸻
? Trusted Network (Optional)
TransferX can optionally secure transfers between trusted servers using a shared secret and one-time transfer tokens.
Features include:
• Trusted server authentication
• Secure one-time transfer tokens
• Optional Transfer-Only mode
• Replay attack protection
• Automatic token expiration
The Trusted Network system is completely optional. Direct transfers continue to work without it.
⸻
? Developer API
TransferX provides a simple API that allows other plugins to initiate transfers and receive detailed result states.
Perfect for custom lobbies, authentication systems or network plugins.
⸻
? Requirements
Server
• Paper 1.20.5+
Recommended
• Paper 1.21.x
Java
• Java 21
Client
• Minecraft 1.20.5+
⸻
⚠️ Important
Every destination server must enable transfers inside its server.properties:
accept-transfers=true
(or accepts-transfers=true on newer Paper versions)
Otherwise Minecraft will display:
Connection failed while transferring to the server.
The server does not accept transfers.
⸻
? Installation
- Download the latest release.
- Place the JAR into your Paper plugins folder.
- Start your server.
- Configure your servers in servers.yml.
- (Optional) Configure your Trusted Network in network.yml.
- Reload using /transferreload or simply restart the server.
⸻
? Planned Features
• ?️ In-game configuration commands
• ? Configuration import & export
• ? Interactive setup wizard
• ? Platform compatibility (Purpur, Pufferfish & more)
• ? Minecraft 1.26 support
• ? Extended developer API
⸻
? Why TransferX?
TransferX focuses on one thing: fast, lightweight and modern server transfers.
Whether you're connecting a simple Lobby and Survival server or building a complete Paper network, TransferX provides a clean, native solution without requiring a proxy.
评论 0
登录后参与评分
还没有评论,来抢沙发吧