地点

地点

找到了建造的完美地点，在脑中或纸面上记下了坐标，可等到再次需要时却怎么也找不到了？

你是否曾偶然发现某个绝妙的地方，希望能把坐标分享给朋友，哪怕他们不在线？

你是否曾死在荒郊野外，找不到回去取回物品的路？

你是否正在收集并驯服所有狼的变种？现在你可以追踪最后那只怎么也找不到的狼了！

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>	显示坐标、维度、生物群系、颜色、所有者、描述和其他详细信息。

list 和 show 的输出包含常见操作的可点击链接——引导、传送、分享、编辑、隐藏或取消隐藏、转换（用于自动捕获）以及移除。Tab 补全会在可能的情况下提示名称和筛选条件。

子命令	类型	默认值	描述
color <slug>	颜色 slug 或 random	继承（玩家 → 世界 locationColor）	此地点在列表、引导和公告中的颜色。random 在设置时解析一次。
symbol <slug>	符号 slug	继承（玩家 → 世界 symbol）	在 list 和 show 输出中显示的图标。
description <text>	文本	空	在 show 输出和标题公告中显示的备注。
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 也适用于公开和分享的地点。此处列出了按地点的公告和到达设置；冷却和全局开关请参见公告，可用的 slug 请参见颜色和符号。

配置

模组行为和显示默认值存储在 JSON 中，并通过 /location config 暴露。世界设置定义服务器范围的默认值以及允许使用哪些功能；玩家设置会覆盖这些默认值。在多人服务器上，数值型玩家值可以设为 -1 以继承世界默认值；颜色和符号未设置时继承。当多层设置同时适用时，运行时使用的值——有效值——按 地点 → 玩家 → 世界 的顺序解析（参见添加和编辑地点）。

当模组仅安装在客户端时，没有世界配置——所有设置都通过 /location config player 更改。

玩家设置（颜色、符号、距离、保留数量等）：

• /location config player list
• /location config player get <setting>
• /location config player set <setting> <value>

世界设置（仅限服务器管理员）：

• /location config world list
• /location config world get <setting>
• /location config world set <setting> <value>

重新加载（管理员）：

• /location config 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	聊天和界面正文文本。
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 池中排除的颜色 slug。无法通过配置命令使用。

在之前的版本中，此部分分为 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 blocks to the South-East and 3 blocks below
relative	使用朝向关键词显示方向；前方、后方、左侧和右侧	79 blocks straight ahead and 3 blocks below
simple	极简；只显示距离，不显示方向	79 blocks

追踪

追踪允许你使用引导按名称、变种和年龄找到最近的生物。 并非所有生物都有变种或年龄，允许的值会给出建议。

• /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

联系方式

• 文档：Modrinth
• 支持：Discord

许可证

Copyright © 2026 chrstffr

本项目采用 CC BY-NC-SA 4.0 许可。

你可以在署名、非商业用途、相同许可的条件下使用、修改和再分发本项目。