
SimpleGPS 是一款专为 Paper/Spigot 1.21+ 打造的现代、轻量级 GPS 与航点插件。
通过现代化的 /gps GUI、实时航点追踪、动作栏导航、Boss 栏导航、视觉目的地标记、公共和私有航点、航点分享以及针对每位玩家优化的 GPS 系统,为您的玩家提供简洁且沉浸式的导航体验。
旨在打造一款高品质插件,拥有现代 UI 设计、清晰的反馈系统、轻量级的性能表现、安全的存储处理、详细的配置选项以及广泛的自定义功能。
⮞ 展示:GPS 追踪
⮞ 预览
⮞ 功能特性
现代化 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,仅在经济费用系统启用时需要
⮞ 安装
- 下载
SimpleGPS.jar - 将
SimpleGPS.jar放入/plugins文件夹 - 重启服务器
- 运行
/gps - 在以下路径配置插件:
plugins/SimpleGPS/config.yml
- 编辑消息内容于:
plugins/SimpleGPS/messages/
⮞ 支持
需要帮助、发现 bug 或有功能建议?
Discord 支持:
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持

评论 0
登录后参与评分
还没有评论,来抢沙发吧