Troubleshooting

Short checklists for the issues that come up most often during community hosting.

A config value does not seem to work

  1. Confirm you edited the Data copy, not the repository default.
  2. Save through /config or run the relevant reload command.
  3. Run litherarp.config_status.
  4. Check for validation warnings in the server console.
  5. Confirm whether the system requires a restart or map reload.
  6. Confirm the gameplay code consumes that value live.

A list shows numeric indices in /config

Use a managed collection editor when available. Numeric indices are normal for raw arrays, but creator-facing list workflows should use structured editors for jobs, rewards, phone GPS, RP names, arrests, NPCs, vehicles, emergency services, and shop.

A localization key shows on screen

The active language is missing the key and the fallback did not resolve it.

  1. Run litherarp.lang_status.
  2. Search the English pack for the key.
  3. Add the same key to the custom language file.
  4. Reload language.

Theme reset returns the wrong theme

Theme reset should return to activeTheme: "default". If a server still returns to another theme, inspect configs/theme.json in Data and run litherarp.theme_reset.

External references

Verify s&box-side behavior against the official documentation: