SimpleGPS

插件

· 作者 ZuffyMC

先进的 GPS 导航,配备交互式 GUI 菜单、实时 Bossbar/Actionbar 追踪、可视化目的地粒子效果、经济系统集成、权限限制以及 SQLite 支持。

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

最新 SimpleGPS-1.2 · 26.2 · Bukkit / Paper

一键开服(送7天)

SimpleGPS

SimpleGPS 是一款专为 Paper/Spigot 1.21+ 打造的现代、轻量级 GPS 与航点插件。

通过现代化的 /gps GUI、实时航点追踪、动作栏导航、Boss 栏导航、视觉目的地标记、公共和私有航点、航点分享以及针对每位玩家优化的 GPS 系统,为您的玩家提供简洁且沉浸式的导航体验。

旨在打造一款高品质插件,拥有现代 UI 设计、清晰的反馈系统、轻量级的性能表现、安全的存储处理、详细的配置选项以及广泛的自定义功能。


⮞ 展示:GPS 追踪


⮞ 预览

GPS_Menu Tracking

⮞ 功能特性

现代化 GPS 菜单

  • 使用 /gps 打开
  • 简洁响应的 GUI 布局
  • 导航控制
  • 私有航点区域
  • 公共航点区域
  • 共享航点区域
  • 最近位置按钮
  • 停止追踪按钮
  • 支持排序与分页
  • 即时航点追踪
  • 刷新、帮助、关闭和停止追踪等功能按钮
  • 航点状态显示
  • 距离显示
  • 世界显示
  • 所有者显示

航点管理

  • 使用 /gps add <name> 保存位置
  • 使用 /gps remove <name> 删除位置
  • 使用 /gps rename <old> <new> 重命名位置
  • 使用 /gps info <name> 查看位置详情
  • 使用 /gps list 列出可访问的位置
  • 使用 /gps desc <name> <description> 编辑描述
  • 重启后数据持久化
  • 每个航点均可自定义颜色、字体和材质图标
  • 基于所有者的航点数据
  • 支持创建时间和更新时间的时间戳
  • 安全处理缺失或无效的航点文件

公共与私有航点

  • 创建个人私有航点
  • 创建服务器公共航点
  • 使用 /gps public <name> 更改航点状态为公共
  • 使用 /gps private <name> 将航点改回私有
  • 公共航点可用于服务器地点,如出生点 (Spawn)、商店 (Shop)、宝箱 (Crates)、随机传送 (RTP)、竞技场 (Arena)、银行家 (Banker)、任务 (Jobs)、任务 (Quests) 等
  • 私有航点仅对所有者可见
  • 可通过权限控制公共航点的访问
  • GUI 中指示公共、私有和共享航点

航点分享

  • 使用 /gps share <player> <name> 与其他玩家分享航点
  • 只有获得权限的玩家才能看到共享航点
  • 适用于团队、基地、活动、集合点和临时地点
  • 基于权限的分享系统
  • 安全的访问验证

最近航点

  • 使用 /gps nearest 查找最近的可用航点
  • 仅检查同一世界内的航点
  • 尊重公共、私有和共享航点的访问权限
  • 尊重玩家权限
  • 显示航点名称和距离
  • 点击输出结果即可开始追踪
  • 可作为 GUI 按钮使用:Nearest Location(最近位置)

高级 GPS 追踪

  • 实时动作栏导航
  • 可选 Boss 栏导航
  • 方向指引和距离追踪
  • 自动到达检测
  • 跨世界安全处理
  • 开始追踪和到达时的标题反馈
  • 每位玩家独立的 GPS 会话
  • 使用 /gps stop 停止追踪
  • 登出时清理追踪状态
  • 切换世界时清理追踪状态
  • 插件重载时清理追踪状态
  • 安全的会话处理以避免重复任务

Boss 栏追踪模式

  • 高端感的 Boss 栏导航
  • 可配置的 Boss 栏文本
  • 可配置的 Boss 栏颜色
  • 可配置的 Boss 栏样式
  • 支持多种显示模式:
    • ACTIONBAR(动作栏)
    • BOSSBAR(Boss 栏)
    • BOTH(两者)
  • 当追踪停止、玩家到达、玩家登出或航点被移除时,Boss 栏会自动消失

视觉与沉浸式反馈

  • 目的地粒子标记
  • 悬浮航点特效
  • 柔和的导航音效
  • 到达音效
  • 开始追踪标题
  • 到达标题
  • 简洁的动作栏消息
  • 极简现代视觉设计
  • 可配置的粒子与音效

管理员航点模板

  • 创建可复用的航点模板
  • 将模板设置应用到现有航点
  • 加快服务器搭建速度
  • 保持服务器公共航点的视觉一致性

模板数据可包含:

  • 图标
  • 颜色
  • 字体
  • 描述
  • 分类
  • 粒子
  • 音效

冷却时间与限制系统

  • 可选的航点数量限制系统
  • 可选的冷却时间系统
  • 防止航点滥用
  • 基于权限的最大航点数量限制
  • 支持权限绕过
  • 支持 10s、5m 和 1h 等时间格式
  • 适用于生存和经济类服务器

导入、导出与备份

  • 导出航点数据
  • 导入航点数据
  • 创建备份
  • 恢复备份
  • 自动备份支持
  • 可配置的备份间隔
  • 可配置的备份保留策略
  • 导入时安全处理重复数据
  • 适用于服务器迁移和数据安全

可选 SQLite 存储

  • YAML 存储仍为默认选项
  • SQLite 存储为可选功能
  • 专为大型服务器设计
  • 数据库文件自动生成
  • 安全的表创建机制
  • 可选的存储迁移支持
  • 默认轻量级,按需可扩展

可选经济费用系统

  • 可选的基于 Vault 的费用系统
  • 默认禁用
  • 除非启用,否则无需依赖经济插件
  • 对选定操作收取玩家费用
  • 支持的操作包括:
    • 添加航点
    • 开始追踪
    • 创建公共航点
    • 分享航点
    • 管理员传送
  • 支持权限绕过
  • 收费前进行安全验证

完全可配置

  • 消息完全可配置
  • 支持印尼语语言文件
  • 支持英语备用语言
  • 自定义 GUI 字符串
  • 可配置的音效与粒子
  • 可调整的追踪间隔
  • 可配置的标记行为
  • 灵活的航点样式系统
  • 可配置的备份系统
  • 可配置的存储类型
  • 可配置的控制台启动横幅
  • 可配置的控制台重载摘要

高级控制台日志

  • 干净的启动横幅
  • ASCII 风格的插件品牌标识
  • 控制台中显示下载链接
  • 已加载的位置统计信息
  • 已加载的模板统计信息
  • 存储状态
  • 语言状态
  • 备份状态
  • 经济系统状态
  • 兼容性状态
  • 详细的重载摘要
  • 失败时的警告和错误详情

⮞ 命令

命令 描述
/gps 打开 GPS 菜单
/gps add <name> 保存当前位置
/gps remove <name> 移除一个位置
/gps rename <old> <new> 重命名一个航点
/gps desc <name> <description> 编辑位置描述
/gps color <name> <color> 设置航点颜色
/gps font <name> <font> 设置航点字体样式
/gps icon <name> <icon> 设置航点图标
/gps public <name> 将航点设为公开
/gps private <name> 将航点设为私有
/gps share <player> <name> 与另一位玩家共享航点
/gps nearest 查找最近的可用航点
/gps info <name> 显示航点信息
/gps list 列出可用的航点
/gps stop 停止当前追踪
/gps teleport <name> 传送至某个航点
/gps reload 重载 SimpleGPS 配置和数据
/gps help 显示帮助
/gps version 显示插件版本

模板命令

命令 描述
/gps template create <templateName> 创建航点模板
/gps template apply <templateName> <waypoint> 将模板应用到航点
/gps template delete <templateName> 删除模板
/gps template list 列出可用模板
/gps template info <templateName> 显示模板信息

备份与导入命令

命令 描述
/gps backup 显示备份帮助
/gps backup create 创建备份
/gps backup list 列出备份
/gps backup restore <file> 恢复备份
/gps export 导出航点数据
/gps export all 导出所有航点数据
/gps import <file> 导入航点数据

存储命令

命令 描述
/gps storage migrate yaml sqlite 将 YAML 数据迁移到 SQLite
/gps storage migrate sqlite yaml 将 SQLite 数据迁移到 YAML

颜色示例

sky
aqua
lime
gold
violet
#7AFFC1
grad:#00FFFF:#7AFFC1

字体样式

normal
bold
smallcaps
bold_smallcaps

图标示例

COMPASS
BEACON
ENDER_PEARL
MAP
CHEST
DIAMOND
EMERALD
NETHER_STAR
ENDER_EYE
BOOK

⮞ 权限

权限 描述
gps.menu.use 使用 /gps
gps.setup 使用 /gps add
gps.remove 使用 /gps remove
gps.description 使用 /gps desc
gps.color 使用 /gps color
gps.font 使用 /gps font
gps.icon 使用 /gps icon
gps.help 使用 /gps help
gps.version 访问版本命令
gps.rename 使用 /gps rename
gps.info 使用 /gps info
gps.list 使用 /gps list
gps.stop 使用 /gps stop
gps.nearest 使用 /gps nearest
gps.public.use 使用公开航点
gps.public.manage 管理公开/私有航点状态
gps.share 共享航点
gps.share.receive 接收共享的航点
gps.template.use 使用航点模板
gps.template.manage 管理航点模板
gps.teleport 使用 /gps teleport
gps.reload 使用 /gps reload
gps.backup 使用备份命令
gps.import 使用导入命令
gps.export 使用导出命令
gps.storage.migrate 使用存储迁移命令
gps.limit.10 将航点限制设置为 10
gps.limit.30 将航点限制设置为 30
gps.limit.50 将航点限制设置为 50
gps.limit.bypass 绕过航点数量限制
gps.cooldown.bypass 绕过冷却时间
gps.cost.bypass 绕过经济费用
gps.admin 访问所有管理员功能

⮞ 存储系统

SimpleGPS 采用安全且灵活的存储处理机制构建。

YAML 存储

  • 默认存储类型
  • 基于文件的 YAML 存储
  • 每个航点一个文件
  • 易于手动编辑
  • 易于备份
  • 内存中缓存位置
  • 安全的文件处理

SQLite 存储

  • 可选存储类型
  • 更适合大型服务器
  • 单个数据库文件
  • 自动创建表
  • 适用于较大的航点数据
  • 对于轻量级使用,YAML 仍为默认选项

存储路径

plugins/SimpleGPS/locations/

每个航点存储:

  • 位置坐标
  • 世界信息
  • 拥有者 UUID
  • 描述
  • 状态
  • 共享玩家
  • 时间戳
  • 样式设置
  • 图标设置
  • 分类
  • 粒子效果设置
  • 声音设置

⮞ 生成的文件夹结构

当插件启动时,SimpleGPS 将生成一个整洁的文件夹结构。

plugins/SimpleGPS/
├── config.yml
├── messages/
│   ├── en_US.yml
│   └── id_ID.yml
├── locations/
│   ├── example-waypoint.yml
│   └── ...
├── templates/
│   ├── shop.yml
│   ├── spawn.yml
│   └── ...
├── backups/
│   ├── simplegps-backup-YYYY-MM-DD-HH-mm.zip
│   └── ...
├── exports/
│   ├── simplegps-export-YYYY-MM-DD-HH-mm.yml
│   └── ...
└── database/
    └── simplegps.db

文件夹详情

文件夹 / 文件 描述
config.yml 主插件配置
messages/en_US.yml 英语备用消息
messages/id_ID.yml 印尼语消息
locations/ YAML 航点存储
templates/ 管理员航点模板
backups/ 手动和自动备份
exports/ 导出的航点数据
database/simplegps.db 可选 SQLite 数据库

⮞ 配置预览

SimpleGPS 包含一个整洁且有条理的配置文件中。

language:
  default: "id_ID"
  fallback: "en_US"

storage:
  type: YAML # YAML 或 SQLITE
  sqlite:
    file: "database/simplegps.db"

tracking-display:
  mode: BOTH # ACTIONBAR, BOSSBAR, BOTH
  update-interval-ticks: 20
  actionbar:
    text: "&b⟐ {waypoint} &7| &f{distance} blocks away"
  bossbar:
    enabled: true
    color: BLUE
    style: SOLID
    text: "&b⟐ {waypoint} &7| &f{distance} blocks away"

waypoints:
  public-enabled: true
  sharing-enabled: true
  nearest-enabled: true
  allow-cross-world-tracking: false

backup:
  enabled: true
  auto-backup:
    enabled: true
    interval-hours: 12
    keep-last: 10

cost:
  enabled: false

⮞ 性能与优化

SimpleGPS 旨在即使在大型服务器上也能保持轻量。

优化特性

  • 异步文件 I/O
  • 缓存的坐标点系统
  • 仅在需要时为每个玩家执行跟踪任务
  • 无不必要的全局跟踪循环
  • 减少调度器使用
  • 安全的清理处理
  • 低内存占用
  • 高效的 GPS 更新处理
  • Bossbar 清理保护
  • 重载安全的任务处理
  • 存储缓存系统

适用场景

  • 小型生存服(SMP)
  • 生存经济服
  • 中型社区服
  • 拥有大量玩家坐标点的大型服务器
  • 需要清晰公开位置的网络服

⮞ 兼容性

SimpleGPS 专为 Paper/Spigot 1.21+ 设计。

该插件不会不必要地阻止兼容的小版本补丁。如果您的服务器使用的是兼容的 1.21.x 版本,SimpleGPS 将尝试确保主系统安全运行。

支持的环境:

  • Java 21
  • Paper 1.21+
  • Spigot 1.21+
  • 兼容的 1.21.x 小版本

⮞ 依赖要求

  • Java 21
  • Paper/Spigot 1.21+
  • 无需外部依赖

可选:

  • Vault,仅在经济费用系统启用时需要

⮞ 安装

  1. 下载 SimpleGPS.jar
  2. 将 SimpleGPS.jar 放入 /plugins 文件夹
  3. 重启服务器
  4. 运行 /gps
  5. 在以下路径配置插件:
plugins/SimpleGPS/config.yml
  1. 编辑消息内容于:
plugins/SimpleGPS/messages/

⮞ 支持

需要帮助、发现 bug 或有功能建议?

Discord 支持:

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源