Troubleshooting and Production

• Common Problems
• Diagnostics & Recovery
• Production Checklist

Common Problems

Common Problems

Admin command does nothing

Check:

• Config.AdminCommand
• Config.AdminAce
• ACE assignment in server.cfg
• Server console errors

Garage is not visible

Check that the garage is published, has valid points, correct access rules and compatible categories.

Vehicle does not appear

Check framework ownership first, then run the trusted reconciliation path. For staff-created vehicles, ensure Nord Garages is notified after the ownership row is created.

Vehicle appears in wrong impound

Use the impound reconciliation/type audit exports and verify the vehicle model/class is correct. Separate plane and helicopter yards must match their configured categories.

Fuel restores as 0

Confirm the configured fuel provider is actually running before Nord Garages and that no second resource overwrites fuel immediately after spawn.

Keys duplicate or disappear

Start your key resource before Nord Garages. With Nord Vehicle Keys, avoid granting/removing permanent physical keys client-side from a second integration.

UI opens but data is stale

Check live sync events between Staff/Phone/custom integrations rather than forcing constant UI reopen/restart behaviour.

Diagnostics & Recovery

Diagnostics & Recovery

Useful server-side diagnostic exports:

AuditVehicleTypes()
ReconcileImpounds(options)
GetRecoveryCenter()
RepairVehicleState(value, action, garage, actor)
GetVehicleGarageState(plate)
GetStaffVehicleSnapshot(limit)
SyncAllFrameworkVehicles(limit, force)
GetProviders()

Recovery Center examples

Recovery can address stale transient states and missing/incompatible garage assignments through the normal state synchronization flow.

Production logging

Keep Config.Debug = false normally. Enable it only while reproducing a problem, collect the relevant console output, then disable it again.

What runtime testing must cover

Static validation cannot reproduce every combination of framework build, MLO geometry, OneSync ownership migration, fuel/key version or existing database contents. Always perform a staging smoke test before replacing a busy live resource.

Production Checklist

Production Checklist

Before release to players:

• oxmysql starts before Nord Garages.
• Framework auto-detection resolves the intended core.
• Correct key, fuel and inventory providers resolve.
• /garageadmin is restricted to the intended ACE/admin source.
• At least one land garage stores/spawns correctly.
• Boat/air garages are tested if used.
• Impounds are tested separately from normal garages.
• Job impound grades/categories are verified server-side.
• Capacity 0 behaves as unlimited where intended.
• Vehicle transfer completes and restores state.
• Physical keys do not duplicate across store/spawn cycles.
• Fuel persists across store/spawn.
• Showroom preview vehicles do not leak into normal target/inventory logic.
• Staff DV and ownership deletion use different integration paths.
• Phone/Staff lists refresh without resource restart.
• VIP persistent parking is restricted as intended.
• Server restart restores/repairs vehicle state correctly.
• Database backup exists before rollout.