Settings

Verified against the spelunky.ai port v0.1.10 on 28 October 2026.

The settings program is a second program beside the game, with a window of check boxes and sliders, and screens that ask for keys and gamepad buttons. It writes three files, settings.cfg, keys.cfg and gamepad.cfg, and the game reads them once, as it starts ^[1]; nothing in the game changes them. Without the files the game has defaults of its own ^[2], but the released game ships all three: a window three times the game's size, high detail, running on down off, the gamepad on, both volumes at 15, and the keys on the Controls page.

The program's window lists, from the top ^[3]:

• RESOLUTION: X1 to X4, the window's size in multiples of the game's 320 by 240 pixels.
• GRAPHICS: FULLSCREEN and HIGH DETAIL.
• CONTROLS: DOWN KEY TO RUN and USE GAMEPAD, with the KEY CONFIG and JOY CONFIG buttons.
• SOUND/MUSIC VOLUME: a slider each for the music (MUS) and the sound effects (SFX). Dragging the music's plays the cave music at the volume it's at ^[3], and the sound's plays the jump sound every 20 steps ^[4].
• START GAME ON EXIT, checked at first.

Each box is a click on or off. OK saves the settings and quits, starting the game if START GAME ON EXIT is checked ^[3]. Escape and the window's close button save and quit ^[5]; EXIT quits without saving ^[4], and so does Enter ^[6].

KEY CONFIG saves the settings, then names each action in turn, with its key under CURRENT: UP, DOWN, LEFT, RIGHT, JUMP, ACTION, SWITCH, RUN, BOMB, ROPE and PURCHASE. A key press binds the action shown and Escape keeps its key; after the last, the program writes keys.cfg and goes back to its window. It never asks for the flare key, which keeps what the file had ^{[7] [6]}. Each key press counts twice, so one press binds two actions in a row (Escape keeps two): six presses bind all eleven ^[8]. JOY CONFIG does the same for the gamepad's buttons (JUMP, ACTION, SWITCH, RUN, BOMB, ROPE, PURCHASE and START) and gamepad.cfg; with no gamepad, it says NO GAMEPAD FOUND! and only Escape moves it on ^[4].

The game reads settings.cfg a line a setting ^[9]:

The defaults are the game's own, for a game directory without the file ^[20]. Each volume is 0 to 17 in the game, a higher one read as 17 ^[21]. keys.cfg holds a key for each of the twelve actions and gamepad.cfg a button for nine, in the order the game reads them ^[22], and a replay with keys of its own plays on them ^[23].

A volume is turned into the sound library's units as 2000 + 8000 × the volume ÷ 18 ^[26].

• Clicking every box, setting X1 and dragging the music to 7, then OK, saves 1 0 1 0 1 7 15 ^[3].
• A sound volume of 30 is read as 19, and Escape saves it so ^[5].
• KEY CONFIG with W, Escape, Space, E, Q and P binds up and down to W, keeps left and right, and binds jump and attack to Space, item and run to E, bomb and rope to Q, and pay to P ^[7].

• The settings program never reads DOWN KEY TO RUN. It starts the setting off and its reading of the file can only turn it off, so the box always comes up unchecked, and saving writes it off again. The game reads it as it should, starting it on ^{[27] [28]}. A replay opens the program on a file with the setting on, and Escape saves it off ^{[29] [6]}.
• The volumes' top notches. The program's sliders go up to 19 and the game reads at most 17, so 17, 18 and 19 are the same in the game ^{[21] [4] [6]}.
• Enter quits without saving, where Escape saves first, and the flare key is never asked for ^[6].
• The game has the key screens too. The game's own files have a copy of the program's key and gamepad screens, which nothing in the game reaches ^{[30] [6]}.