ExPlayerCompass

🧭 ExPlayerCompass

Track players with a magical compass! ExPlayerCompass is a Minecraft plugin that allows players to track each other across worlds using a special compass.

✨ Features

🎯 Core

- Auto-Update Config: Track any online player with a magical compass - Auto-Update Config: Works across Overworld, Nether, and End - Auto-Update Config: Control who can be tracked (NEW v1.0.4) - Auto-Update Config: 3 languages with native command support - Auto-Update Config: Config automatically updates without deletion

🎬 Video Mode

Perfect for content creators! Clean UI with action bar messages, minimal spam, and optional hidden lore for professional streams and recordings.

🎮 Smart Tracking

Portal memory system remembers where players entered each dimension. Compass continuously updates to target's location. Shows as "Disabled" if target never visited your world. Special handling for The End dimension.

🌍 Supported Languages

Commands automatically adapt to your selected language!

| Language | Command Examples | |----------|-----------------| | 🇬🇧 English | `/expc help`, `/expc track`, `/expc whitelist` | | 🇹🇷 Turkish | `/expc yardim`, `/expc takip`, `/expc beyazliste` | | 🇪🇸 Spanish | `/expc ayuda`, `/expc rastrear`, `/expc listablanca` |

🎮 Commands

Quick Access

| Command | Description | Permission | |---------|-------------|------------| | `/track <player>` | Quickly track a specific player | `expc.track` | | `/tracklist` | Open player selection GUI | `expc.track` | | `/trackgui` | Alternative GUI command | `expc.track` | | `/givetrackall <player>` | Give everyone a compass for target | `expc.admin` |

Main Commands

| Command | Description | Permission | |---------|-------------|------------| | `/expc help` | Show help message | `expc.use` | | `/expc track <player>` | Track a specific player | `expc.track` | | `/expc tracklist` | Open tracking menu | `expc.track` | | `/expc stop` | Stop tracking current player | `expc.track` | | `/expc info` | Show plugin information | `expc.use` | | `/expc reload` | Reload configuration | `expc.admin` | | `/expc givetrackall <player>` | Give compass to all online players | `expc.admin` |

Whitelist/Blacklist (NEW v1.0.4)

| Command | Description | Permission | |---------|-------------|------------| | `/expc trackingfilter` | Show filter status | `expc.admin` | | `/expc trackingfilter <on/off>` | Enable/disable tracking filter | `expc.admin` | | `/expc whitelist add <player>` | Add player to whitelist | `expc.admin` | | `/expc whitelist remove <player>` | Remove player from whitelist | `expc.admin` | | `/expc whitelist list` | Show whitelist | `expc.admin` | | `/expc whitelist clear` | Clear whitelist | `expc.admin` | | `/expc blacklist add <player>` | Add player to blacklist | `expc.admin` | | `/expc blacklist remove <player>` | Remove player from blacklist | `expc.admin` | | `/expc blacklist list` | Show blacklist | `expc.admin` | | `/expc blacklist clear` | Clear blacklist | `expc.admin` |

Note: Commands change based on your language setting in `config.yml`

🔐 Permissions

| Permission | Description | Default | |------------|-------------|---------| | `expc.use` | Basic plugin usage | `true` | | `expc.track` | Track players | `true` | | `expc.admin` | Admin commands (reload, whitelist, blacklist, givetrackall) | `op` |

🎯 Usage

Basic Tracking

``` /track Steve ``` Quickly start tracking player "Steve"

Using GUI

``` /tracklist ``` Opens a menu showing all online players with their health and world

Cycling Targets

Get a tracking compass with `/track <player>`, then right-click to cycle through all online players.

Give Everyone a Compass

``` /givetrackall Steve ``` All online players receive a compass tracking "Steve" - perfect for events!

Whitelist/Blacklist System (v1.0.4)

Control who can be tracked with two filtering modes:

Enabling/Disabling the Filter

The tracking filter must be enabled before using whitelist/blacklist:

```bash

Check current status

/expc trackingfilter

Enable the filter

/expc trackingfilter on

Disable the filter

/expc trackingfilter off ```

Language support: - 🇬🇧 English: `/expc trackingfilter on/off` - 🇹🇷 Turkish: `/expc takipfiltre aç/kapat` - 🇪🇸 Spanish: `/expc filtrorastreo on/off`

Blacklist Mode (Default)

Everyone can be tracked EXCEPT players in the blacklist. ```yaml tracking-filter: enabled: true mode: "blacklist" blacklist: - "Admin" - "Moderator" ```

Commands: ``` /expc blacklist add Admin /expc blacklist remove Admin /expc blacklist list ```

Whitelist Mode

ONLY players in the whitelist can be tracked. ```yaml tracking-filter: enabled: true mode: "whitelist" whitelist: - "Player1" - "Player2" ```

Commands: ``` /expc whitelist add Player1 /expc whitelist remove Player1 /expc whitelist list

Video Setup

Enable in `config.yml`: ```yaml video-mode: enabled: true minimal-messages: true hide-compass-lore: true ```

🌍 Dimensions

When tracking a player in a different dimension, the compass behavior depends on the target's history:

- The End: Points directly to target's real-time location (updates every 0.5s) - The End: Points to last known location in your world (usually portal) - The End: Shows as "Disabled" - The End: Points to End spawn area (0, 100, 0) due to special dimension handling

🔧 Technical

Performance

Optimized with update cooldowns, optional hotbar-only mode, smart location caching, and async cache cleanup.

Requirements

- Dependencies: 1.16.4 or higher - Dependencies: Spigot, Paper, or Purpur - Dependencies: None! Pure Spigot API

📝 Custom Languages

Want to add your own language translation?

1. Copy `plugins/ExPlayerCompass/languages/en.yml` 2. Rename to your language code (e.g., `fr.yml` for French) 3. Translate all messages in the file 4. Important: Translate command aliases under the `commands:` section 5. Set `language: fr` in `config.yml` 6. Reload: `/expc reload`