Troubleshooting

Parser errors

• Make sure your script has a top-level function main().
• Load modules explicitly with use(...).
• Add fallback guards before reading API response fields.

Run parser diagnostics:
!parser test

Then retry a minimal script:
!parser ```
function main() {
  ctx.reply("ok");
}
```

Permission failures

• Check role hierarchy: bot role must be above managed roles.
• Check channel overrides: read/send/manage perms may be denied at channel level.
• Re-run module status command after permission changes.

Permission verification commands:
!security show
!tickets setup
!leveling status

Module setup pitfalls

• Security too strict for small servers: lower thresholds first.
• Ticket transcripts missing: verify transcript channel visibility.
• Level rewards not applied: check role hierarchy and ignore list overlap.

Safe recovery checklist

1. Disable only the failing submodule.
2. Keep logs enabled while testing fixes.
3. Apply one config change at a time.
4. Verify with a controlled test action.
5. Document final working values in mod notes.