Frequently Asked Questions (FAQ)

Config changes made but not taking effect in game?

• Hot reload polls every 2 seconds, please wait or manually call reload()
• If using instance fields, make sure code reads the current instance returned by get()

Numeric value automatically reverted to default?

• Check if it exceeds @Range range. Out-of-range reverts to default and logs warning

Why can't I see the entry I added in the UI?

• Confirm if type is supported (boolean, numeric, string, enum, List<String>)
• Confirm not viewing @ClientOnly items on server side
• Confirm language key is correct (should display English placeholder even if key not provided)

Config file format doesn't look like sections after migration?

• Migrator writes as "flat key-value list" with config_version
• To restore section and comment format, call save() once (e.g., click "save" in UI)

How to write boolean/enum values with proper casing?

• File is case-insensitive, internally matches by Enum.name()

Can boolean be written as 1/yes/y?

• Yes, parser accepts equivalent variants (case-insensitive)

Can I write list as single string?

• Yes. Without [...] will be parsed as single-element list

How to disable hot reload?

• Call config.stop() to stop file watcher (will also clear cache)