Skip to content

10. Config Manager GUI

Finerus edited this page Aug 16, 2026 · 3 revisions

An in game screen that lets staff browse and edit every mod option without opening a single file.

Opening it

Press the configured keybind under Options > Controls > RP Essentials ("Open Config Manager"), or run /rpessentials config reload style commands manually if you prefer the command line, both work side by side.

How it works

  1. The client requests the list of config files from the server.
  2. Selecting a file on the left panel requests its entries, discovered through reflection on the corresponding config class (core, chat, schedule, moderation, professions, messages, rp).
  3. Each entry is rendered with the right widget for its type: a toggle for booleans, a numeric box for ints/doubles/longs (with a range hint if the option is bounded), a text box for strings, and a dedicated list editor for lists.
  4. Changes are staged locally and highlighted, nothing is written until you press Apply.
  5. Applying sends only the changed paths to the server, which validates them against known config paths and numeric ranges before saving.

Safety

  • Only staff (per the Staff Permission System) can request or save entries.
  • Unknown paths or oversized values sent by a modified client are rejected and logged.
  • Every applied change is broadcast to other online staff with the old and new value, and logged to console.
  • Saving reloads the entries automatically so the screen always reflects what is actually on disk.

Reset to default

Numeric, string, boolean and list entries that have drifted from their default value show a small ≠def indicator, and a dedicated reset button restores the default without needing to remember it.

Clone this wiki locally