地点
找到了完美的建造位置,在脑海中或纸上记下了坐标,但当你再次需要时却怎么也找不到了?
你是否曾偶然发现令人惊叹的事物,并希望与朋友分享这些坐标,即使他们离线也能看到?
你是否刚刚死在荒无人烟的地方,无法找到回到自己物品所在地的路?
你正在收集并驯服所有狼的变种吗?现在你可以追踪那只你找不到最后一只了!
Locations 是一款多功能且高度可定制的模组,允许你在游戏中保存命名的地点——只有你能看到的私有地点,以及整个服务器都可以访问的公共地点。当你想要返回时,它们可以通过定位栏(Locator Bar)使用航点引导你。
本页面记录了 Locations 1.2.0 版本的文档。某些命令和行为在之前的版本中有所不同。
单人游戏
- 你的地点像服务器一样保存在世界中。
- 你可以使用所有功能。
多人游戏(仅安装在客户端)
- 你的地点存储在本地配置文件中。你可以拥有多个配置文件,并在切换服务器时进行切换。
- 生物追踪和生物群系搜索仅扫描已加载的区块。服务器的渲染距离限制了扫描区域,即使客户端的渲染距离更高也是如此。
多人游戏(仅安装在服务端)
- 适用于所有连接的玩家,即使他们的客户端没有安装该模组。
- 服务器管理员可以根据世界和玩家启用或禁用功能。
- 客户端功能如按键绑定不可用。
多人游戏(客户端和服务端都安装)
- 完整的功能集,包括共享和配置文件迁移。
- 当你加入一个模组化服务器时,你的本地配置文件可以上传到服务器。
帮助
在聊天中输入 /location help 以获取指向此页面和我们 Discord 服务器的链接。
添加和编辑地点
使用 /location 保存命名地点、在聊天中列出它们,并查看或编辑其详细信息。在多人游戏服务器上,你的地点是私有的,除非你选择将其设为公开。
| 命令 |
描述 |
/location add <name> |
将当前位置、维度及生物群系保存为一个名称。 |
/location list |
列出你保存的地点和自动捕获的地点。 |
/location list <filter> |
按维度(overworld、nether、end 或完整的维度 ID)、shared 或 hidden 进行筛选。 |
/location show <name> |
显示坐标、维度、生物群系、颜色、所有者、描述及其他详细信息。 |
列表和显示输出包含用于常见操作的 clickable links —— 引导、传送、分享、编辑、隐藏或取消隐藏、转换(用于自动捕获)以及删除。Tab 补全会在可能的情况下建议名称和筛选条件。
| 子命令 |
类型 |
默认值 |
描述 |
color <slug> |
颜色 slug 或 random |
inherit(玩家 → 世界 locationColor) |
在列表、指南和公告中显示此位置的颜色。设置为 random 时,仅在设置时解析一次。 |
symbol <slug> |
图标 slug |
inherit(玩家 → 世界 symbol) |
在列表和显示输出中显示的图标。 |
description <text> |
文本 |
空 |
在显示输出和标题公告中显示的备注。 |
arrivalDistance <n> |
整数(−1–128) |
−1(继承玩家 → 世界 arrivalDistance) |
从该位置起触发区域广播的方块距离。 |
announcement <mode> |
none、chat、actionbar 或 title |
none |
玩家进入区域时的通知方式。 |
public <value> |
true 或 false |
false |
在多人服务器上将拥有的位置设为对所有玩家可见。默认允许。 |
hidden <value> |
true 或 false |
未隐藏 |
在自己的列表中隐藏或显示公共/共享位置,不影响其他玩家。 |
rename [alias] |
文本(可选) |
无 |
为任何可访问的位置设置个人别名;省略别名以清除它并重新显示原始名称。 |
remove |
— |
— |
删除拥有的位置或自动捕获位置;会提示确认。 |
remove confirm |
— |
— |
跳过确认提示立即删除。 |
convert <newname> |
名称 |
— |
将死亡或重生捕获转换为新名称下的常规保存位置。 |
使用 /location edit <name> … 配合上述子命令。大多数子命令仅适用于你拥有的位置;rename 和 hidden 也适用于公共和共享位置。此处列出了各位置的广播和到达设置;有关冷却时间和全局开关,请参阅 Announcements;有关可用的 slugs,请参阅 Colors and Symbols。
Config
模组行为和显示默认值存储在 JSON 文件中,并通过 /location config 暴露。World 设置定义服务器范围的默认值和允许的功能;player 设置为你覆盖这些默认值。在多人服务器上,数值类型的玩家设置可以设为 -1 以继承世界默认值;颜色和符号在未设置时也会继承。运行时使用的值——即 effective 值——当存在多层级时,按 位置 → 玩家 → 世界 的顺序解析(参见 Add and edit locations)。
当模组仅安装在客户端时,不存在世界配置——所有设置均通过 /location config player 更改。
Player settings(颜色、图标、距离、保留时间等类似设置):
/location config player list
/location config player get <setting>
/location config player set <setting> <value>
World settings(仅限服务器管理员):
/location config world list
/location config world get <setting>
/location config world set <setting> <value>
Reload(管理员):
| 设置 |
作用域 |
默认值 |
描述 |
allowPublic |
世界 |
允许 |
允许玩家将地点设为公开。 |
allowGuiding |
世界 |
允许 |
允许玩家使用 /location guide。 |
allowTracking |
世界 |
允许 |
允许玩家使用 /location track。 |
allowBiomes |
世界 |
允许 |
允许玩家使用 /location biome。 |
allowAnnouncement |
世界 |
允许 |
允许玩家使用按地点设置的公告。 |
allowSharing |
世界 |
允许 |
允许玩家使用 /location share。 |
allowTeleport |
世界 |
不允许 |
允许玩家使用 /location teleport。 |
allowMigration |
世界 |
允许 |
允许玩家请求将配置档案迁移至服务器。 |
debug |
世界 |
false |
用于故障排除的额外日志记录。 |
maxWaypointsPerDimension |
世界 |
32 |
每个维度最多可设置的个人传送点数量。 |
deathRetention |
世界默认;玩家覆盖 |
3 |
保留最近多少次死亡捕获(设为 0 则禁用)。玩家设置:-1 继承世界默认值。 |
respawnRetention |
世界默认;玩家覆盖 |
3 |
保留最近多少次重生捕获(设为 0 则禁用)。玩家设置:-1 继承世界默认值。 |
arrivalDistance |
世界默认;玩家覆盖 |
8 |
默认触发公告的距离(方块数)。玩家设置:-1 继承世界默认值。 |
foundDistance |
世界默认;玩家覆盖 |
3 |
追踪“发现”反馈的距离(方块数)。玩家设置:-1 继承世界默认值。 |
biomeDistance |
世界默认;玩家覆盖 |
0 |
生物群系“发现”反馈的距离(方块数)。玩家设置:-1 继承世界默认值。 |
maxBiomeDistance |
世界默认;玩家覆盖 |
1024 |
定位生物群系的最大搜索半径(方块数)。玩家设置:-1 继承世界默认值。 |
announcementCooldown |
世界默认;玩家覆盖 |
30 |
同一公告再次触发的冷却时间(秒)。玩家设置:-1 继承世界默认值。 |
distanceMode |
世界默认;玩家覆盖 |
compass |
指南、追踪和生物群系功能的动作栏样式:compass(罗盘)、relative(相对)或 simple(简单)。 |
locationColor |
世界默认;玩家覆盖 |
gold |
新地点和指南的默认颜色。支持 random(随机)。 |
mobColor |
世界默认;玩家覆盖 |
red |
追踪传送点的默认颜色。支持 random(随机)。 |
biomeColor |
世界默认;玩家覆盖 |
green |
生物群系搜索传送点的默认颜色。支持 random(随机)。 |
waypointColor |
世界默认;玩家覆盖 |
white |
/location waypoint 命令的默认颜色。支持 random(随机)。 |
textColor |
世界默认;玩家覆盖 |
white |
聊天和 UI 正文文本颜色。 |
successColor |
世界默认;玩家覆盖 |
green |
成功消息和正向链接的颜色。 |
failureColor |
世界默认;玩家覆盖 |
red |
错误信息和破坏性操作的颜色。 |
accentColor |
世界默认;玩家覆盖 |
gray |
配置和列表输出中的次要标签颜色。 |
linkColor |
世界默认;玩家覆盖 |
aqua |
可点击的命令链接颜色。 |
headingColor |
世界默认;玩家覆盖 |
gold |
聊天输出中的章节标题颜色。 |
symbol |
世界默认;玩家覆盖 |
flag |
地点列表的默认符号。 |
deathSymbol |
世界默认;玩家覆盖 |
skull |
自动死亡捕获的符号。 |
respawnSymbol |
世界默认;玩家覆盖 |
heart |
自动重生捕获的符号。 |
autoDecline |
玩家 |
false |
自动拒绝传入的分享邀请。 |
guideOnDeath |
玩家 |
true |
玩家被击杀后,是否显示引导返回死亡地点的提示。 |
receiveAnnouncements |
玩家 |
true |
是否向你显示区域公告。 |
migrationPrompt |
玩家 |
true |
加入模组服务器时,是否提示迁移现有的客户端配置档案。 |
仅 JSON 设置(编辑 config.json 默认值;不在 /location config 中暴露):
| 设置项 |
范围 |
默认值 |
描述 |
trackFrequency |
世界 |
1 |
活跃生物追踪更新间隔。单位为秒,范围 1–10。 |
biomeFrequency |
世界 |
10 |
活跃生物群系搜索 UI/路标刷新间隔。单位为秒,范围 1–10。 |
biomeSearchCooldown |
世界 |
30 |
昂贵生物群系定位之间的最小间隔;搜索之间使用会话缓存。 |
omitRandomColors |
世界 |
["black"] |
从 random 池中排除的颜色标识符。无法通过配置命令使用。 |
在之前的版本中,这些设置被拆分为 admin 和 option。
自动保存
死亡点和重生点会自动保存并显示在你的 /location list 中。
/location config player|world set deathRetention <number> 允许你决定保留多少条历史记录。
/location config player|world set respawnRetention <number> 允许你决定保留多少条历史记录。
将任何保留数量设置为 0 会禁用自动捕获,但不会删除已存储的数据。
你也可以通过在列表中点击 [Show],然后点击 [Convert],将自动捕获转换为常规位置。
当你死亡时,系统会自动提示你通过路标引导返回该位置。
/location config player set guideOnDeath false 允许你关闭此功能。
颜色、描述和符号
每个位置都可以有文本描述、特定颜色以及用于引导和公告的符号。
颜色和符号仅接受建议的值。
/location edit <location> color <slug>
/location edit <location> symbol <slug>
/location edit <location> description <text>
公告
当玩家进入保存位置的附近时,可以自动收到通知。
位置的 announcement 默认为 none,但可以更改为 title、actionbar 或 chat。
所有模式都支持 color;title 还支持 description,而 actionbar 支持 symbol。
/location edit <location> announcement <mode>
| 模式 |
用法 |
描述 |
none |
– |
不显示公告。 |
title |
color, description |
大号居中文本 |
actionbar |
color, symbol |
HUD 上方的小文本 |
chat |
color, description, symbol |
聊天消息 |
/location edit <location> arrivalDistance <number> 设置触发公告的位置距离(以方块为单位)。
/location config world|player set announcementCooldown <number> 设置再次显示公告前的秒数。
/location config player set receiveAnnouncements false 禁用所有公告。
别名
你无法更改不属于你的位置,但可以隐藏或重命名它们。
/location edit <public or shared location name> rename <your alias>
/location edit <public or shared location name> rename(不带别名)恢复原始名称。
引导
引导使用动作栏、定位器和路标。动作栏显示你距离目的地的远近。
/location guide start <location>
/location guide stop
有三种不同的距离显示方式,你可以使用以下命令切换:
/location config player set distanceMode <mode>
| 模式 |
描述 |
示例 |
compass |
默认模式;显示你在基本方向和中间方向的朝向 |
东南方向 79 个方块,下方 3 个方块 |
relative |
使用朝向关键词显示方向;正前方、后方、左侧和右侧 |
正前方 79 个方块,下方 3 个方块 |
simple |
极简主义;仅显示距离而不显示方向 |
79 个方块 |
追踪
追踪允许你通过名称、变种和年龄找到最近的生物,并使用引导功能。
并非所有生物都有变种或年龄,且允许的值仅为建议值。
/location track start <mob> [variant] [adult|baby]
/location track stop
示例
/location track start wolf 引导你前往最近的狼。
/location track start wolf chestnut 引导你前往最近的栗色狼。
/location track start wolf chestnut baby 引导你前往最近的栗色狼幼崽。
注意
在普通多人服务器中,追踪会在追踪玩家的渲染距离范围内进行搜索。
单人游戏的行为略有不同,还包括超出此限制的任何已加载区块。
生物群系搜索
生物群系搜索找到最近匹配的生物群系,并通过路标引导你前往。
/location biome start <biome>
/location biome stop
在服务器(或单人游戏)中,搜索使用原版生物群系定位功能,范围为 maxBiomeDistance(默认 1024 个方块,最高 6400 个方块)。在仅限客户端的多人游戏中,搜索仅限于渲染距离内的已加载地形,并且无法匹配服务器端的 /locate biome 超出此范围的部分。
注意: 过大的服务端搜索半径可能会导致卡顿——其程度可与原版 /locate biome 命令相比。昂贵的定位操作受 biomeSearchCooldown 限流,搜索结果会在内存中缓存以供后续查询使用。
传送
/location teleport <location> — 传送至你可访问的位置
需要服务器启用 allowTeleport,并且玩家拥有 OP 权限或个人授权。
航点
快速定位栏标记独立于已保存的位置:
/location waypoint add — 标记你的脚下位置
/location waypoint add <x> <y> <z> [color] [dimension]
/location waypoint clear — 移除当前维度中的所有航点
/location waypoint clear <x> <y> <z> [dimension]
这些标记是持久化且私人的,无法共享。管理员可通过 maxWaypointsPerDimension 设定每个维度允许的玩家航点数量。为防止刷屏,间距小于 3 格的航点不允许创建。
管理
适用于操作员或具有管理权限的玩家。授权可覆盖单个玩家的默认世界设置。
/location admin grant <player> <perm> <true|false> — 权限包括:admin、guiding、public、sharing、teleport、tracking、biomes
/location admin list <player> — 查看授权和已保存的位置
/location admin remove <player> — 删除该玩家的所有数据(使用 remove <player> confirm 进行确认)
/location admin cleanup orphan <player> — 移除不再处于白名单服务器上的玩家数据
/location admin cleanup ignore <player> — 停止针对该名称的孤立数据通知
共享
向其他玩家分享私有位置需要服务器上安装了模组。
发送邀请:
/location share send <location> <player>
/location share send <location> <player> <message>
共享流程由提示框处理,但你也可以通过命令与之交互。
管理邀请:
/location share list — 查看待处理和已接受的共享;使用聊天链接接受或拒绝
/location share accept|decline <owner> <location> — 响应邀请(也可从列表链接中操作)
/location share cancel <location> <player> — 撤销已发送的邀请
移除访问权限:
- 使用列表链接取消你发送的待处理邀请,或从你的侧移除共享
共享功能可全局禁用;管理员仍可将其授予特定玩家。
如果客户端和服务端模组版本不匹配,共享将被阻止,直到双方均更新。
/location config player set autoDecline true 使你退出未来的共享请求。
配置文件
仅客户端(多人游戏时客户端安装模组,服务端未安装)。
配置文件为每个服务器或世界保持独立的地理位置集合。
/location profile list — 查看你的配置文件及当前激活的配置文件
/location profile add <profile>
/location profile rename <oldName> <newName>
/location profile switch <profile>
/location profile remove <profile> — 会要求确认;使用 remove <profile> confirm 删除
配置文件名称仅限小写字母、数字、.、_ 和 -(最长 64 个字符)。
当你首次加入一个没有对应配置文件的服务器时,模组可能会提示你创建一个。
如果你在多个服务器上游玩,其中部分服务器安装了模组而其他没有,你可以将 migrationPrompt 设置为 false 以跳过迁移提示:
/location config player set migrationPrompt false
迁移
将本地配置文件迁移到安装了模组的服务器,使你的位置数据变为服务端保存。
玩家(客户端,当提供迁移选项时):
/location migrate <profile> — 请求迁移;需管理员批准
/location migrate <profile> cancel — 取消你的待处理请求
/location migrate <profile> <token> — 在管理员批准后上传(令牌显示给管理员)
管理员(服务端):
/location admin migration list
/location admin migration accept <player>
/location admin migration decline <player>
/location admin migration delete <player>
迁移需要客户端和服务端均安装模组,版本匹配,且启用 allowMigration(或拥有个人授权)。成功上传后,客户端会保留该配置文件已迁移的提示。
按键绑定
如果你已在客户端安装模组,则有以下四个按键绑定可用。
它们默认未配置。
- 添加当前位置 – 将当前坐标作为无标题位置添加
- 列出位置 – 等同于
/location list
- 添加航点 – 等同于
/location waypoint add
- 移除最近航点 – 移除最近的航点
数据文件
单人游戏世界:
- 世界配置:
saves/<world>/data/dev.chrstffr.locations/config.json
- 玩家数据:
saves/<world>/data/dev.chrstffr.locations/players/<uuid>.json
- 共享记录:
saves/<world>/data/dev.chrstffr.locations/shares.json
服务器世界:
- 世界配置:
config/dev.chrstffr.locations/config.json
- 玩家数据、共享记录和迁移记录:
<world>/data/dev.chrstffr.locations/
客户端(多人游戏,仅在客户端安装模组):
- 客户端配置:
config/dev.chrstffr.locations/config.json
- 配置文件数据:
config/dev.chrstffr.locations/profiles/<profile>.json
联系方式
许可证
Copyright © 2026 chrstffr
本项目遵循 CC BY-NC-SA 4.0 许可证。
你可以在遵守相同许可证的前提下,通过署名用于非商业用途,修改并重新分发本作品。
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.
This page documents Locations 1.2.0. Some commands and behaviors differ in previous versions.
Singleplayer
- Your locations are saved in the world like on a server.
- You have access to every feature.
Multiplayer (only installed on client)
- Your locations are stored in profiles locally. You can have multiple and switch when you change servers.
- Mob tracking and biome search only scan loaded chunks. The server’s render distance caps scanned area, even when the client render distance is higher.
Multiplayer (only installed on server)
- Works for all connected players, even without the mod on their client.
- Server admins can allow or disallow features per world and per player.
- Client features like key binds are not available.
Multiplayer (both on client and server)
- Full feature set, including sharing and profile migration.
- When you join a modded server, your local profile can be uploaded to the server.
Help
Run /location help in chat for a link to this page and our Discord.
Add and edit locations
Use /location to save named places, list them in chat, and view or edit their details. On a multiplayer server your locations are private, unless you choose to make them public.
| Command |
Description |
/location add <name> |
Save your current position, dimension, and biome under a name. |
/location list |
List your saved locations and automatic captures. |
/location list <filter> |
Filter by dimension (overworld, nether, end, or a full dimension id), shared, or hidden. |
/location show <name> |
Show coordinates, dimension, biome, colors, owner, description, and other details. |
List and show output includes clickable links for common actions—guide, teleport, share, edit, hide or unhide, convert (for automatic captures), and remove. Tab completion suggests names and filters where possible.
| Subcommand |
Type |
Default |
Description |
color <slug> |
color slug or random |
inherit (player → world locationColor) |
Color for this location in lists, guide, and announcements. random resolves once when set. |
symbol <slug> |
symbol slug |
inherit (player → world symbol) |
Icon shown in list and show output. |
description <text> |
text |
empty |
Notes shown in show output and title announcement. |
arrivalDistance <n> |
integer (−1–128) |
−1 (inherit player → world arrivalDistance) |
Distance in blocks from the location that triggers area announcements. |
announcement <mode> |
none, chat, actionbar, or title |
none |
How players are notified when entering the area. |
public <value> |
true or false |
false |
Make an owned location visible to everyone on a multiplayer server. Allowed by default. |
hidden <value> |
true or false |
not hidden |
Hide or show a public or shared location in your own lists without affecting others. |
rename [alias] |
text (optional) |
none |
Set a personal alias for any location you can access; omit the alias to clear it and show the original name again. |
remove |
— |
— |
Delete an owned location or automatic capture; prompts for confirmation. |
remove confirm |
— |
— |
Delete immediately without the confirmation prompt. |
convert <newname> |
name |
— |
Turn a death or respawn capture into a regular saved location under a new name. |
Use /location edit <name> … with the subcommands above. Most subcommands apply only to locations you own; rename and hidden also work on public and shared locations. Per-location announcement and arrival settings are listed here; see Announcements for cooldowns and global toggles, and Colors and Symbols for available slugs.
Config
Mod behavior and display defaults are stored in JSON and exposed through /location config. World settings define server-wide defaults and which features are permitted; player settings override those defaults for you. On a multiplayer server, numeric player values can be set to -1 to inherit the world default; colors and symbols inherit when unset. The value used at runtime—the effective value—resolves location → player → world when several layers apply (see Add and edit locations).
When the mod is installed on the client only, there is no world config—all settings are changed through /location config player.
Player settings (colors, symbols, distances, retention, and similar):
/location config player list
/location config player get <setting>
/location config player set <setting> <value>
World settings (server admins only):
/location config world list
/location config world get <setting>
/location config world set <setting> <value>
Reload (admins):
| Setting |
Scope |
Default |
Description |
allowPublic |
World |
allowed |
Let players make locations public. |
allowGuiding |
World |
allowed |
Let players use /location guide. |
allowTracking |
World |
allowed |
Let players use /location track. |
allowBiomes |
World |
allowed |
Let players use /location biome. |
allowAnnouncement |
World |
allowed |
Let players use per-location announcements. |
allowSharing |
World |
allowed |
Let players use /location share. |
allowTeleport |
World |
not allowed |
Let players use /location teleport. |
allowMigration |
World |
allowed |
Let players request profile migration to the server. |
debug |
World |
false |
Extra logging for troubleshooting. |
maxWaypointsPerDimension |
World |
32 |
Maximum personal waypoints per dimension. |
deathRetention |
World default; player override |
3 |
How many recent death captures to keep (0 disables). Player: -1 inherits. |
respawnRetention |
World default; player override |
3 |
How many recent respawn captures to keep (0 disables). Player: -1 inherits. |
arrivalDistance |
World default; player override |
8 |
Default announcement trigger distance (blocks). Player: -1 inherits. |
foundDistance |
World default; player override |
3 |
Distance (blocks) for track “found” feedback. Player: -1 inherits. |
biomeDistance |
World default; player override |
0 |
Distance (blocks) for biome “found” feedback. Player: -1 inherits. |
maxBiomeDistance |
World default; player override |
1024 |
Maximum search radius (blocks) for biome locate. Player: -1 inherits. |
announcementCooldown |
World default; player override |
30 |
Seconds before the same announcement can fire again. Player: -1 inherits. |
distanceMode |
World default; player override |
compass |
Actionbar style for guide, track, and biome: compass, relative, or simple. |
locationColor |
World default; player override |
gold |
Default color for new locations and guide. Accepts random. |
mobColor |
World default; player override |
red |
Default track waypoint color. Accepts random. |
biomeColor |
World default; player override |
green |
Default biome search waypoint color. Accepts random. |
waypointColor |
World default; player override |
white |
Default /location waypoint color. Accepts random. |
textColor |
World default; player override |
white |
Chat and UI body text. |
successColor |
World default; player override |
green |
Success messages and positive links. |
failureColor |
World default; player override |
red |
Errors and destructive actions. |
accentColor |
World default; player override |
gray |
Secondary labels in config and list output. |
linkColor |
World default; player override |
aqua |
Clickable command links. |
headingColor |
World default; player override |
gold |
Section headings in chat output. |
symbol |
World default; player override |
flag |
Default location list symbol. |
deathSymbol |
World default; player override |
skull |
Symbol for automatic death captures. |
respawnSymbol |
World default; player override |
heart |
Symbol for automatic respawn captures. |
autoDecline |
Player |
false |
Automatically decline incoming share invites. |
guideOnDeath |
Player |
true |
After player is killed, show a prompt to guide back to place of death. |
receiveAnnouncements |
Player |
true |
Whether area announcements are shown to you. |
migrationPrompt |
Player |
true |
Prompt to migrate an existing client profile when joining a modded server. |
JSON-only settings (edit config.json defaults; not exposed on /location config):
| Setting |
Scope |
Default |
Description |
trackFrequency |
World |
1 |
Active mob track update interval. In seconds, range 1–10. |
biomeFrequency |
World |
10 |
Active biome search UI/waypoint refresh interval. In seconds, range 1–10. |
biomeSearchCooldown |
World |
30 |
Minimum gap between expensive biome locates; session cache used between searches. |
omitRandomColors |
World |
["black"] |
Color slugs excluded from the random pool. Not available via config commands. |
In previous versions this was split into admin and option.
Automatic
Deaths and Spawnpoints are automatically saved and appear in your /location list.
/location config player|world set deathRetention <number> allows you to decide how many are kept in history.
/location config player|world set respawnRetention <number> allows you to decide how many are kept in history.
Setting any retention to 0 disables automatic capture, but will not delete already stored data.
You can also convert automatic captures to regular locations by clicking [Show] in the list, then clicking [Convert].
When you perish, you are automatically prompted to be guided back to the location via waypoint.
/location config player set guideOnDeath false allows you to turn off this feature.
Color, description, and symbol
Every location can have a text description, a specific color, and a symbol used in guiding and announcements.
Color and symbol only accept suggested values.
/location edit <location> color <slug>
/location edit <location> symbol <slug>
/location edit <location> description <text>
Announcements
Players can automatically be notified when entering the proximity of a saved location.
Locations have announcement set to none, but can be changed to title, actionbar, or chat.
All modes support color; title also supports description, and actionbar supports symbol.
/location edit <location> announcement <mode>
/location edit <location> arrivalDistance <number> sets the distance (in blocks) from the location where the announcement is triggered.
/location config world|player set announcementCooldown <number> sets the number of seconds before the announcement is shown again.
/location config player set receiveAnnouncements false disables all announcements.
Aliases
Locations that you do not own cannot be changed, but they can be hidden or renamed.
/location edit <public or shared location name> rename <your alias>
/location edit <public or shared location name> rename without an alias, returns the original name.
Guiding
Guiding uses the actionbar and locator bar with a waypoint. The actionbar shows how far you are from your destination.
/location guide start <location>
/location guide stop
There are three different ways of showing distance, you can switch between them using:
/location config player set distanceMode <mode>
| Mode |
Description |
Example |
compass |
Default mode; shows you the orientation in cardinal and ordinal directions |
79 blocks to the South-East and 3 blocks below |
relative |
Shows direction with facing keywords; straight ahead, behind, left and right |
79 blocks straight ahead and 3 blocks below |
simple |
Minimalistic; shows distance without direction |
79 blocks |
Tracking
Tracking allows you to find the closest mob by name, variant and age, using Guiding.
Not all mobs have variants nor age, and allowed values are suggested.
/location track start <mob> [variant] [adult|baby]
/location track stop
Example
/location track start wolf guides you to the closest wolf.
/location track start wolf chestnut guides you to the closest chestnut wolf.
/location track start wolf chestnut baby guides you to the closest chestnut wolf puppy.
Note
On a regular multiplayer server, tracking searches within the tracking player’s render distance.
Singleplayer behaves slightly differently and also includes any loaded chunk beyond that cap.
Biome Searching
Biome searching finds the closest matching biome and guides you with a waypoint.
/location biome start <biome>
/location biome stop
On a server (or in singleplayer), search uses vanilla biome locate within maxBiomeDistance (default 1024 blocks, up to 6400). On client-only multiplayer, search is limited to loaded terrain within render distance and cannot match server-side /locate biome beyond that.
Note: A very large server-side search radius may cause lag spikes — comparable to vanilla /locate biome. Expensive locates are rate-limited by biomeSearchCooldown; recent results are cached in memory between searches.
Teleport
/location teleport <location> — teleport to a location you can access
Requires allowTeleport on the server and either op status or a personal grant.
Waypoints
Quick locator bar markers separate from saved locations:
/location waypoint add — mark your feet
/location waypoint add <x> <y> <z> [color] [dimension]
/location waypoint clear — remove all in this dimension
/location waypoint clear <x> <y> <z> [dimension]
These markers are persistent, personal, and cannot be shared. Admins can determine how many waypoints a player can have per dimension using maxWaypointsPerDimension. Waypoints closer than 3 blocks apart are not allowed, to prevent spamming.
Admin
For operators or players with admin access. Grants override world defaults for individual players.
/location admin grant <player> <perm> <true|false> — perms: admin, guiding, public, sharing, teleport, tracking, biomes
/location admin list <player> — grants and saved locations
/location admin remove <player> — delete all player data (use remove <player> confirm to confirm)
/location admin cleanup orphan <player> — remove data for a player no longer on a whitelisted server
/location admin cleanup ignore <player> — stop orphan notifications for that name
Sharing
Sharing a private location with another player requires the mod on the server.
Send an invite:
/location share send <location> <player>
/location share send <location> <player> <message>
Share workflow is handled by prompts, but you can interact with them through commands as well.
Manage invites:
/location share list — pending and accepted shares; use the chat links to accept or decline
/location share accept|decline <owner> <location> — respond to an invite (also available from list links)
/location share cancel <location> <player> — revokes a sent invite
Remove access:
- Use list links to cancel a pending invite you sent, or remove a share from your side
Sharing can be disabled worldwide; admins can still grant it to individual players.
If client and server mod versions do not match, sharing is blocked until both are updated.
/location config player set autoDecline true opts you out of future sharing requests.
Profiles
Client-only (multiplayer with mod on client, not on server).
Profiles keep separate location sets per server or world.
/location profile list — your profiles and which one is active
/location profile add <profile>
/location profile rename <oldName> <newName>
/location profile switch <profile>
/location profile remove <profile> — asks for confirmation; use remove <profile> confirm to delete
Profile names use lowercase letters, digits, ., _, and - (max 64 characters).
When you first join a server without a profile for it, the mod may prompt you to create one.
If you play on multiple servers and one or more have the mod installed and the others do not, you can opt out of the migration prompt by setting migrationPrompt to false:
/location config player set migrationPrompt false
Migration
Move a local profile onto a modded server so your locations become server-side saves.
Player (client, when migration is offered):
/location migrate <profile> — request migration; an admin must accept
/location migrate <profile> cancel — cancel your pending request
/location migrate <profile> <token> — upload after an admin accepts (token shown to the admin)
Admin (server):
/location admin migration list
/location admin migration accept <player>
/location admin migration decline <player>
/location admin migration delete <player>
Migration requires the mod on both client and server, matching versions, and allowMigration enabled (or a personal grant). After a successful upload, the client keeps a hint that the profile was migrated.
Key Binds
There are four key binds available if you have the mod installed on your client.
They are not configured by default.
- Add current location – adds current coordinates as an untitled location
- List locations – same as
/location list
- Add waypoint – same as
/location waypoint add
- Remove closest waypoint – remove the closest waypoint
Data files
Singleplayer world:
- World config:
saves/<world>/data/dev.chrstffr.locations/config.json
- Player data:
saves/<world>/data/dev.chrstffr.locations/players/<uuid>.json
- Shares:
saves/<world>/data/dev.chrstffr.locations/shares.json
Server world:
- World config:
config/dev.chrstffr.locations/config.json
- Player data, shares, and migrations:
<world>/data/dev.chrstffr.locations/
Client (multiplayer, mod on client only):
- Client config:
config/dev.chrstffr.locations/config.json
- Profile data:
config/dev.chrstffr.locations/profiles/<profile>.json
Contact
- Documentation: Modrinth
- Support: Discord
License
Copyright © 2026 chrstffr
This project is licensed under CC BY-NC-SA 4.0.
You may use, modify, and redistribute it with attribution, for non-commercial use, under the same license.
评论 0
登录后参与评分
还没有评论,来抢沙发吧