# 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 ``` ``` /position untrack ``` ![A player executes the /pos track 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 command and the boss bar with the position disappears again](https://i.imgur.com/Vqg0B9w.gif) ### WayPoint Command ``` /position waypoint save ``` ``` /position waypoint remove ``` ``` /position waypoint get ``` **Positions are saved in the "positions.json" file** ![The player executes the /pos waypoint save command. After executing the command, a message appears stating that the position has been successfully saved. When the /pos waypoint remove command is executed, the position is deleted again and another success message appears. The player also executes the /pos waypoint get command, whereupon the position is shared in the chat](https://i.imgur.com/0pFqJkr.gif) ### Position in Tab ![When the player moves, you can see that the current position is always displayed in the tab bar.](https://i.imgur.com/m8QMZRj.gif) ### 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 ``` To create a group, use this command! ``` /position group invite ``` 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 ``` The command is used to leave a group ``` /position group remove ``` The command is used to delete a group ``` /position group accept ``` This command is used to accept an invitation sent with the invite command ![The player executes the above commands](https://i.imgur.com/FZFuQJs.gif) ### 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 ``` ![The player executes the share command, sharing the position for all players in the group in the chat](https://i.imgur.com/S23UVgH.gif) ![A position in the chat](https://i.imgur.com/4OdIzr4.png) ## 🌐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](https://bstats.org/) 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! ❤️

PapaKekse

PapaKekse's Plugins

PlayerLocater by PapaKekse

PapaKekse's Organizations

Stars

Watching

PlayerLocater by