Skip to content

Troubleshooting and recovery

Start with $profile:\RaG_Core\Configs\RaG_Trader\ConfigValidationReport.txt. Check Trader logs under $profile:\RaG_Core\Logs\RaG_TraderLogger\ and the server RPT for spawn, model, or script errors.

Symptom What to check
Trader does not start Check RaG Core on server and clients. Confirm "Version": 1 in the main files, valid JSON, and write access to the profile. Read the first blocking error.
Static trader absent Enable EnableStaticTraders, the group, and its trader entry. Check the exact entity class, profile reference, map coordinates, and report's spawn status. For a missing terminal, check the group's Objects entry and server warnings.
Traveling trader absent Enable EnableRoutes and the route. Check schedule, current phase, and spawn clearance in Diagnostics. Move players and vehicles clear of the trader's position.
Category missing Check the filename under Trading/Categories/ and the profile's Categories list. At a route, check the current stop's category filter.
Listing greyed out Check config errors, active offer pool, stock, and whether buying or selling is enabled.
Sale rejected Check the exact class, required liquid, health, remaining quantity, cargo, inventory lock, and stock capacity. Use a fresh review if the items or price changed.
Vehicle purchase blocked Clear the configured spawn points and check vehicle attachments. For boats, check that the point is in water.
Vehicle sale rejected Check exact class, ownership or last driver, engine, occupants, and distance to the dealer's vehicle point.
ATM or Transfer absent Check RaG_ATM placement, the banking switches, and whether the item currency has an enabled bank entry.
Player market unavailable Enable P2P, check its configured currency, place a permitted board, and test within its interaction radius.
Wanted order cash cannot be collected Use Purchased for payouts or Returns for refunds. Make inventory space. Check server logs if the claim is held for recovery.
Garage meter unavailable Enable the garage and check the platform angle or the standalone meter's match to MeterPosition. Restart after changing Vehicles/Garages.json.
Garage vehicle missing from parked list Check the parking area's bounds, vehicle support, ownership, engine, occupants, towing, and inventory lock.
Garage retrieval blocked Return to the original meter if required. Clear the retrieval area and check vehicle type, surface, and clearance.
Reload rejected Check the report, then confirm the edit supports live reload and the server has no pending ordinary transaction recovery.

Recovery holds

Stop repeating an operation when it reports a recovery hold. Record the player ID, operation ID or receipt, and approximate time. Preserve related files and inspect what the server already delivered, removed, or credited.

  • Ordinary trade or ATM. Inspect the transaction journal, stock, player inventory, and account balance. An admin can retry ordinary recovery.
  • Bank transfer. Compare both account records with BankTransfers.json.
  • Player market. Keep the listing journal, item payload, and quarantine records with the affected accounts. For a cash reserve or claim, also inspect the linked transaction journal and player inventory.
  • Vehicle storage. Keep garage or portable packing files with the world save. Check whether the original vehicle still exists before recovering a snapshot.

See backup sets for the full paths.