Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Tags
Creators
Details
Locations
Found the perfect spot to build, made a mental or physical note of the coordinates, and still somehow lost them when you need them again?
Have you ever stumbled onto something incredible and wished you could share the coordinates with your friends, even if they are offline?
Did you just die in the middle of nowhere and cannot find your way back to your stuff?
Are you collecting and taming all wolf variants? Now you can track that last one you can't find!
Locations is a versatile and highly customizable mod that lets you save named locations in-game — private ones only you can see, and public ones the whole server can access. When you want to head back, they can guide you with a waypoint using the Locator Bar. It lets you search and track a specific mob or mob variant.
There are several ways of using this mod:
Singleplayer
- Some restrictions apply; like sharing, and public locations.
Multiplayer (installed only on client)
- Some restrictions apply; like sharing, public locations, and Locator Bar waypoints (but guiding/tracking still works).
- Your locations are stored in profiles locally. You can have multiple and switch when you switch servers.
Multiplayer (installed only on server)
- Works for all connected players.
- Have admin config to allow/disallow certain features.
Multiplayer (both on client and server)
- Supports migrating local profiles to server.
Requirements
- Minecraft 26.1.2
- Fabric Loader 0.19.2+
- Fabric API 0.146.1+26.1.2+
Command Overview
All commands support tab-completion where applicable.
Base command tree:
-
/location add <name>
-
/location list
-
/location show <name>
-
/location teleport <name>
-
/location guide start <name>
-
/location guide stop
-
/location track start <entity> [variant]
-
/location track stop
-
/location edit <name> ...
-
/location option ...
-
/location share ...
-
/location profile ...
-
/location help [topic]
-
/location admin ...
Location Commands
Add and list
-
/location add <name>
- Saves your current position.
-
/location list
- Shows your locations, visible public locations, visible shared locations, and enabled dynamic entries.
-
/location list overworld
-
/location list nether
-
/location list end
- Filter list by dimension.
-
/location list hidden
- Shows hidden public or shared locations.
- This subcommand appears only when you have hidden entries.
Show and teleport
-
/location show <name>
- Shows full details including coordinates, dimension, biome, color, symbol, distance, description, and owner when applicable.
-
/location teleport <name>
- Teleports to an accessible location.
- Only when allowTeleport is enabled.
Edit owned locations
- /location edit <name> color <color>
- /location edit <name> symbol <symbol>
- /location edit <name> description <text>
- /location edit <name> arrival <distance>
- /location edit <name> public <true|false>
- /location edit <name> rename <newname>
- /location edit <name> remove
Guide Commands
-
/location guide start <name>
- Starts a live waypoint guide in your current dimension.
- Requires allowGuiding.
-
/location guide stop
- Stops active guidance.
Tracking Commands
-
/location track start <entity> [variant]
- Searches for the nearest entity of the given type within the tracking radius.
- Displays live distance to the entity on the action bar.
- Entity names use Minecraft's registry format, e.g.
cow,zombie,minecraft:horse. - Variant is optional; supported for horses (
black,brown,chestnut,creamy,darkbrown,gray,white), wolves, cats, and similar typed mobs. - Requires allowTracking.
- Starting tracking stops any active guide.
-
/location track stop
- Stops active tracking and clears the action bar.
- Starting a guide also stops tracking.
Option Commands
-
/location option
- Lists your current option values.
-
/location option get <prop>
-
/location option set <prop> <value>
Supported option keys:
- locationColor
- textColor
- successColor
- failureColor
- accentColor
- linkColor
- headingColor
- symbol
- deathSymbol
- respawnSymbol
- arrivalDistance
- foundDistance
- distanceMode
- deathRetention
- respawnRetention
- autoDecline
- mobColor
- biomeColor
- guideOnDeath
Share Commands
-
/location share <name> <player>
-
/location share <name> <player> <message>
- Sends a share invite with optional message.
-
/location share accept <ownerName> <locationName>
-
/location share decline <ownerName> <locationName>
-
/location share remove <name>
- Removes an accepted shared location from your shared list.
-
/location share revoke <name> <player>
- Revokes a pending invite you sent.
Profile Commands
Profiles are client-side location sets stored locally. They are used when playing on a server without Locations installed. On a modded server, all /location commands go to the server directly.
-
/location profile status
- Shows the current mode and active local profile name.
-
/location profile create <profileName>
- Creates a new local profile. Names may contain lowercase letters, digits,
.,_, and-.
- Creates a new local profile. Names may contain lowercase letters, digits,
-
/location profile switch <profileName>
- Switches to a different local profile.
-
/location profile delete <profileName>
- Deletes a local profile and its saved locations.
-
/location-migration request <profileName>
- Sends a migration request to a server admin.
- Only available if both client and server has the mod installed. Useful when you have accumulated locations before server install the mod.
Help Commands
- /location help
- /location help admin
- /location help biome
- /location help edit
- /location help guide
- /location help profile (client-only)
- /location help share
- /location help track
Admin Commands
Admin access requires operator permission or allowAdmin for the player.
-
/location admin
- Lists full server config.
-
/location admin get <property>
-
/location admin set <flag> <true|false>
- Flags:
- allowPublic
- allowGuiding
- allowTracking
- allowSharing
- allowTeleport
- allowAnnouncement
- allowMigration
- debug
- Flags:
-
/location admin set arrivalDistance <distance>
-
/location admin set foundDistance <distance>
-
/location admin set searchRadius <radius>
-
/location admin set defaultLocationColor <color>
-
/location admin set defaultTextColor <color>
-
/location admin set defaultSuccessColor <color>
-
/location admin set defaultFailureColor <color>
-
/location admin set defaultAccentColor <color>
-
/location admin set defaultLinkColor <color>
-
/location admin set defaultHeadingColor <color>
-
/location admin set defaultSymbol <symbol>
-
/location admin set defaultDeathSymbol <symbol>
-
/location admin set defaultRespawnSymbol <symbol>
-
/location admin set distanceMode <compass|relative|simple>
-
/location admin grant <name> <perm> [value]
- Perms:
- admin
- guiding
- public
- sharing
- teleport
- Perms:
-
/location admin remove <name>
-
/location admin cleanup <player>
-
/location admin cleanup ignore
Data Files
Server
-
Server config:
- <world>/data/dev.chrstffr.locations/config.json
-
Share queue:
- <world>/data/dev.chrstffr.locations/shares.json
-
Player data:
- <world>/data/dev.chrstffr.locations/players/<UUID>.json
Player data includes locations, shared entries, hidden entries, death snapshot, and personal defaults.
Client
Stored in the Minecraft config folder when the mod is installed on the client:
-
Client config (active profile + last death):
- config/locations/config.json
-
Profile location data:
- config/locations/profiles/<name>.json
License
CC BY-NC-SA 4.0
Copyright 2026 chrstffr
You may use, modify, and redistribute this project with attribution, non-commercial use, and share-alike terms.


