Debug commands are not a player-facing UI. Player-facing documentation covers overlay rows and Everest mod options. Commands serve development, testing, and controlled verification contexts only.
Exposure levels
| Level | Meaning |
|---|---|
| UI mirror | The command wraps an overlay row or Everest mod option. UI documentation is the normal player-facing path. |
| Automation | The command exists so QA can drive the UI or runtime repeatably. |
| Command-only | No first-class player UI exists. Treat as developer, QA, or controlled review tooling. |
Common UI mirrors
| Command | Purpose |
|---|---|
akron_status | Dump current Akron runtime state. |
akron_overlay <toggle|show|hide|status> | Control the overlay without a hotkey. |
akron_room_capture <start|stop|status|format <png|jpg>|markers <on|off>|startpos <on|off>|autokill <on|off>|autodeafen <on|off>|downscale <on|off>|removebg <on|off>|removefg <on|off>|wait <frames>|horizontal <tiles>|vertical <tiles>> | Drive Room Capture. The overlay Room Capture row is the normal player-facing path. |
akron_map_capture <start|stop|status|format <png|jpg>|markers <on|off>|startpos <on|off>|autokill <on|off>|autodeafen <on|off>|onlymarked <on|off>|downscale <on|off>|removebg <on|off>|removefg <on|off>|wait <frames>|horizontal <tiles>|vertical <tiles>> | Drive Map Capture. The overlay Map Capture row is the normal player-facing path. |
akron_startpos <status|slot <n>|set [n]|load [n]|clear [n]|prev|next|place <on|off>|dashes <n>|stamina <n>|slots <n>|facing <current|left|right>|idle <on|off>|grab <on|off>|label <on|off>|respawn <on|off|toggle|status>|wait <on|off|status>|smart <on|off>> | Full StartPos control. slots <n> accepts 1-50, and selectors expose at least 15 slots. |
akron_slot [n] | Set or show the active Akron savestate slot (1-9). |
akron_save [slot] | Capture the current room into the current or specified numbered Akron savestate slot. This is separate from persistent StartPos slots. |
akron_load [slot] | Restore the current or specified numbered Akron savestate slot. This is separate from persistent StartPos slots. |
akron_save_time_deaths <on|off|status> | Control whether numbered Akron savestate slots restore their captured time and death counters. Persistent StartPos always keeps the newer counters. |
akron_freeze <toggle|on|off|status> | Control gameplay freeze. |
akron_hitboxes <toggle|on|off|status|sync> | Control the hitbox overlay. |
akron_inspector <toggle|on|off|status> | Control the entity inspector. |
akron_timescale [value|reset] | Show or set absolute timescale using invariant-culture parsing (range 0.1-2.0). |
akron_log_level <normal|diagnostic|verbose|trace|status> | Show or set the Akron log level. Changes use the same setting as the Interface Logging popup and are saved immediately. |
akron_proof | Export a proof sidecar JSON file. |
akron_community_packs <status|url <catalog-url>|refresh|category <name>|search <query>|list|import <index>> | Configure and exercise the community .akr catalog. |
Command-only or automation-first
| Command | Scope |
|---|---|
akron_overlay_move, akron_overlay_select, akron_overlay_options, akron_overlay_exec, akron_overlay_search, akron_overlay_state, akron_overlay_collapse | Automation controls for driving the overlay without synthetic input. |
akron_overlay_select_area <auto-kill|auto-deafen> | Start an overlay area-selection flow without synthetic input. |
akron_perf <status|reset|record [label]|stop|gcevents <on|off>> | Developer performance telemetry: overlay/render diagnostics, frame-time and GC attribution, and the JSONL perf record the scripts/akron-perf harness drives. gcevents controls the runtime GC event subscription used while recording. |
akron_feature <name> [on|off|toggle|status] | Low-level wrapper over many toggles. Document the concrete overlay row first. |
akron_qa_*, akron_player_state, akron_input_state | QA state setup and telemetry for live verification. |
akron_qa_messages [count] | Report the most recent Akron messages raised for the player, newest last. count defaults to 5 and must be positive. Output includes qa-messages-raised, qa-messages-reported, and one qa-message line per returned message. |
akron_position <x> <y> | Command-only position setter for controlled map debugging. StartPos and room-warp UI flows are the player-facing paths. |
akron_debug_snapshot [tag] | Diagnostic JSON artifact for bug reports and automation. |
akron_showcase_mark <sync <label>|note <label>|status> | Write hidden synchronization or note markers when showcase marker logging is enabled. |
akron_editable_flag [value] | Console mirror for the Everest Editable Flag Name setting; the flag inspector is developer/map-inspection tooling. |
akron_tas_file [path] | Console mirror for the Everest TAS File Path setting; the overlay can show and play the configured file. |
akron_play_tas | Run the configured TAS handoff action for automation. |
akron_broker_prompt <save|load>, akron_prompt_state, akron_prompt_select | Prompt automation for tests and live verification. |
akron_broker_warnings <on|off|status> | Show or set Speedrun Tool broker warning behavior. |
akron_toggle_force_broker, akron_toggle_unsafe_native_override, akron_toggle_everest_safe_override | Per-map compatibility override commands. Everest’s Akron mod options are the normal manual testing path. |
Extended gameplay commands
| Command | Purpose |
|---|---|
akron_golden_start_helper | Run the golden start helper when the current room is the first room. |
akron_journal_snapshot | Write and compare a journal proof snapshot. |
akron_neutral_drop | Trigger the Neutral Drop shortcut. |
akron_backboost | Trigger the Backboost shortcut. |
akron_core_mode <status|apply|toggle|mode <hot|cold>|click <toggle|cycle>> | Control Core Mode. |
akron_set_inventory <status|apply|dashes <0-5>|jumps <0-99>|restore <on|off>> | Configure and apply player inventory values. |
akron_dash_redirect <disabled|down|down-diagonal|horizontal|up|up-diagonal|diagonal|all|toggle|status> | Control Dash Redirect directions. Individual directions such as up-left also work for automation. |
akron_auto_deafen <on|off|status|hotkey <combo>|hotkey-clear|test|area <x,y,w,h>|area-add <x,y,w,h>|area-clear|show-area <on|off>|restore> | Control Auto Deafen and its configured regions. |
akron_auto_kill <on|off|toggle|status|timer <on|off>|seconds <n>|show-area <on|off>|show-on-death <on|off>> | Control Auto Kill, its timer, and area visibility. |
akron_auto_kill area <x,y,w,h>, area-add <x,y,w,h>, area-select <n>, area-clear-selected, area-clear | Replace, add, select, remove, or clear Auto Kill areas. Area numbers are one-based. |
akron_auto_kill default <condition-action>, default-from-selected | Edit the default condition template copied into newly placed Auto Kill areas, or copy the selected area’s conditions into that template. |
akron_auto_kill speed <on|off>, min-speed <n>, max-speed <n> | Require a total speed range for the selected Auto Kill area. |
akron_auto_kill h-speed <on|off>, min-h-speed <n>, max-h-speed <n> | Require a horizontal speed range for the selected Auto Kill area. |
akron_auto_kill v-speed <on|off>, min-v-speed <n>, max-v-speed <n> | Require a vertical speed range for the selected Auto Kill area. |
akron_auto_kill horizontal <any|left|right|still> | Require a horizontal movement direction for the selected Auto Kill area. |
akron_auto_kill vertical <any|up|down|still> | Require a vertical movement direction for the selected Auto Kill area. |
akron_auto_kill dash-count <on|off>, dashes <n> | Require a current dash count for the selected Auto Kill area. |
akron_auto_kill ground <any|grounded|airborne> | Require a grounded or airborne state for the selected Auto Kill area. |
akron_auto_kill state <on|off>, state-id <n> | Require an internal player state id for the selected Auto Kill area. |
akron_auto_kill invert <on|off> | Trigger the selected Auto Kill area when enabled conditions fail instead of when they pass. |
akron_step_repeat <on|off|status|delay <frames>|interval <frames>|key <key>|reset-key> | Control frozen hold-repeat stepping. |
akron_step_frame | Request one gameplay frame while Akron freeze is active. |
akron_skip_cutscene | Request a cutscene or dialogue skip. |
akron_room_stats_export | Export room stats for the current map. |
Camera and visual commands
| Command | Purpose |
|---|---|
akron_camera_offset <on|off|toggle|status|set <x> <y>|reset> | Control camera offset. |
akron_cursor_zoom <on|off|status|set <percent>|step <percent>|allow-zoom-out <on|off>|reset-on-deactivate <on|off>|mode <hold|toggle>|reset> | Control cursor zoom. |
akron_noclip <on|off|status|speed <n>|float-speed <n>|draw-on-top <on|off>|hide-player <on|off>> | Control fly noclip mode. |
akron_hazard_accuracy <on|off|toggle|status|reset|defaults|invalid-limit <n>|tint <on|off>|tint-mode <entry|touch>|tint-color <hex>|tint-opacity <0-100>|tint-duration <ms>> | Control playable hazard accuracy and its feedback. |
akron_invincibility <on|off|toggle|status|mode <akron|native>|bottomless-rescue <on|off>|crush-collision <on|off>|lava-ice-pushback <on|off>|spike-ground-refills <on|off>|defaults> | Control Invincibility behavior. |
akron_no_freeze_frames <on|off|toggle|status> | Control No Freeze Frames. |
akron_death_particles <on|off|status|shape <preset>|duration <seconds>|color-mode <hair|custom>|primary <hex>|flash <hex>|outline <hex>|custom-shape <64-bits>> | Control Death Particles. |
akron_madeline_colors <on|off|status|no-dash <on|off>|one-dash <on|off>|...> | Control Madeline Colors per dash state. |
akron_visual_noise <particles|trails|glitch|anxiety|distortion|snow|wind-snow|waterfalls|tentacles|playback|heat-distortion> <on|off|toggle|status> | Control visual-noise suppression by channel. |
akron_visual_tuning <status|light <on|off>|light-level <0-100>|bloom <on|off>|bloom-level <0-300>|tint <on|off>|tint-opacity <0-100>|tint-color <hex>> | Control lighting, bloom, and tint presentation. |
akron_frame_bypass <status|fps <on|off>|fps-target <60-480>|tps <on|off>|tps-target <30-480>|...> | Control frame bypass options. |
akron_megahack_public <action> | MegaHack-public compatibility layer for overlay opacity, pause buffering, trail, jump hack, respawn time, and trajectory settings. |
Hitbox and HUD commands
| Command | Purpose |
|---|---|
akron_hitbox_filter <active-only|hide-player|player-hurtbox|hazards|solids|triggers|last-death|death-all> <on|off|status> | Control hitbox display filters. |
akron_hitbox_style <status|reset|trail <on|off>|length <1-240>|...> | Control hitbox visual style. |
akron_hud_labels <on|off|status|preset <name>|select <n>|...> | Control custom HUD labels. |
akron_hud_cheat_indicator <on|off|status|style <text|dot>|...> | Control HUD cheat indicator. |
akron_resource_hud <on|off|status|stamina <on|off>|dash <on|off>|...> | Control resource HUD. |
akron_dash_bar <on|off|status|player <on|off>|hud <on|off>|...> | Control dash bar display. |
akron_dash_count <on|off|status|max <0-5>|room-entry <on|off>|...> | Control dash count tools. |
akron_speed_number <on|off|status|mode <total|horizontal|vertical>|...> | Control Speed Number display. |
akron_air_jumps <on|off|status|infinite <on|off>|extra <n>|dash-verticals <on|off>> | Control Air Jumps. |
akron_ground_refills <on|off|status|dash <on|off>|stamina <on|off>> | Control Ground Refills. |
Input and utility commands
| Command | Purpose |
|---|---|
akron_input_history <on|off|status|length <n>|placement <left|right>|opacity <30-100>|compact <on|off>> | Control input history display. |
akron_control_display <on|off|toggle|status|preset <default|split|compact|keyboard|bar>|reset|...> | Control live input board. |
akron_ips <on|off|status|placement <left|right>|scale <50-250>|opacity <0-100>|total <on|off>|max <on|off>|movement <on|off>|actions <on|off>|menu <on|off>|color <hex>|reset> | Control the inputs-per-second display. |
akron_autosave <on|off|toggle|save|hide-icon-on|hide-icon-off|hide-icon-toggle|status> | Control Autosave behavior. |
akron_deload_spinners <on|off|toggle|status|now|delay <seconds>> | Control spinner deload simulation. |
akron_sound_volume <status|on <key>|off <key>|volume <key> <0-200>> | Control per-SFX volume. |
akron_bypass <status|low-volume <on|off>|volume <music> <sfx>|instant-complete|uncomplete|unlock-a-sides|unlock-b-sides|unlock-c-sides|unlock-all-levels|unlock-golden-berries|unlock-paths|obtain-room-berries|obtain-chapter-berries|berry-options> | Bypass options for testing. |
akron_evm <status|master <on|off>|reset|reset-vanilla|randomizer <on|off>|display <on|off>|list|set <variant> <value>|configure <variant> <value>|toggle <variant>> | Extended Variant Mode control. |
Setup, theme, and settings commands
| Command | Purpose |
|---|---|
akron_setup [export [scope] [name]|import [scope] <file>|import-latest [scope]] | Show, import, or export Akron .akr setup packs. |
akron_theme <status|next|copy-custom|export [name]|import <file>|import-latest> | Manage overlay themes. |
akron_grab_mode <on|off|toggle-enabled|hold|toggle|invert|status> | Show or set Celeste grab mode. |
akron_menu_input <on|off|status> | Control whether Akron consumes menu input while open. |
akron_menu_pause <toggle|on|off|status> | Control whether Akron pauses gameplay while open. |
akron_internal_recorder <start|stop|start-replay|stop-replay|disarm-completion|save-replay|arm-completion|flag-completion|build-clear-video|status> | Internal Recorder control for automation. |
Community pack commands
akron_community_packs status
akron_community_packs url <catalog-url>
akron_community_packs refresh
akron_community_packs category StartPos
akron_community_packs search beginner lobby
akron_community_packs list
akron_community_packs import 0
list prints the currently filtered zero-based entries. import downloads the selected .akr and imports it through the same scoped path as the in-game button.
File-backed automation queue
When DebugRC’s/console endpoint is unreliable, Akron can process a file-backed queue on the game thread.
The queue is disabled by default. Start Celeste/Everest with both variables set:
export AKRON_AUTOMATION_ENABLED=1
export AKRON_AUTOMATION_SESSION_TOKEN='<random-token-with-at-least-32-characters>'
command.txt must repeat it with a token: prefix:
token: <same-session-token>
akron_status
akron_overlay show
| File | Purpose |
|---|---|
Saves/AkronAutomation/command.txt | Session-token header followed by newline-delimited allowlisted commands. |
Saves/AkronAutomation/last-command.txt | Consumed commands without the token header. |
Saves/AkronAutomation/last-result.txt | Plain-text output with pending, complete, rejected, or failed status. |
Verification scenarios
Commands support repeatable live verification scenarios:- Show the overlay before screenshots.
- Drive settings without relying on fragile input.
- Exercise StartPos, freeze, hitbox, inspector, and proof surfaces.
- Refresh and import community packs.
- Capture proof sidecars for comparison.