Trash Geyser Doctor

Bedrock players cannot join, Geyser is showing a confusing error, or you are not sure whether Floodgate is configured correctly? Run one command first:

/tgd scan

Trash Geyser Doctor is a free Paper plugin that checks the common parts of a Java + Bedrock crossplay setup and turns them into a short, readable fix list. It is made for server owners who do not want to dig through multiple configs just to find the first problem.

What it checks

Whether Geyser-Spigot is installed
Whether Floodgate is installed
Presence of ViaVersion, ViaBackwards and ProtocolLib (informational only)
A simple crossplay health score
Online-player and Floodgate-prefix hints
Clear console fixes instead of vague errors

Safe setup helper

If Geyser is installed on the same Paper server, Trash Geyser Doctor can save the local Geyser settings for you.

Option 1 — same public Java port

Use this when your host supports UDP on the same port as Java:

/tgd set port same

This writes Geyser's listener to the server port and enables clone-remote-port.

Option 2 — separate allocated UDP port

Use this when your panel gives you a separate UDP allocation:

/tgd set port 19132

Replace 19132 with the UDP port allocated by your host.

The plugin cannot create a Pterodactyl allocation, open a firewall, or forward a router port. It safely updates the local Geyser config; your host/network must allow the selected UDP port.

Floodgate prefix helper

/tgd floodgate prefix fix

This saves Floodgate's username-prefix as *. Restart after running it.

Commands

Command	What it does
`/tgd` or `/tgd scan`	Runs the crossplay check and displays a health score
`/tgd listener setup same`	Explains the same-port listener choice
`/tgd listener setup separate`	Explains the separate-UDP-port choice
`/tgd set port same`	Saves Geyser for the same server port
`/tgd set port <port>`	Saves Geyser for the chosen UDP port
`/tgd floodgate prefix fix`	Saves Floodgate's username prefix as `*`
`/tgd reload`	Reloads Trash Geyser Doctor's own config

Permission

trashgeyser.admin — required for /tgd set port ... and /tgd floodgate prefix fix.

Installation

Download the JAR.
Put it in your server's plugins folder.
Restart Paper, Spigot, or Purpur.
Run /tgd scan from console or as an operator.

Requirements

Java 17 or newer
Paper, Spigot, or Purpur
Geyser and Floodgate are optional: the plugin runs without them and tells you what is missing
No external libraries are bundled or required

Support

Need help reading your scan? Join the TrashMCPE Discord: discord.trashmcpe.com

Planned Premium edition

The free edition is useful on its own. A future Premium edition is planned for deeper diagnostics, redacted support reports and more detailed proxy/standalone guidance. It will not block the free scan or the basic local setup helpers.