QShop Auto Buy (QAB)
QAB 是一款适用于 Minecraft 1.20.1 的 Fabric 客户端模组,作为 QShop 商店生态系统的自动化购买助手。它读取 Chunk Scanner 导出的 QShop 数据库,将你的建筑方案转化为购物清单,计算最优惠的购买计划,然后自动导航至各个商店并为你完成购买。
依赖项说明: QAB 单独使用毫无用处。它需要
Chunk Scanner(≥ 1.1.0),后者提供 QShop 商店数据库以及 QAB 所驱动的导航引擎。QAB 本身不会扫描服务器或读取商店数据——你必须先从 Chunk Scanner 导出数据库。
功能介绍
- 结构图 → 购物清单。 解析
.litematic / .schem / .schematic / .nbt
文件(通过内置的 schematic4j 库)以统计所需每种方块的数量,并提供倍数、冗余、排除和排序选项。无法购买的方块(如流体、火焰、活塞头等)会被报告并跳过。
- 清单 + 商店数据库 → 购买计划。 贪婪算法规划器将每个物品匹配到售价最低的商店,计算总成本,并标记未满足的需求量(失败)和未满足的冗余量(警告)。
- 计划 → 自动购买。
/qab nav apply 将计划中的所有商店加入队列,并驱动 Chunk Scanner 的导航系统前往每个告示牌(支持跨维度安全移动),到达后自动执行你的购买命令。
- 库存容量感知。 在每次下单前,它会检查你的背包实际能容纳多少该物品;只购买能装下的部分,其余重新排队。当背包满时,它会自动路由到配置的储藏箱,卸下物品后继续执行。
为什么你可能需要它
- 停止在蓝图和价格表之间切换 Alt+Tab —— 直接从建筑文件中生成清单。
- 绝不多花钱:规划器始终优先从最便宜的商店购买。
- 解放双手:你可以离开电脑,让 QAB 访问每个商店并完成结账;当存储空间不足时智能暂停,而不是把物品扔在地上。
下载前须知
- 仅限客户端。 安装到玩家的
mods/ 文件夹中。它不接触服务器端。
- 需要 Chunk Scanner ≥ 1.1.0 以及由其生成的 QShop 数据库导出文件。
- 需要在你所游玩的服务器上拥有活跃的 QShop 设置,且服务器允许 QAB 发出的购买命令。QAB 仅自动化你预先计划的购买行为;它不会发明交易或绕过商店权限。
- 命令:
/qab select db|list、/qab generate list <schematic> [config...]、
/qab plan [name]、/qab nav apply|stop <plan>、/qab stash add|list|remove。
- 配置文件:
config/qab/qab.json(包含购买延迟、购买命令模板、储藏点等配置)。
链接
许可证
AGPL-3.0-only.
QShop Auto Buy (QAB)
QAB is a Fabric client-side mod for Minecraft 1.20.1 that acts as an automated
buying assistant for the QShop shop ecosystem. It reads a
Chunk Scanner QShop database export, turns your building plans into a shopping list,
computes the cheapest purchase plan, and then auto-navigates to each shop and buys for you.
Companion dependency: QAB is useless on its own. It requires
Chunk Scanner (≥ 1.1.0), which supplies the
QShop shop database and the navigation engine QAB drives. QAB does not scan servers
or read shop data by itself — you must export the database from Chunk Scanner first.
What it does
- Schematic → shopping list. Parse
.litematic / .schem / .schematic / .nbt
files (via the bundled schematic4j library) into a count of every block you need,
with multiplier, redundancy, exclude and sort options. Unbuyable blocks (fluids, fire,
piston heads, etc.) are reported and skipped.
- List + shop database → purchase plan. A greedy planner matches each item to the
cheapest selling shops, computes total cost, and flags unmet required amounts (failed)
and unmet redundancy (warnings).
- Plan → auto buy.
/qab nav apply queues every shop in the plan and drives
Chunk Scanner's navigation to walk to each sign (cross-dimension safe), then runs your
buy command automatically on arrival.
- Inventory-capacity aware. Before each order it checks how many of the item your
inventory can actually hold; it buys only what fits and re-queues the rest. When your
bag is full it auto-routes to a configured stash chest, unloads, and resumes.
Why you might want it
- Stop alt-tabbing between a blueprint and a price list — generate the list from the build file directly.
- Never overpay: the planner always buys from the cheapest shop first.
- Hands-free fulfillment: walk away while QAB visits every shop and checks out, pausing
intelligently when storage runs out instead of dumping items on the ground.
What you must know before downloading
- Client-side only. Install in the player's
mods/ folder. It does not touch the server.
- Requires Chunk Scanner ≥ 1.1.0 and a QShop database export produced by it.
- Requires an active QShop setup on the server you play on, and that the server permits
the buy commands QAB issues. QAB only automates your own pre-planned purchases; it does
not invent trades or bypass shop permissions.
- Commands:
/qab select db|list, /qab generate list <schematic> [config...],
/qab plan [name], /qab nav apply|stop <plan>, /qab stash add|list|remove.
- Config file:
config/qab/qab.json (buy delay, buy command template, stash points, etc.).
Links
- Source & issues:
- Companion mod (required):
License
AGPL-3.0-only.
评论 0
登录后参与评分
还没有评论,来抢沙发吧