Logo
PlayerLocater
PluginMIT

PlayerLocater

This plugin allows you to save positions and track the location of players in real time.

95
Downloads
0
Followers
7 months ago
Updated
📦
7
Versions
adventurebukkitpaperpurpurspigot
Download Latestv3.3.1View on Modrinth

📖About PlayerLocater

PlayerLocater

It's a plugin that is developed as a hobby project.
It offers the functions:

  • Save Waypoints
  • Share waypoint in chat (private, only for you)
  • Share waypoint in chat (Public, visible to members of your selected group)
  • Track the position of players and see the position every 5 seconds in the Bossbar.

The main command is /position or /pos

👨‍💻Commands

Track Command

/position track <player>

/position untrack <player>

A player executes the /pos track <player> command. A BossBar then appears, showing the position of the player to be tracked. The boss bar updates every 5 seconds. Then the player executes the /pos untrack <player> command and the boss bar with the position disappears again

WayPoint Command

/position waypoint save <name>

/position waypoint remove <name>

/position waypoint get <name>

Positions are saved in the "positions.json" file

The player executes the /pos waypoint save <name> command. After executing the command, a message appears stating that the position has been successfully saved. When the /pos waypoint remove <name> command is executed, the position is deleted again and another success message appears. The player also executes the /pos waypoint get <name> command, whereupon the position is shared in the chat

Position in Tab

When the player moves, you can see that the current position is always displayed in the tab bar.

Group Command

Groups are an important issue when playing on the server with several people. They allow you to share positions in groups so that you always have the target in mind!

/position group create <name>

To create a group, use this command!

/position group invite <name> <player>

To invite a player, use the /position group invite command. You must use the arguments "name" and "player" with the corresponding attributes. E.g. /position group invite group PapaKekse

/position group leave <name>

The command is used to leave a group

/position group remove <name>

The command is used to delete a group

/position group accept <player>

This command is used to accept an invitation sent with the invite command

The player executes the above commands

Share Command

The command is used to divide a position in a group. Everyone in the group will then see the position in the chat

/position share <name> <group>

The player executes the share command, sharing the position for all players in the group in the chat
A position in the chat

🌐Languages:

Available:

  • English (lang_en)
  • German (lang_de)

You can change the language in the config.yml File

After you have changed the language, you can reload the language data with the /position reload command.
When you update the plugin, the selected file will automatically update.

To add your own language, you can create a file in the "language" folder of the plugin folder (PlayerLocater) and set the language in the config.yml file to the filename without the ".json" extension.
The first time you start the server with the new language file, the file will automatically have the English translation in it, so you can add your language more easily.

How to Create a Custom Language File

Follow these steps to create and use your own language file:

1. Create a JSON File

  • Make a new file, e.g., lang_fr.json (or any name you like).
  • This file will later contain all the texts for your server in your chosen language.

2. Select the Language in config.yml

  • Open config.yml and set the language to the name of your file without the .json extension.
  • Example:

language: lang_fr

3. Start the Server

  • On the first start, the file will automatically be filled with the default English texts.

4. Edit the Language

  • Open the JSON file and translate the texts into your preferred language.
  • Important: Do not change the structure of the JSON file.

5. Reload the Language

  • Run the following command on your server to apply the changes:
/position reload

🔑Permissions

Track Command

/position track - "position.track"

/position untrack - "position.untrack"

Waypoint Command - "position.waypoint"

/position waypoint save - "position.waypoint.save"

/position waypoint remove - "position.waypoint.remove"

/position waypoint get - "position.waypoint.get"

Group Command - "position.group"

/position group create - "position.group.create"

/position group invite - "position.group.invite"

/position group leave - "position.group.leave"

/position group remove - "position.group.remove"

/position group accept - position.group.accept"

Share Command

⚠️ Notice: If permission is removed from Group, it is recommended to remove this permission as well

/position share - "position.share"

📊 Metrics

This plugin uses bStats to collect anonymous usage data.
These statistics help the developer understand how the plugin is used (e.g., server version, player count) and improve future updates.

  • All data is collected anonymously.
  • You can disable metrics at any time by editing the /plugins/bStats/config.yml.

Thank you for helping to improve the plugin! ❤️