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 Transfer yourself to another configured server.

/transfer Transfer another player.

/transferall 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

1. Download the latest release.
2. Place the JAR into your Paper plugins folder.
3. Start your server.
4. Configure your servers in servers.yml.
5. (Optional) Configure your Trusted Network in network.yml.
6. 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.