🧭 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

• Player Tracking: Track any online player with a magical compass
• Cross-Dimensional: Works across Overworld, Nether, and End
• Whitelist/Blacklist System: Control who can be tracked (NEW v1.0.4)
• Multi-Language: 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 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:

# 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.

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.

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:

• Same World: Points directly to target's real-time location (updates every 0.5s)
• Different World (visited before): Points to last known location in your world (usually portal)
• Different World (never visited): 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

• Minecraft: 1.16.4 or higher
• Server: 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