# Locator Bar Configuration
\nA small paper plugin that allows players to change their locator bar settings without needing to use commands.
\nInspired by RedSyven’s Datapack Locator Bar Options.<\/p>\n
You can access the menu from the pause screen (either through `Locator Bar Configuration` or `Custom Options` and then `Locator Bar Configuration`)<\/p>\n
<\/p>\n
## Features
\nSupported Minecraft Versions: `1.21.8 – 26.1.1`<\/p>\n
Each player can
\n– toggle their locator bar on and off
\n– customize their transmit and receive range
\n– customize the colour their waypoint appears to others.<\/p>\n
Administrators can
\n– configure which range values and colors players can choose
\n– disable player customization of range or color entirely (or both but what’s the point of this plugin then)
\n– seamlessly migrate data from RedSyven’s Datapack<\/p>\n
## Configuration
\nThe default configuration is automatically created inside the `LocatorBarConfiguration` directory inside your plugin directory (so usually inside `plugins\/LocatorBarConfiguration`).
\nYou can add or remove options for transmit range, receive range and the icon color.<\/p>\n
If the receiveRanges option is not set, players will have the same options as for transmitting.
\nIf you set an option to an empty list (`iconColors: []`) the option will be locked for players.<\/p>\n
> You can reload the config using `\/lbc reload`. This requires the `lbc.reload` permission.<\/p>\n
## Migration from Locator Bar Options
\nTo migrate from Locator Bar Options, simply install the plugin and disable the LocatorBarOptions datapack.
\nUser data will automatically be migrated once they (re-)join. They will be notified about this migration so they can ensure the migration worked correctly.<\/p>\n
**More notes about migration can be found in the wiki.**<\/p>\n
## Folia
\n**Folia doesn’t support waypoints yet**. Folia forks that implement waypoint support will likely work already, though. CanvasMC is one such fork and officially supported.<\/p>\n
## Why?
\nWhile RedSyven’s datapack worked fine for our purposes, some players ran into undiagnosable issues with their options not being updated.
\nSince the server I used the datapack on might switch to Folia soon and datapacks aren’t enabled in Folia, I wanted to see
\nwhat Paper’s **experimental** support for the Dialog API can do.<\/p>\n
It now offers some features datapacks cannot offer, like configuring available options for player.<\/p>\n","protected":false},"excerpt":{"rendered":"
Let players configure their locator bar in a menu. Per-user enable\/disable toggle, colour configuration and range configuration from the pause menu.<\/p>\n","protected":false},"featured_media":95032,"template":"","meta":{"_minecraft_slug":"locatorbarconfiguration","_minecraft_project_id":"qiVpXSW0","_minecraft_author":"nikkischnelle","_minecraft_license":"LGPL-3.0-or-later","_minecraft_downloads":465,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"locatorbarconfiguration.zip","_minecraft_size_bytes":42658867,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-16T10:48:10.844579Z","_minecraft_date_created":"2025-10-22T03:47:12.654840Z","_minecraft_date_modified":"2026-05-06T07:58:59.485313Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/locatorbarconfiguration","_minecraft_icon_attachment_id":95032,"_minecraft_imported_at":"2026-06-05T10:36:27+00:00","_minecraft_import_hash":"a64c2336eb3b39849cfe17ee168b8811","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,126,127,128,867,92],"mod_loader":[131,132,133],"minecraft_version":[40,41,81,82,83,167,163],"class_list":["post-95031","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n