Skip to content
Snip edited this page Dec 18, 2024 · 5 revisions

Debug Map

The Debug Map is a vanilla leftover from the game's development, which gives you an overview of an entire map file from inside Celeste, among other goodies like teleporting to any room or location.

Setup

The Debug Map is accessible by enabling Debug Mode.

In vanilla, Debug Mode was only accessible by editing the settings.celeste file.
However, Everest lets you change when Debug Mode is enabled from its Mod Options section:

  • OFF: disables Debug Mode entirely
  • EVEREST: enables Debug Mode only in Everest
  • ALWAYS: enables Debug Mode in Everest and vanilla Celeste

After enabling Debug Mode, a restart may be necessary.

Debug Mode in Everest Mod Options, which is set to Everest

Then, to open the Debug Map, press your Debug Map keybinding while inside a map. In vanilla, this would've been hardcoded to Tab.
However, Everest removes this limitation and allows you to rebind the key to anything you want. It is F6 by default.

Usage

After opening the Debug Map, you will see an overview of the room. Pictured here is Forsaken City A-Side.

Forsaken City in Debug Map

In this mode, you can use your mouse cursor. To change the zoom, use the scroll wheel.
To pan the camera around, you can:

  • Use your movement keys.
  • Hold Space, then left-click and drag your mouse around.
  • Click the middle mouse button, and drag your mouse around.

On controller, you can also zoom in/out using the right thumbstick.

Everest explains several keybindings in the bottom right corner.
Additionally, you can press Ctrl+Space to center the camera around (0, 0). Additionally, that will reset the zoom to 6x.

Tip

Position (0, 0) is often called the map's origin. It can be found at the point at which the dark blue axes cross.

Each rectangle is a singular room. You can select rooms by left-clicking them.

They can be one of several colors:

  1. #FFFFFF - White
  2. #F6735E - Red
  3. #85F65E - Green
  4. #37D7E3 - Cyan
  5. #376BE3 - Blue
  6. #C337E3 - Purple
  7. #E33773 - Magenta

If a room has an inner cyan border, that means that it is located at the origin.
Vanilla considers those rooms as starting rooms. This is where the game will attempt to place you when entering the map (excluding checkpoints).

Note

Gray rooms are filler rooms. Filler rooms do not have a spawn point, and cannot be entered.
Filler rooms are commonly used near transitions to fill in the otherwise empty space, as seen in the screenshot below.
Here, the debug map has been overlaid on top of the actual gameplay.

Transition between room 1 and 2 with Debug Map overlaid on it

Highlighted Entities

Yellow rectangles indicate jump-throughs. Spawn points are marked as red dots.
When right-clicking a room, the game will spawn you at the spawn point closest to your cursor position.
To spawn at the exact location of your cursor, hold Shift while teleporting.

Pink circles show the location of red strawberries. Holding Q shows their ID.
The ID consists of the checkpoint number and the strawberry order, separated by a colon (:).
Together, they determine which strawberry is which when looking at the Pause menu.

Gold circles show keys. Holding F1 shows their order number, though that doesn't serve much purpose.

Green circles show checkpoint entities.

Heading Text

The heading on the top shows the current map name in the top left corner, and the current mode in the top right corner.
Modes can be Normal, BSide or CSide.

If you have one or more rooms selected, then instead of the above, the amount of selected rooms can be seen in the top left corner.

If you are hovering over a room, its name will be shown in the top left corner.
Additionally its dimensions, position and position × 8 will be shown in the top right corner. Room positions are counted from their top left corner.

If more than one room is being hovered, the text in the top left corner will show how many rooms are being hovered.

Editing

The Debug Map also comes with functionality to edit maps.
However, changes will not be saved, as the contents of the Save and SaveAndReload methods has been removed.

You can move rooms by clicking and dragging them around. Hold Ctrl while clicking to select multiple rooms.
The room you're moving will snap to nearby rooms, unless Left Alt is held.
If two rooms are overlapping, they will blink red.

You can also make a selection by clicking the cursor on empty space and dragging around.
Holding Ctrl while doing so toggles whether the room is selected or not.

Holding F allows you to add or remove filler rooms, by left-clicking or right-clicking respectively.
Filler rooms can be resized by clicking and dragging the orange rectangle.

You can recolor rooms by selecting them and pressing the numbers on the number row (not number pad).
See the list above for the available colors.

Ctrl+A selects all rooms.
Ctrl+Z undoes the previous action.
Ctrl+Y would've redone the previous action, but due to a bug, it crashes the game.

Finally, pressing F1 or Ctrl+S would've saved the changes to disk, but for reasons mentioned earlier, it does nothing instead.

Clone this wiki locally