PlayersCompass

🎯 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

1. Download and install HyDB plugin on your server
2. Download PlayersCompass V2
3. Place the .jar file in your server's mods folder
4. Restart or start your server
5. 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).