Troubleshooting

Pawnshop prompt does not appear

Possible Causes

• Player is not near configured coordinates.
• Marker is disabled and ped is not visible.
• Another resource blocks control/input flow.

Fix

• Verify Config.PawnShops[].coords and distance.
• Enable marker or ped to validate interaction point.
• Test with minimal UI resources enabled.

Selling items gives no payout

Possible Causes

• Inventory backend was not detected.
• Item removal failed for one or more items.
• Invalid item names in Config.PawnShops[].items.

Fix

• Ensure ox_inventory or qb-inventory is started.
• Implement fallback removeItem hook when using custom inventory.
• Validate item keys match real inventory item names.

Shop reports closed all the time

Possible Causes

• hoursOpen.enable is true with an incompatible open/close range.
• Server clock expectations do not match configured window.

Fix

• Re-check open and close values (0-23).
• Disable hours restriction while testing baseline behavior.

Webhook logs not received

Possible Causes

• Logging disabled.
• Webhook URL invalid/revoked.

Fix

• Set Config.Logs.enable = true.
• Replace webhook with a valid active Discord endpoint.

Implementation Risk Notes

Price Trust Boundary

Server calculates payouts using server-side config prices, but receives requested item counts from client payload; keep validation strict and monitor for unusual sell patterns.

Black Money Hook for QBCore

addBlackMoney in QB path uses an item-style call pattern and may require adaptation depending on your economy implementation.