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

1. 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.
2. 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).
3. 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.
4. 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: https://github.com/dx122dx/qab
• Companion mod (required): https://github.com/dx122dx/chunkscanner

License

AGPL-3.0-only.