Red Bubble | 1.20.2–26.2
RedBubble 1.0.1
Route players from a source Paper or Folia server to an external Paper or Folia destination. Players use your source address; the destination runs the world. Install the same JAR on both servers and pair them from their consoles.

Why RedBubble exists
Some platforms charge for external-server linking. RedBubble is a technical workaround that can bypass the paid linking workflow on compatible networks by relaying through a Paper server you already run. It is not an official integration or permission to break host rules. Minehut, for example, charges credits for its external plan and requires its officially supported method. RedBubble's compatibility with Minehut has not been verified.

Features
  • One JAR for Paper and Folia 1.20.2–26.2, with console pairing and multiple named source keys.
  • Mutual TLS rejects ordinary direct connections that spoof legacy forwarding data.
  • Key reset and removal, connection probe, routing controls and diagnostics.
  • Optional mirroring of the destination's real player count in the source server list.

Exact settings to change
Supports Paper/Folia 1.20.2–26.2 (latest stable checked). Use the Java version your server requires (Java 25 for 26.2). Both backends need compatible legacy BungeeCord-style forwarding and compatible Minecraft login protocols. RedBubble does not translate protocol versions. Merge these values into the existing files and restart; do not replace entire configuration files.
On BOTH servers — spigot.yml
Code:
settings:
  bungeecord: true
On BOTH servers — config/paper-global.yml
Code:
proxies:
  bungee-cord:
    online-mode: true
  velocity:
    enabled: false
  proxy-protocol: false
SOURCE — server.properties
Code:
online-mode=false
The source must be behind a hosting proxy that verifies real Minecraft accounts. Turn Allow Cracked Players / offline-player access OFF in that platform's panel. Only trust verified proxy socket IPs with rdb trust. Keep enforce-secure-profile enabled on the source where supported.
DESTINATION — server.properties
Code:
online-mode=false
enforce-secure-profile=true
The destination's game port must pass TLS traffic through to Paper. Its RedBubble gate rejects direct vanilla connections. Never expose this offline-mode backend without that active gate.

Console setup
Run these in each server's console; most panels omit the leading slash. Never paste a key into Minecraft chat.
1. Source console
Code:
rdb setup source <destination-host> <port>
rdb trust <verified-hosting-proxy-IP>
The first command prints a private RDB1_ key. Use rdb diagnose after a controlled join to identify the proxy's socket IP, then verify it belongs to your host before trusting it.
2. Destination console
Code:
rdb setup destination
rdb add <source-name> <RDB1_key_from_source>
Repeat rdb add with a different name/key for each additional source. Use rdb keys and rdb remove <name> to manage them.
3. Verify Run rdb probe on the source, then join through the source with a real account. Check UUID, skin, world entry and signed chat. For rotation, run rdb reset on the source and replace its named destination key; the old key remains trusted there until replaced or removed.

Limits and responsibility
The upstream proxy authenticates players; pairing proves the sending server, not each player's Microsoft account. Signed chat depends on that proxy preserving the client's signed data. Automated Paper/Folia pairs cover 1.20.2, 1.21.11 and 26.2. Versions 1.19.4 and 1.20.1 could not keep secure-profile enforcement active in the required proxy/offline setup. Real-account signed chat still needs live verification. Player-count mirroring affects server-list replies, not local Bukkit players, so it cannot guarantee prevention of provider idle shutdown.
Use at your own risk. A platform may prohibit unofficial external links and suspend servers, close accounts or revoke access. Users must check and follow each platform's rules. We take no responsibility for closed accounts, bans, lost access or other penalties caused by using RedBubble. The plugin does not grant permission to bypass platform policies.

The download includes the JAR and full setup guide. It contains no generated pairing keys or private server addresses.
Top