GPS Systems

插件

· 作者 MrDino

为 Minecraft 服务器添加可视化 GPS 导航功能。

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

最新 1.2X-0.2 · 26.1.2 · Bukkit / Spigot

一键开服(送7天)

GPS 系统

GPS Systems 是一款适用于 Spigot/Paper 的服务端插件,为 Minecraft 服务器增添了可视化的 GPS 导航功能。 MAIN BANNER 它允许玩家打开 GPS 地图、选择目的地、跟随活动路线、保存私人位置,并通过粒子效果、地图渲染、Boss 栏和操作栏指令接收逐句导航指引。

该插件专为城市、角色扮演、生存及网络类服务器设计,适用于需要引导式导航的道路、街区、公共服务设施和地标场景。 NAVIGATION

插件目前处于测试阶段,可能会出现错误!!!

完整指南请访问:

要求

  • Minecraft 服务器:兼容 API 1.20 的 Spigot/Paper
  • Java:17
  • 权限插件:可选,但建议用于管理/玩家访问控制

主要功能

  • 带有启动/加载屏幕的游戏内 GPS 地图。
  • 由管理员配置的公共目的地。
  • 从 GPS 地图保存的私人玩家目的地。
  • 使用交叉点和连接进行路网路由。
  • 支持单行道、封锁路段和加权道路规则。
  • 当玩家偏离路线或切换车道时动态重新计算路线。
  • 目的地分类,包含颜色、符号和地图图标样式。
  • 管理员工具,用于构建、链接、移除和检查路线网络。
  • 管理员传送命令,可直接传送到指定目的地。
  • 自动向新玩家提供 GPS 地图(可配置)。
  • 多语言资源文件:en_US、es_ES、fr_FR、de_DE。

工作原理

GPS Systems 使用三个主要数据层:

  1. 目的地

玩家可以导航到的公共和私人地点。公共目的地存储在 destinations.yml 中的 destinations 下。私人目的地存储在 player-destinations.<uuid> 下。

  1. 路线网络 BOTH WAYS MARKER GPS 使用的道路图。它以路线点/交叉点和连接的形式存储在 network.yml 中。GPS 会在此图上计算路线,而不是画出穿过建筑物的不可能直线。

  2. 地图渲染

填充地图物品用于渲染目的地菜单、路线线、已完成的灰色部分、当前蓝色路线部分、目的地标记和本地虚线最终段。

基本玩家流程

GPS LOAD

  1. 玩家获得或获取一张 GPS 地图。
  2. 玩家右键点击地图以启动 GPS。
  3. 玩家打开地图菜单并选择“目的地”。
  4. 玩家选择一个目的地。
  5. GPS 开始导航,显示路线粒子、地图路线预览、Boss 栏/操作栏信息和目的地标记。
  6. 随着玩家移动,路线会更新。 GPS MENU SELECTOR ON JOIN

管理员设置流程

  1. 使用 /gps admin 打开管理员面板。
  2. 获取 GPS 工具。
  3. 使用 GPS Intersection Tool 创建交叉点。 INTERSECTION TOOL
  4. 链接交叉点以创建道路。 ONE WAY MAKING ONE WAY MARKERS BOTH WAYS MAKING
  5. 使用 GPS Destination Tool 或 /gps set 创建目的地。 DESTINATION TOOL
  6. 使用 /gps start <destination> 或 GPS 地图测试路线。

工具

TOOLS BANNER 所有工具的显示名称均遵循格式 GPS <Name> Tool。

  • GPS Destination Tool:标记和创建公共目的地。 DESTINATION TOOL
  • GPS Network Tool:可视化网络/编辑器覆盖工具。 NETWORK TOOL
  • GPS Intersection Tool:创建和链接交叉点。 INTERSECTION TOOL
  • GPS Remover Tool:移除链接或交叉点。 UNLINK TOOL
  • GPS Undo Tool:撤销最近的路线网络更改。 UNDO TOOL
  • GPS Toolset Tool:管理员菜单项,提供全套工具。 ALL TOOLSET TOOL

命令

指令 权限 描述
/gps gpssystems.use 打开 GPS 菜单。
/gps menu gpssystems.use 打开 GPS 菜单。
/gps start <目的地> gpssystems.use 开始导航至指定目的地。
/gps stop gpssystems.use 停止当前导航。
/gps list gpssystems.use 列出可用的目的地。
/gps admin gpssystems.admin 打开管理员菜单。
/gps reload gpssystems.admin 重新加载配置、语言文件、目的地和网络数据。
/gps set <id> <display name> gpssystems.admin 在你当前位置创建一个目的地。

| /gps point <id> <显示名称> | gpssystems.admin | 在当前所在位置创建一条路线点/交叉点。 | | /gps connect <点A> <点B> | gpssystems.admin | 连接两个路线点。 | | /gps link <目的地> <点> | gpssystems.admin | 将公共目的地链接到路线点。 | | /gps builder | gpssystems.admin | 切换路线构建器模式。 |

/gps editor gpssystems.admin 切换网络编辑器覆盖层。
/gps tool gpssystems.admin 提供管理员 GPS 工具。
/gps map gpssystems.admin 提供 GPS 地图。
/gps tp <目的地> gpssystems.admin 传送至指定目的地。
/gpstp <目的地> gpssystems.admin 传送至指定目的地。
/tp <目的地> gpssystems.admin 如果可用,作为管理员快捷传送的别名。

权限

权限 默认值 描述
gpssystems.use true 允许玩家使用 GPS 菜单和导航功能。
gpssystems.admin op 允许使用管理工具、编辑、重载及传送命令。

配置文件

config.yml

控制全局行为:

  • 语言选择。
  • GPS 地图缩放与示意图模式。
  • 首次加入服务器时自动显示 GPS 地图。
  • 路径跟随走廊。
  • 车道匹配。
  • 反向行驶匹配。
  • 动态重新计算。
  • 目的地本地/直接虚线段。
  • Boss 栏、动作栏与粒子效果。
  • 音频与视觉表现。

重要设置:

settings:
  give-gps-map-on-first-join: true

此设置会自动为新手玩家发放一张 GPS 地图。

destinations.yml

存储公共服务器目的地、私人玩家目的地以及分类样式。

公共目的地示例:

destinations:
  spawn:
    enabled: true
    display-name: "Spawn"
    description: "Main server spawn."
    world: "world"
    x: 0.5
    y: 64.0
    z: 0.5
    yaw: 0.0
    pitch: 0.0
    icon: "COMPASS"
    permission: ""
    category: "Spawn"

分类样式用于定义目的地在 GPS 地图上的外观:

category-styles:
  enabled: true
  color-labels: true
  rules:
    police:
      color: "#3B82F6"
      symbol: "P"
      categories:
        - "Police"
      pattern:
        - ".###."
        - "#####"
        - "##.##"
        - ".###."
        - "..#.."

network.yml

存储路线网络:

  • points: 交叉点/节点。
  • streets: 命名街道组。
  • edge-streets: 边到街道的映射。
  • edge-rules: 单行道、封闭道路或加权道路规则。
  • destination-points: 公共目的地到网络节点的链接。

大多数服务器应使用游戏内工具编辑此文件,而非手动修改。

在游戏中编辑目的地图标

CATEGORIES BANNER

管理员可以从“Public Destinations”菜单编辑公共目的地图标。

  • 左键点击:开始导航。
  • 右键点击:重命名目的地。
  • Shift+点击:使用鼠标指针或主手物品设置目的地图标。

图标以 Bukkit 材质名称保存至 destinations.yml 文件中。

建造道路与交叉口

使用 GPS Intersection Tool 创建并连接交叉口。第一次点击的节点和第二次点击的节点定义了创建方向性链接时的方向。方向指示器通过粒子效果可视化显示,以便管理员查看单行道和双向路线。

使用 GPS Remover Tool 在注视时移除链接或交叉口。

如果需要撤销最近的网络编辑,请使用 GPS Undo Tool。

交通规则

交通规则位于 network.yml 中的 edge-rules 下。

成本乘数可以影响路径规划:

  • 1.0: 普通道路。
  • 2.0: 较低优先级的路线。
  • 0.5: 高优先级/快速路线。

TRAFFIC RULES BANNER

路线行为

RECALC. BANNER

GPS Systems 力求在快速纠正错误的同时保持路线稳定:

  • 它会遵循当前激活的路线,而不是不断重新计算。
  • 它会检测玩家是否偏离路线。
  • 如果配置了车道/方向检查,它会进行验证。
  • 当目的地靠近路边或离玩家非常近时,它可以添加虚线本地路段。
  • 它会将已完成的地图路线部分显示为灰色。

关键选项:

navigation:
  dynamic-recalculate: true
  lane-match-recalculate: true
  route-direction-match: true
  destination-local-direct: true
  destination-local-direct-player-radius: 70.0

推荐设置建议

  • 在重要的道路交汇点、车道分叉点和转弯点放置交叉口。
  • 如果道路有弯道或多个入口,避免使用过长的道路链接。
  • 对分离的车道使用单向规则。
  • 使用分类功能来创建易于阅读的目的地菜单和地图颜色。
  • 保持目的地图标简洁且易于识别。
  • 从多个方向测试路线,而不仅仅是在出生点。

支持说明

如果某条路线看起来不正确:

  • 检查目的地是否链接到有效的网络节点。
  • 检查单向规则未被颠倒。
  • 检查附近并行车道的表示是否正确。
  • 根据道路宽度调整车道匹配半径的大小。
  • 使用游戏内编辑器覆盖层检查交叉口和连接点。

插件目前处于测试阶段,可能会出现错误! 完整指南请访问:

END BANNER

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源