QTracker - 自动挖矿|资源追踪|导航指针前置库 | 1.21 - 26.x

原创 前置/API 工具 QTracker - 自动挖矿|资源追踪|导航指针前置库 | 1.21 - 26.x 1.2.5

请登录后获取
版权类型
原创
插件中文名称
资源探测
插件英文名称
QuantumResourceTracker
原帖地址
#
支持的核心(服务端)
  1. Spigot
  2. Paper
  3. Purpur
语言支持
中文(简体)
前置组件
无强制前置
适配版本(Java)
  1. 最新版本
  2. 26.x
  3. 1.21
1795068300523.webp
QTracker
资源追踪 · 个人导航 · 自动采集

选好目标,让寻找资源更有方向。
135 项内置目录 | 个人目标高亮 | 自带导航 | 低开销设计

钻石在哪里?作物去哪找?任务材料还差几份?
QTracker 将附近资源整理成可选择的目录,通过个人金剑指针、透明背景导航文字、目标高亮和高低差,为玩家指引下一处资源。打开菜单、选好目标,即可开始追踪,也能按需开启自动采集。

✦ 功能一览

资源目录内置 135 项,涵盖矿物、作物、木材、生物来源等;支持自定义分类、图标、名称与资源来源。
自带个人导航金剑指针搭配透明背景文字,显示目标方向、距离、高低差与已发现数量,默认追踪 100 格内最近的匹配来源。
目标高亮方块黄色高亮,生物显示个人发光轮廓;每位玩家看到自己的目标。
连续寻找当前目标采集完成后继续寻找下一处;支持成熟作物筛选和附近生物来源定位。
自动采集自动移动、选择工具、挖掘、攻击与拾取,并处理可行的开路、搭桥、上搭和安全下挖。
自定义道具默认使用普通指南针,也可通过材质、名称、Lore 配置专属追踪道具。
公开导航 API其他插件可创建个人坐标导航,用于 NPC 位置、任务点或区域入口提示。

━━━━━━━━━━━━━━━━━━━━━━━━​

✦ 实机效果

资源追踪
个人导航搭配目标高亮,直观显示目标距离与高低差,采完当前目标后继续寻找下一处。
1795064228773.webp


NPC 与坐标导航
通过公开 API 接收其他插件传入的位置,使用同一套金剑指针与透明背景文字,为任务点、NPC 和区域入口提供指引。
1795064490232.webp


✦ 四步开始使用

  1. 准备道具:将普通指南针放入快捷栏,拿在主手。
  2. 选择资源:Shift+右键打开菜单,选择需要寻找的资源。
  3. 开启追踪:右键开启,再次右键关闭。开启后可以换用其他工具,指南针留在快捷栏即可。
  4. 按需自动采集:点击菜单底栏的“开启自动采集”,随时暂停、继续或停止;也可使用 /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
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 · 从选中目标,到找到下一份资源。​
作者
oroska
价格
100.00金粒
下载
0
查看
55
首次发布
最后更新

评分

0.00 星 0 次评分
后退
顶部 底部