🎯 Overview

PlayersCompass V2 is a Hytale server plugin that displays other players as markers on your compass and world map, making it easy to find friends and coordinate with teammates. Each player appears with their own marker icon, complete with distance-based scaling and directional indicators.

✨ Features

Player Tracking

Real-time Player Markers: See all nearby players on your compass and map
Player Icons: Each player is represented with a distinctive marker showing their username
Directional Indicators: Markers show which direction players are facing
Distance-Based Scaling: Markers scale based on distance - closer players appear larger, distant players appear smaller

Customizable Settings

Toggle Features: Enable/disable player markers and POI (Points of Interest) independently
Adjustable Range: Set your viewing range from 100 to 10,000 blocks
Personal Preferences: Each player's settings are saved individually and persist across sessions
Privacy Control: Players can disable their compass features if they prefer not to see markers

Persistent Data Storage

HyDB Integration: Uses HyDB for reliable, persistent data storage
Auto-save: Settings are automatically saved and loaded
Cross-world Support: Works across multiple worlds on the same server

🎮 Commands

All commands use the /compass base command:

/compass - Display current settings and help menu
/compass enable <feature> - Enable players or pois tracking
/compass disable <feature> - Disable players or pois tracking
/compass range <blocks> - Set marker visibility range (100-10000 blocks)
/compass reload - Reload your settings from the database

Examples: /compass enable players /compass disable pois /compass range 5000

📋 Requirements

HyDB Plugin: This plugin requires HyDB to be installed for data storage
Hytale Server: Compatible with Hytale server API

🚀 Installation

Download and install HyDB plugin on your server
Download PlayersCompass V2
Place the .jar file in your server's mods folder
Restart or start your server
Configure settings in-game using /compass commands

⚙️ Technical Details

Version: 2.0.0
Persistent Storage: All player preferences are stored in HyDB global database
Performance: Optimized marker updates with configurable range limits
Multi-world: Automatically registers markers for all loaded worlds

🔧 Configuration

All configuration is done in-game per player. Server administrators do not need to manage configuration files. Each player's preferences include:

Players visibility toggle
POIs visibility toggle
Marker visibility range

💡 Use Cases

Cooperative Gameplay: Easily find teammates during raids or building projects
Server Events: Track participants during server-wide events
Social Gaming: Stay connected with friends across large worlds
Exploration: Coordinate group exploration of new areas

🤝 Support

If you encounter any issues or have suggestions, please report them on the issues page.

Note: This plugin enhances multiplayer coordination without giving unfair advantages. Players can only see others within their configured range, and all tracking is visible to all players (no stealth tracking).