Rusty Namechange - Troubleshooting

Incident Patterns and Root Causes

Form does not open

Required document gate active and player has no matching document record.

Request cannot be submitted

Name validation fails, reason text too short, missing signature, pending request exists or cooldown active.

No fee deduction

Framework bridge mismatch or player has insufficient cash/bank for configured reason fee.

Reviewer menu blocked

Reviewer access config does not match player admin group / permission / job.

Approval but no name update

Character DB schema differs from expected ESX/QB fields or identifier/citizenid mapping is wrong.

Rusty UI sound missing

HTML references paper/stamp sound files; ensure audio assets are shipped and listed in resource files if used.

Recovery Checklist

# Startup order
ensure oxmysql
ensure es_extended   # or qb-core
ensure smx-namechange

# Verify tables
SELECT * FROM smx_namechange_requests LIMIT 5;
SELECT * FROM smx_namechange_history LIMIT 5;

# Verify reviewer access config
Config.ReviewerAccess
Config.ReviewerMenu

Escalation: Enable Config.Debug = true and capture server lines around submitRequest / approveRequest for fast issue tracing.

SMX Documentation

Rusty Style Namechange

Incident Patterns and Root Causes

Form does not open

Request cannot be submitted

No fee deduction

Reviewer menu blocked

Approval but no name update

Rusty UI sound missing

Recovery Checklist