Locations

模组

· 作者 chrstffr

模组添加了一个多功能的 /location 命令,用于在世界中添加、编辑、引导和分享特定位置。

0 本站下载 0 关注 更新于 1 个月前

需要前置:Fabric API

最新 1.2.1 · 26.3 · Fabric

一键开服(送7天)

地点

找到了完美的建造位置,在脑海中或纸上记下了坐标,但当你再次需要时却怎么也找不到了?

你是否曾偶然发现令人惊叹的事物,并希望与朋友分享这些坐标,即使他们离线也能看到?

你是否刚刚死在荒无人烟的地方,无法找到回到自己物品所在地的路?

你正在收集并驯服所有狼的变种吗?现在你可以追踪那只你找不到最后一只了!

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(管理员):

  • /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 聊天和 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 许可证。

你可以在遵守相同许可证的前提下,通过署名用于非商业用途,修改并重新分发本作品。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源