Match a BetonQuest quest item without accepting lookalikes

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

A renamed ordinary item can resemble a quest item without sharing its required identity. Test matching rules before a delivery objective accepts valuable substitutes or rejects legitimate rewards.

Check the installed content

BetonQuest expresses a quest through objectives, conditions, events and conversation links. Keep the package and player state together during testing. The linked reference describes the 2.2 documentation branch; select the corresponding documentation if your server runs another major version.

Work through the change

1. Record the quest item definition and the condition or objective that checks it. Save the package and identify which properties the installed branch uses for matching.
2. Prepare expendable staging examples: the legitimate item, a plain item of the same material and a renamed lookalike. Keep their quantities and creation paths recorded.
3. Test the relevant item condition or delivery objective with each example using an ordinary account. Inspect the required quantity and any removal event separately from the match itself.
4. If custom-item integrations are involved, verify their supported matching method in the installed release. Repeat after a restart so the outcome is not dependent on a temporary test item.

Verify the result

The legitimate item should pass, lookalikes should fail where the quest requires a distinct identity, and the intended amount should be counted or removed without touching unrelated inventory.

If the result differs

If every same-material item passes, inspect how strict the definition is rather than increasing quantity. If the legitimate item fails, compare the producing reward and matching definition before issuing replacement items.

Keep a recovery path

Restore the earlier item definition and disposable inventory checkpoint if matching is uncertain. Keep valuable player inventory outside the trial and do not delete similar items globally to enforce a quest rule.

References and related help

Check the maintainer reference: BetonQuest documentation, BetonQuest documentation.

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