跳转至

显示配置与生命周期

可选显示配置:

console.toggle_key = KEY_F2
console.max_output_lines = 500
console.max_history_size = 100

console.windowed = true
console.background_alpha = 0.8
console.initial_window_size_ratio = Vector2(0.7, 0.55)
console.minimum_window_size = Vector2(420, 260)
console.keep_topmost = true

windowed = false 是兼容默认值,适合只在需要时全屏覆盖查看日志。

windowed = true 更适合边运行边观察状态或执行调试命令;拖拽区域位于标题文本,右下角手柄用于缩放。

debug_only = true 会在非 debug 构建中跳过 GUI 创建,适合把控制台注册代码留在通用启动流程里,但仍由项目发布策略决定是否注册调试命令。

控制台 GUI 在 dispose() 时会立即脱离场景树,并断开日志信号,避免关闭架构后同一帧仍留下调试输入层。