
Player Relay
Broadcast and view your friends’ position, health, and XP with simple client-side relays
Screenshots

About this Mod
📡 Player Relay
Player Relay makes it easy to share your in-game status with friends through self-hosted relays.
When you join a relay, your player information (position, health, XP, etc.) is broadcast so others can see it - perfect for:
- Finding lost friends on a server
- Checking your groups status at a glance
✨ Features
- 🖥️ Client-Only - works anywhere, even on vanilla servers
- 🌐 Auto Hosting - optionally start a relay automatically when the game launches
- 🧩 Mod Support
- Xaero's Minimap
/ WorldMap- Display tracked players on your map and in the world
- Share waypoints with connected players
- Ping Wheel
- Send and receive player pings
- Ping color based on name color set in config
- Xaero's Minimap
⚙️ Commands
/prelayhost- start hosting a relayconnect- connect to a relaystop- stop hosting relay and also disconnect from any connected relaysplayers- show the connected player listinv- view a player's inventoryechest- view a player's (or your own) ender chestconfig- open config screen
/prelay_waypointslist- list all shared waypointsaccept- accept all shared waypoints- Enter an index to specify 1 waypoint to accept
🔧 Requirements
💡 Notes
- Never share your real IP address with people you don’t trust.
To let others connect to your hosted relay, you have to give them your public IP. - If your router doesn’t support UPnP, you may need to manually port forward your hosting port so others can connect.
- Want to avoid exposing your real IP or can’t use UPnP/port forwarding?
You can use a virtual LAN (VLAN) service like ZeroTier or Hamachi. These tools create a private virtual network between all players.
Everyone must join the same virtual network for the relay to work, and players will see only the virtual IP, not your real one.
🐛 Found a Bug?
Please report any problems you find to GitHub Issues
Available Versions
How to Install Player Relay on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.10).
Install Mod
Open the mod browser in the dashboard and search for "Player Relay". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.10, 1.21.9, 1.21.8 (+2 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Player Relay server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.10). You can switch loaders with one click in the panel.
Is Player Relay compatible with fabric?
Player Relay officially supports fabric for Minecraft 1.21.10, 1.21.9, 1.21.8. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Player Relay – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Player Relay consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Player Relay with just one click on your server.