Test whether a Quests item requirement consumes the offered item

Applies to: PikaMug Quests; match the linked maintainer documentation to your installed platform and release.
Documentation checked 9 November 2026.

A quest requirement can check an item and may also remove it according to its settings. Test that distinction before asking players to bring valuable custom equipment.

Check the installed content

PikaMug Quests has its own quest editor and player progress storage. Confirm that you use this plugin rather than another project named Quests. Current maintainer documentation targets version 5 and newer; use the legacy reference when your installed release needs it.

Work through the change

1. In game on staging, open the quest requirements through /quests editor and record the required item and quantity. Compare the consumption option with the installed-version requirements reference.
2. Prepare a disposable ordinary account with exactly the required quantity and record its inventory. Keep the quest reward low-value so the test isolates acceptance rather than profit.
3. Accept the quest through the normal player route and inspect the inventory immediately. Repeat with one fewer item and with a similar item that should not satisfy the match.
4. Test cancellation and a second acceptance only where the quest rules allow it. Record when the item is checked and when it is removed rather than assuming cancellation refunds a consumed requirement.

Verify the result

The quest should reject insufficient or mismatched items and consume only what the configured acceptance policy requires. The player-facing description should explain the cost accurately.

If the result differs

If a custom item fails, inspect the requirement matching options and its provider metadata. If the correct item disappears at an unexpected stage, check action events and objectives for a second removal path.

Keep a recovery path

Restore the previous requirement and disposable inventory checkpoint if the trial is wrong. Keep valuable production items out of testing and do not promise an automatic cancellation refund unless that behaviour has been deliberately implemented.

References and related help

Check the maintainer reference: PikaMug Quests documentation, PikaMug Quests documentation.

Before changing live data, read how to keep a completed recovery copy. For startup errors, use the log collection guide.