Shows avatar for each player on the Hytale world map.
Description
Recommended mods
PlayerAvatarMarker
Shows each online player's avatar portrait on the world map (M key) and optionally on the minimap when FastMiniMap is installed. Avatars are fetched from hyvatar.io on first join and cached under the plugin data directory.
Features
- Circular avatar portrait per player on the world map
- Avatars fetched from hyvatar.io on first join and cached in memory + disk
- Low-latency position updates via live movement tracking
- Nickname shown below the avatar without hover when enabled
- Suppresses the vanilla duplicate player marker with generated override assets
- Built-in
/playeravatarUI for map, minimap, and compass visibility control - Online players panel with avatar preview and nickname list
- Minimap overlay — avatars + nicknames appear on the minimap when FastMiniMap is installed
- BetterMap compatibility that respects radar range and viewer settings
- Vanish-aware visibility handling for EliteEssentials, EssentialsPlus, and HyEssentialsX
Data layout
- Global config:
UserData/Saves/<World>/plugins/PlayerAvatarMarker/playeravatarmarker-config.json - Per-player visibility profiles:
UserData/Saves/<World>/plugins/PlayerAvatarMarker/player-settings/<player-uuid>.json - Avatar cache:
UserData/Saves/<World>/plugins/PlayerAvatarMarker/avatar-cache/ - Generated static asset pack:
UserData/Saves/<World>/mods/PlayerAvatarMarkerAssets/
Per-player visibility profiles currently use schemaVersion: 2.
Configuration
| Key | Default | Description |
|---|---|---|
enableBackground |
true |
Draw filled circle behind the avatar |
backgroundColor |
"#2D2D2D" |
Background color (hex) |
enableRotation |
false |
Rotate icon to face player direction |
showNickname |
true |
Show player name below avatar |
avatarSize |
64 |
Output size for generated avatar images (px) |
Commands & Permissions
| Command | Aliases | Description |
|---|---|---|
/playeravatar |
/pam, /avatarmarker |
Opens the PlayerAvatarMarker settings UI |
| Permission | Description | |
| ----------------------------------- | --------------------------- | |
playeravatarmarker.use |
Open the settings UI | |
playeravatarmarker.settings.map |
Toggle world map visibility | |
playeravatarmarker.settings.minimap |
Toggle minimap visibility | |
playeravatarmarker.settings.compass |
Toggle compass visibility | |
playeravatarmarker.admin |
Admin bypass |
Compatibility
- Standalone — world-map avatar markers work without any other mods
- Gains minimap player overlay with FastMiniMap installed
- Gains BetterMap radar/compass support when BetterMap is installed