Перейти к содержимому
Mineforgian

Player Relay

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

Загрузки
2K
Подписчики
15
Обновлён
21 июня 2026 г.
Лицензия
AGPL-3.0-only

Опубликован 27 августа 2025 г.

📡 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

⚙️ Commands

  • /prelay
    • host - start hosting a relay
    • connect - connect to a relay
    • stop - stop hosting relay and also disconnect from any connected relays
    • players - show the connected player list
    • inv - view a player's inventory
    • echest - view a player's (or your own) ender chest
    • config - open config screen
  • /prelay_waypoints
    • list - list all shared waypoints
    • accept - 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

Ченджлог

1.5.1+1.21.11Бета1.21.11 · 21 июня 2026 г.
  • Player list HUD fixes
    • Raise player model camera to not clip player head
    • Fix bug where you could get pushed by a player in another server when rendering player model
1.5.0+1.21.10Бета1.21.9, 1.21.10 · 20 июня 2026 г.

✨ New Features

Server support [⚠️EXPERIMENTAL]

  • If both the client and the server have Player Relay installed, the mod should work between clients
  • Players may still manually connect (/connect) to an external relay if they want to see player info from another server
  • The server must have Ping Wheel installed for other players to send and receive pings
    • Player Relay only relays Ping Wheel pings when connected to a P2P relay, not a server - it's Ping Wheel's job to broadcast the packets

Parties

  • Server only feature
  • Restricts player information to only members of the party
  • Currently doesn't save when exiting world

Join codes

  • Encrypts whichever connection address is provided
    Address for connecting can be changed in General->Host->Connection Address
  • Does not hide your IP address, only obscures it from being easily visible

New config options

  • General
    • Use Encrypted Join Codes - turn off to replace join codes (j:DGcvwwreF ...) with addresses
      (default: ON)
  • Client
    • Use Resource Pack Icons - turn on to replace vanilla icons with the ones in your resource pack
      (default: OFF)

🔧️ Fixes & Improvements

  • IP addresses in logs and chat are replaced with fingerprints (Peer<gt4dsf>)
  • Clients can now view their ender chest contents immediately on join, without needing to open an ender chest first, as long as the server has the mod installed
  • Player list now updates every tick instead of every frame

🔃 Major Code Refactors

Large portions of the codebase were restructured to support client ↔ server communication

This should improve how Player Relay works internally, but may also introduce new bugs

🐛 Found a Bug?

Please report any problems you find to GitHub Issues

1.4.2+1.21.10Бета1.21.9, 1.21.10 · 26 октября 2025 г.
  • Add idle animation to player models
  • Add shivering to player models when frozen
  • Fix Ping Wheel and Xaero's Minimap mixin crash
1.4.2+1.21.8Бета1.21.6, 1.21.7, 1.21.8 · 26 октября 2025 г.
  • Add idle animation to player models
  • Add shivering to player models when frozen
  • Fix Ping Wheel and Xaero's Minimap mixin crash
1.4.0Бета1.21.6, 1.21.7, 1.21.8 · 25 октября 2025 г.

⚠️ Warning

This version is incompatible with versions 1.3.0 and below.

New Features

  • Player list
    • Added player model rendering
    • Added dimension icons
    • Added player status overlay (AFK and death)
  • Added echest command:
    • View another player's ender chest
    • Player must have opened their ender chest at least once in the current world
    • Lets you view your own ender chest if a player isn't specified
    • Ender chest inventory updates when you re-run the command
  • Added custom player name colors
    • Colors also apply to pings from Ping Wheel
  • Added Xaero's Minimap / WorldMap waypoint sharing via Player Relay
  • New config options:
    • Client
      • Display Name Color (default: #FFFFFF)
      • AFK Timeout (default: 120'000ms)
    • Player List
      • Show Dimension Icon (default: ON)
      • Player Icon Type (default: PLAYER_MODEL, previously PLAYER_HEAD)
    • Xaero's Minimap / WorldMap
      • Share Waypoints Via Player Relay (default: ON previously OFF)

Changes & Fixes

  • Support Ping Wheel 1.12.0
    • Older Ping Wheel versions are now incompatible
  • Renamed peekinv command to inv
  • Fixed config not saving color types correctly
  • Fixed player name and UUID being unknown until a world is loaded
1.3.0Бета1.21.8 · 10 октября 2025 г.

⚠️ Warning

This version is incompatible with versions 1.2.1 and below. New network features have been added that break compatibility with older versions. If you're running version 1.2.0 or above, you'll receive a warning when trying to connect to incompatible versions.

New Features

  • Show active status effects in the player list
  • Display context-sensitive heart, armor, and food icons based on player status (poison, wither, frozen, etc.)
  • Added peekinv command:
    • View another player's inventory and equipment
    • Equipment changes update live
    • Inventory updates when you re-run the command
  • Added config options:
    • Host
      • UPnP Enabled - automatically configure port forwarding (default: ON)
    • Player List
      • Info Width - customize width of player list (default: 86)
    • Xaero's Minimap / WorldMap
      • Show Players (default: ON)
      • Show Players From Other Servers (default: OFF, previously ON)
    • Ping Wheel
      • Show Pings From Other Servers (default: OFF, previously ON)

Fixes & Improvements

  • Fixed multiple player info packets not being grouped into a single update (reduces network congestion)
  • Improved XP bar rendering
  • Corrected player list stat alignment (left-aligned, center-aligned, right-aligned)
1.2.1Бета1.21.8 · 27 сентября 2025 г.
  • Support Ping Wheel 1.11.0
    • Ping Wheel version 1.10.3 is incompatible because of code changes
  • Fix disconnect caused by incompatible Ping Wheel versions
1.2.0Бета1.21.8 · 27 сентября 2025 г.

⚠️ COMPATIBILITY WARNING

This version is incompatible with all previous versions. All players must update to the same version to connect successfully.

New Features

  • Host peer connections - Allows hosts to connect to other peers, enabling larger networks where relays connect to each other
  • Relay version checking - Prevents connecting to incompatible versions
  • Player List Offset - New config option to move the player list
  • Config command - Quickly open config screen with the config command

Fixes & Improvements

  • Display some errors and warnings in chat for easier troubleshooting
  • Fixed packets repeatedly circulating through network
  • Prevent connecting to existing connections and to yourself

Комментарии

Загружаем…