- 版权类型
- 原创
- 插件中文名称
- 资源探测
- 插件英文名称
- QuantumResourceTracker
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- 语言支持
- 中文(简体)
- 前置组件
- 无强制前置
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
QTracker
资源追踪 · 个人导航 · 自动采集
选好目标,让寻找资源更有方向。
135 项内置目录 | 个人目标高亮 | 自带导航 | 低开销设计
✦ 功能一览
✦ 实机效果
资源追踪
个人导航搭配目标高亮,直观显示目标距离与高低差,采完当前目标后继续寻找下一处。
NPC 与坐标导航
通过公开 API 接收其他插件传入的位置,使用同一套金剑指针与透明背景文字,为任务点、NPC 和区域入口提供指引。
✦ 四步开始使用
资源选择保存在玩家身上,重连后可再次开启。启用自定义道具模式时,使用服主配置的道具作为入口。
✦ 自动采集,让重复操作更轻松
自动放置消耗真实普通方块,并经过放置保护事件;带自定义数据的物品不会用作搭路材料。服主可以单独关闭自动采集、关闭自动搭路,或设置所需权限节点。
✦ 为持续使用设计的低开销架构
分批读取、共享缓存、异步检索,把工作分散到每一刻。
32 MiB 是索引缓存的估算预算,不是整个插件的总内存占用。实际开销随已加载区域、资源密度、同时使用人数与自动采集地形而变化。
✦ 安装与配置
将插件 JAR 放入服务器
首次统计会分批补齐;显示“仅已加载区域”时,数量只代表已加载部分。矿石、植株和生物的发现数量不等于预计掉落物数量。
已验证环境:Purpur 26.1.2 + Java 25。其他核心或版本组合,请先在测试服验证。
✦ 常用命令与权限
自动采集默认不要求额外权限;开启权限检查后,默认使用
✦ 开发者接入:制作一个坐标导航附属
QTracker 通过 Bukkit ServicesManager 提供
下面是一个完整的最小附属示例:
编译时,可直接将 QTracker 本体 JAR 作为项目依赖,并设为
✦ 作者与交流反馈
如在使用插件过程遇到任何 BUG 或有什么建议,可加入 QTracker 官方交流群:780593544。
群内咨询 小加;如遇到问题,也可以直接添加 QQ:3125131181。
反馈时请附上服务端版本、QTracker 版本、复现步骤和相关日志或截图,方便定位问题。
资源追踪 · 个人导航 · 自动采集
选好目标,让寻找资源更有方向。
135 项内置目录 | 个人目标高亮 | 自带导航 | 低开销设计
✦ 功能一览
| 资源目录 | 内置 135 项,涵盖矿物、作物、木材、生物来源等;支持自定义分类、图标、名称与资源来源。 |
| 自带个人导航 | 金剑指针搭配透明背景文字,显示目标方向、距离、高低差与已发现数量,默认追踪 100 格内最近的匹配来源。 |
| 目标高亮 | 方块黄色高亮,生物显示个人发光轮廓;每位玩家看到自己的目标。 |
| 连续寻找 | 当前目标采集完成后继续寻找下一处;支持成熟作物筛选和附近生物来源定位。 |
| 自动采集 | 自动移动、选择工具、挖掘、攻击与拾取,并处理可行的开路、搭桥、上搭和安全下挖。 |
| 自定义道具 | 默认使用普通指南针,也可通过材质、名称、Lore 配置专属追踪道具。 |
| 公开导航 API | 其他插件可创建个人坐标导航,用于 NPC 位置、任务点或区域入口提示。 |
━━━━━━━━━━━━━━━━━━━━━━━━
✦ 实机效果
资源追踪
个人导航搭配目标高亮,直观显示目标距离与高低差,采完当前目标后继续寻找下一处。
NPC 与坐标导航
通过公开 API 接收其他插件传入的位置,使用同一套金剑指针与透明背景文字,为任务点、NPC 和区域入口提供指引。
✦ 四步开始使用
- 准备道具:将普通指南针放入快捷栏,拿在主手。
- 选择资源:Shift+右键打开菜单,选择需要寻找的资源。
- 开启追踪:右键开启,再次右键关闭。开启后可以换用其他工具,指南针留在快捷栏即可。
- 按需自动采集:点击菜单底栏的“开启自动采集”,随时暂停、继续或停止;也可使用
/qtracker auto。
资源选择保存在玩家身上,重连后可再次开启。启用自定义道具模式时,使用服主配置的道具作为入口。
✦ 自动采集,让重复操作更轻松
- 沿地形寻找路线:检查脚部、头部与落脚空间,仅清理材质白名单允许的石头、泥土、沙土等障碍,并遵守方块保护事件,逐格接近目标。
- 处理高差与缺口:安全条件满足时,消耗背包中的普通圆石、泥土或地狱岩搭路、上搭;下挖前检查真实落脚点。
- 处理近处与脚下矿石:寻找安全采集站位,必要时补一格侧台;高空支撑矿下有深孔时,先准备承接掉落的落脚面,再开采拾取。
- 按实际收获计数:保留工具要求、挖掘进度和损耗,物品确认进入背包后更新收获数量。
- 随时暂停与继续:材料不足、背包满、保护拒绝或没有安全路线时给出提示;继续后重新寻找可用目标,保留已确认收获。
自动放置消耗真实普通方块,并经过放置保护事件;带自定义数据的物品不会用作搭路材料。服主可以单独关闭自动采集、关闭自动搭路,或设置所需权限节点。
━━━━━━━━━━━━━━━━━━━━━━━━
✦ 为持续使用设计的低开销架构
分批读取、共享缓存、异步检索,把工作分散到每一刻。
| 只看已加载区域 | 搜索不会主动加载或生成新区块,避免为了寻找远处资源额外扩展世界。 |
| 分刻获取快照 | 默认每 tick 最多获取 1 个区块快照,首次搜索逐批补齐,界面同步显示进度。 |
| 后台索引检索 | 默认使用 1 个后台工作线程处理快照索引与搜索计算;游戏世界操作保留在服务器主线程。 |
| 多人共享缓存 | 复用同一套有上限的区块索引,默认最多缓存 512 个区块,索引估算预算 32 MiB。 |
| 事件增量更新 | 挖掘、放置、作物生长等事件更新对应索引,减少重复扫描;过期缓存会重新核实。 |
| 队列与动作有预算 | 查询队列、等待快照和寻路节点均有上限;寻路分刻推进,开路、搭建与采集共用每刻动作预算。 |
| 状态可查看 | 通过 /qtracker status 查看使用人数、缓存、队列、快照耗时与自动采集状态,便于按实际负载调整。 |
32 MiB 是索引缓存的估算预算,不是整个插件的总内存占用。实际开销随已加载区域、资源密度、同时使用人数与自动采集地形而变化。
✦ 安装与配置
将插件 JAR 放入服务器
plugins 目录,重启后生成配置。玩家使用正常客户端即可,个人导航由 QTracker 自带。- 范围与世界:默认半径 100 格,可调整为 1~128 格,并指定开放世界。
- 目录与入口:配置资源分类、图标、名称、来源,以及追踪道具的材质、名称和 Lore。
- 运行预算:按服务器规模调整缓存、队列、自动采集人数、寻路节点与每刻动作。
首次统计会分批补齐;显示“仅已加载区域”时,数量只代表已加载部分。矿石、植株和生物的发现数量不等于预计掉落物数量。
已验证环境:Purpur 26.1.2 + Java 25。其他核心或版本组合,请先在测试服验证。
✦ 常用命令与权限
| 命令 | 用途 |
/qtracker help | 查看帮助。 |
/qtracker menu | 打开资源菜单。 |
/qtracker auto | 开启、暂停或继续自动采集。 |
/qtracker stop | 停止自己的资源追踪。 |
/qtracker give [玩家] | 管理员发放追踪道具。 |
/qtracker reload | 管理员重载配置。 |
/qtracker status | 管理员查看运行状态与统计。 |
quantumresourcetracker.use:基础使用权限,默认所有玩家拥有。quantumresourcetracker.admin:管理权限,默认 OP 拥有。自动采集默认不要求额外权限;开启权限检查后,默认使用
quantumresourcetracker.auto,也可设置自己的节点。✦ 开发者接入:制作一个坐标导航附属
QTracker 通过 Bukkit ServicesManager 提供
com.quantum.resourcetracker.api.NavigationApi,支持开始导航、更新坐标与文字、查询状态和结束导航。API 导航无需玩家持有追踪道具,适合用于任务引导、NPC 导航和区域入口提示。下面是一个完整的最小附属示例:
/customnav 100 64 -20 开始本世界坐标导航,/customnav stop 仅结束该附属自己的导航。示例已通过 Java 21 编译验证。编译时,可直接将 QTracker 本体 JAR 作为项目依赖,并设为
provided;也可选用单独提供的 NavigationAPI JAR。附属插件通过本体内置的 API 调用导航,无需单独安装 API 包。请勿将 QTracker 或 API 类打包、重定位进附属 JAR。服务器只需安装 QTracker 与附属插件,plugin.yml 的前置名称使用 QuantumResourceTracker。CustomNavigationPlugin.java
plugin.yml
同步命令和生命周期中的 API 调用直接执行即可;异步任务请先切回主线程。示例每次读取当前导航服务,便于应对服务重载;插件停用时,只清理归属于本附属的导航。此附属提供视觉指引,不自动移动玩家或发放任务奖励。
Java:
package com.example.qtrackernav;
import com.quantum.resourcetracker.api.NavigationApi;
import org.bukkit.Bukkit;
import org.bukkit.Location;
import org.bukkit.command.Command;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import org.bukkit.plugin.java.JavaPlugin;
public final class CustomNavigationPlugin extends JavaPlugin {
@Override
public void onEnable() {
if (navigation() == null) {
getLogger().severe("未找到 QTracker 导航服务,请先安装提供导航 API 的 QTracker。");
Bukkit.getPluginManager().disablePlugin(this);
}
}
// 每次获取当前服务,使 QTracker 重载后的命令不会继续使用已注销的旧引用。
private NavigationApi navigation() {
return Bukkit.getServicesManager().load(NavigationApi.class);
}
@Override
public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
if (!(sender instanceof Player player)) {
sender.sendMessage("请在游戏内执行此命令。");
return true;
}
NavigationApi api = navigation();
if (api == null) {
player.sendMessage("§c导航服务暂不可用,请稍后再试。");
return true;
}
if (args.length == 1 && args[0].equalsIgnoreCase("stop")) {
api.clear(this, player); // 仅清理这个附属插件自己的导航。
player.sendMessage("§e自定义导航已结束。");
return true;
}
if (args.length != 3) {
player.sendMessage("§e用法:/customnav <x> <y> <z> 或 /customnav stop");
return true;
}
try {
double x = Double.parseDouble(args[0]);
double y = Double.parseDouble(args[1]);
double z = Double.parseDouble(args[2]);
if (!Double.isFinite(x) || !Double.isFinite(y) || !Double.isFinite(z)) {
throw new NumberFormatException();
}
Location target = new Location(player.getWorld(), x, y, z);
if (y < player.getWorld().getMinHeight() || y >= player.getWorld().getMaxHeight()
|| !player.getWorld().getWorldBorder().isInside(target)) {
player.sendMessage("§c目标超出当前世界的高度或边界。");
return true;
}
boolean started = api.navigate(this, player, target, "自定义导航", "我的目标点");
player.sendMessage(started ? "§a已开始导航,使用 /customnav stop 结束。"
: "§e当前导航已被占用,或目标暂不可用;请先结束现有导航。");
} catch (NumberFormatException invalidNumber) {
player.sendMessage("§c坐标必须是有效数字,例如 /customnav 100 64 -20。");
}
return true;
}
@Override
public void onDisable() {
NavigationApi api = navigation();
if (api != null) {
for (Player player : Bukkit.getOnlinePlayers()) api.clear(this, player);
}
}
}
plugin.yml
YAML:
name: QTrackerNavigationExample
version: '1.0.0'
main: com.example.qtrackernav.CustomNavigationPlugin
api-version: '1.21'
depend: [QuantumResourceTracker]
description: 使用 QTracker 公共导航 API 的最小坐标导航示例
commands:
customnav:
description: 开始或停止自己的坐标导航
usage: /customnav <x> <y> <z> 或 /customnav stop
permission: customnav.use
permissions:
customnav.use:
description: 使用坐标导航示例
default: true
同步命令和生命周期中的 API 调用直接执行即可;异步任务请先切回主线程。示例每次读取当前导航服务,便于应对服务重载;插件停用时,只清理归属于本附属的导航。此附属提供视觉指引,不自动移动玩家或发放任务奖励。
✦ 作者与交流反馈
如在使用插件过程遇到任何 BUG 或有什么建议,可加入 QTracker 官方交流群:780593544。
群内咨询 小加;如遇到问题,也可以直接添加 QQ:3125131181。
反馈时请附上服务端版本、QTracker 版本、复现步骤和相关日志或截图,方便定位问题。
━━━━━━━━━━━━━━━━━━━━━━━━
QTracker · 从选中目标,到找到下一份资源。
QTracker · 从选中目标,到找到下一份资源。