Option to resize the overlay.

[domdfcoding]

Is there (or could there be added) an option to resize or scale the overlay? My game uses a small viewport (400x300 in an 800x600 window) but the overlay fills the whole screen (and hangs off the left hand side if not the bottom. This is what it looks like:

If the overlay could be scaled down it would be much more useful.

[Calinou]

There isn't such an option yet, but it should be straightforward to multiply all font sizes according to a project setting.

Note that when using the viewport stretch mode, readability would suffer unless you used a font that is specifically designed to be readable at low sizes.

[jamonholmgren]

Note that I have the opposite problem -- it's too small! 😅 Definitely need a resize feature. I'm running on a 5k display on mac.

[Calinou]

Note that I have the opposite problem -- it's too small! 😅 Definitely need a resize feature. I'm running on a 5k display on mac.

Use the canvas_items stretch mode in the project settings, as explained in the Multiple resolutions documentation. This will also handle the rest of your UI scaling automatically.

[smedelyan]

I'm using canvas_items stretch mode + 4k viewport which renders into 1080p window. The size is way too small as well.

[Calinou]

I'm using canvas_items stretch mode + 4k viewport which renders into 1080p window. The size is way too small as well.

You can increase the Stretch Scale project setting since Godot 4.2, although this will affect all 2D elements (including the ones that are unrelated to the debug menu).

[smedelyan]

although this will affect all 2D elements

Yep, I would like to avoid this :-) In fact, at the moment DebugMenu is the only thing in the project that is not scaled up properly.

[radiKal07]

Same issue, all UI is correct except the Debug Menu is too small and it's hard to read

[Calinou]

If you change Default Theme Scale in the Project Settings, it should increase the size of the debug menu text at least.

[radiKal07]

If you change Default Theme Scale in the Project Settings, it should increase the size of the debug menu text at least.

Looks like we want to change the size of the Debug Menu without changing the size of anything else. Looks like there is no way to do it now.

Btw I ended up adding this code in one of my global nodes to scale just the Debug Menu:

    private void ScaleDebugMenu()
    {
        var layer = GetNode<CanvasLayer>("../DebugMenu");
        var menu = GetNode<Control>("../DebugMenu/DebugMenu");

        menu.Scale = new(3, 3);
        layer.Offset = new(-800, 0);
    }

[antzGames]

I have a version of debug menu that lets the F4 key cycle through 4 levels of CanvasLayer scale (0.75, 1, 1.5, 2).

The code is ready in a branch in my fork at: https://github.com/antzGames/godot-debug-menu/tree/Scaling-overlay-support

Open to suggestions, feedback @Calinou and all.

Some ideas to make it better are configurable scaling enum sets (but always have the default scale of 1 included).

[Calinou]

This should be done by changing the font size of all Labels and changing the graphs' size in code instead. Control or CanvasLayer scaling should not be used here. It's more work, but it ensures everything remains crisp.

[antzGames]

I agree for font crispness, this is the way to go, but it is going to be a lot code.

In addition to the font sizes and graph sizes:

• the hard coded font_outline_size also has to be scaled.
• the header widths for the FrameTimeHistory GridContainer node has to be scaled.
• hard coded Graph labels custom_minimum height of 27, which spaces the graphs vertically, has to be scaled.
• the graph size is set in a const and is used everywhere. Do you still want 150 data points in each graph? If we increase the size of the graph GUI by 2x, then the resolution of the polyline will suffer.

[antzGames]

✅OK, its complete.

So I used Groups for labels, header labels, and graph UI elements, and it was not that much code to implement.

Features:
✅ Users can set any font size with DebugMenu.set_font_size(). The font size range is [12-72] . Default is 12pt.
✅ Font size, font outline size, header widths, and graphs are scaled correctly based on font size.
✅ F4 key cycles through 12pt (default), 18pt, 24pt, 30pt, 36pt font sizes and the CUSTOM font size that was set with DebugMenu.set_font_size(). This gives 1x, 1.5x, 2x, 2.5x, 3x scaling without the user needing to use code. This toggle only cycles with F4 if the DebugMenu is visible.

Limitations:

• So the font does not look good at any font size smaller than the default, which is 12pt. My solution is for users who want a bigger overlay.

Code at: https://github.com/antzGames/godot-debug-menu/tree/Scaling-overlay-support

This is a test that sets font size with DebugMenu.set_font_size() between the range of 12 - 48, every 0.25s. Look ok?

2025-11-20.08-42-44.mp4

[Calinou]

This is a test that sets font size with DebugMenu.set_font_size() between the range of 12 - 48, every 0.25s. Look ok?

Looks great 🙂

I think there should also be a project setting to change the size at startup. To me, this is more important than having a key to change the size at runtime, as this will allow using the debug menu in projects with a low fixed viewport resolution (e.g. pixel art style). I think you can keep the runtime toggle key still, as it's useful for projects that use the disabled stretch mode.

I expect most pixel art projects to be using a size between 0.25 and 0.5, with an appropriate pixel art font that is readable at small sizes.