Skip to main content

Distinguish Vault economy failures from permissions failures

Applies to: Vault; match the linked maintainer documentation to your installed platform and release.
Documentation checked .

A denied shop action and a missing money hook need different fixes. Capture the exact message so you do not respond to an economy error by granting broad administrative access.

Before you start

Vault connects consumer plugins to an economy provider; it does not replace that provider or store your player balances. Identify the component holding the money before changing integrations, and check the provider name in startup logs.

Work through the check

  1. Reproduce with one non-operator account and record whether the failure happens when opening the feature or during payment.
  2. Check the consumer’s own permission documentation and compare the required node with that account’s effective permissions.
  3. Read the startup economy hook and the provider balance for the same account; keep these checks separate from permission inheritance.
  4. Allow only the documented task permission on a test role, then retry a low-value transaction and remove the role afterward.

What to compare

Use one known successful payment as a control. If the provider processes that payment but a particular user cannot open the shop command, investigate that access path separately from service registration.

Confirm the result

The account should open only the intended feature and complete the payment through the provider, while unrelated administrative commands remain denied.

If the result differs

If access succeeds but charging fails, inspect provider registration, balance limits and the transaction error. If no access check passes, examine world or server permission contexts instead.

Recover safely

Remove temporary grants after the test. Leave Vault and money data unchanged when the evidence points to authorization, and restore the original role if the new node grants more access than intended.

Documentation and related help

Check the Vault maintainer documentation and Vault maintainer reference against your installed release before applying changes.