Skip to main content

Runtime-Generated Files

The following files are written or updated during normal server operation. They must not be manually edited while the server is running.

FileContentsNotes
action_history.jsonFull action execution log with conditions and resultsLimited by history-max-records in config.yml
action_effectiveness.jsonSuccess rate per action type and mean TPS deltaUsed by the AIMD factor and cooldown scaling
view_distance_overrides.ymlAll active VD overrides indexed by scope and targetPersists across server restarts
simulation_distance_overrides.ymlAll active SD overrides indexed by scope and targetPersists across server restarts
observations.logRaw Eye observation data in structured formatOnly written when Analysis mode is enabled
analysis-report.txtHuman-readable lag diagnostics and configuration recommendationsGenerated at the end of each Analysis session
dumps/*.jsonFull system state snapshots generated by /auroraoptimizer dumpTimestamped; not automatically cleaned up

dumps/*.json files are not automatically deleted. Periodically clean the dumps/ directory to avoid disk space accumulation.