CompassEx 3

Your compass, but heavily improved.

This plugin allows you to easily set your compass to different positions. You can set it to coordinates, players and of course, back to spawn.

Features

• Set your compass to players, coordinates and your current position
• Save your location or current compass target for later use
• Make saved locations private or public
• Automatic updates to player positions
• Set yourself as hidden, so that you cant be tracked by others
• Admins can follow even hidden users
• Economy support with Vault for save, private, and public commands
• Dynmap support
• Multiworld support

Commands

The original CompassEx command /compassex has also aliases: /cp and /compass.

Warning: Since CompassEx 3.0.2 only the /compassex command will always be available, /compass may be used by another plugin!. See Bukkit aliases for more information about how to set /compass to /compassex for conflicts.

Basics

Basic commands to set your compass target.

Saving and Loading

CompassEx allows you to save locations by IDs which can be later loaded. Since CompassEx 3 these are seperated per player, so that multiple players can have locations saved with the same name without conflicts. Public locations are also possible. However, these will be "shadowed" by private locations, for example if there's a public location named home and a player has one home too, then when loading, the private location of the player will be used.

To create public locations, first create a private one and then publicize it.

Hiding

Hiding allows you to hide yourself from being tracked by other players through the /compass player and the /compass live commands if they're not admins.

Info Commands

These commands show some information about your current compass target or a saved location if an ID is given.

An ID may be just an ID (your own private location), public followed by the ID (a public location) or a player name and the ID (a private location of someone).

Installation

Just copy the jar file into your plugins folder, start your server so that the config gets generated and stop it. Then edit the config file at will. Now start your server again.

Permissions

Heads up! The rename commands use the respective compassex.remove, compassex.save and compassex.publicize (if the location is public) permissions.

Extra: If you want to have players automatically hidden when they join, give them the compassex.autohide permission.

Configuration

The configuration is really simple (you can find it in plugins/CompassEx/config.yml):

• live-update-rate: Sets how fast the position of the live tracked player get refreshed. Setting it to a small number may result in poor server performance. Recommended value: 200 (2 seconds).
• help-page-num-commands: Number of commmands per page of /compassex help
• save-cost: How much a user without compassex.save.free permission has to pay to save a target.
• privatize-cost: How much a user without compassex.privatize.free permission has to pay to privatize a target.
• publicize-cost: How much a user without compassex.publicize.free permission has to pay to publicize a target.
• enable-dynmap: Whether to show public locations in dynmap.
• dynmap-icon: Set a dynmap icon for CompassEx markers.

More

This plugin uses mcstats.org's Plugin Metrics. That means it sends anonymous statistics to mcstats.org to help me develop the plugin. You can find more about it and how to disable it here.

Do you think you found any bugs? Submit one here.

You think you can help by adding a feature or fixing a bug? Go to the GitHub repository.

<small>Compass image from MinecraftWiki.</small>