Files
Bullosseum/debug_menu.gd
T

468 lines
15 KiB
GDScript

extends Node
## Quake-style drop-down debug console. Toggle with ~ (Shift+`).
## Query a param: type its name. Set it: "name value".
## Tab = complete top match · ↑↓ = browse suggestions / history · Esc = close.
const CONSOLE_HEIGHT_RATIO := 0.48
const SLIDE_DURATION := 0.18
const MAX_SUGGESTIONS := 10
const LOG_MAX_LINES := 300
var _canvas: CanvasLayer
var _panel: PanelContainer
var _log: RichTextLabel
var _suggest_panel: PanelContainer
var _suggest_box: VBoxContainer
var _suggest_labels: Array[Label] = []
var _input_field: LineEdit
var _tween: Tween
var _is_open: bool = false
var _prev_mouse: Input.MouseMode = Input.MOUSE_MODE_CAPTURED
var _suggestions: Array[String] = []
var _selected_idx: int = -1
var _history: Array[String] = []
var _history_idx: int = -1
func _ready() -> void:
_build_ui()
func _build_ui() -> void:
_canvas = CanvasLayer.new()
_canvas.layer = 128
add_child(_canvas)
_panel = PanelContainer.new()
_panel.anchor_left = 0.0
_panel.anchor_right = 1.0
_panel.anchor_top = 0.0
_panel.anchor_bottom = 0.0
_panel.offset_bottom = 500.0
_panel.mouse_filter = Control.MOUSE_FILTER_STOP
_panel.visible = false
var bg := StyleBoxFlat.new()
bg.bg_color = Color(0.04, 0.06, 0.04, 0.94)
bg.border_width_bottom = 2
bg.border_color = Color(0.2, 0.8, 0.2, 1.0)
_panel.add_theme_stylebox_override("panel", bg)
_canvas.add_child(_panel)
var root_vbox := VBoxContainer.new()
root_vbox.size_flags_horizontal = Control.SIZE_FILL
root_vbox.size_flags_vertical = Control.SIZE_FILL
_panel.add_child(root_vbox)
# ── Header ────────────────────────────────────────────────────────────────
var header_margin := MarginContainer.new()
header_margin.add_theme_constant_override("margin_left", 10)
header_margin.add_theme_constant_override("margin_top", 4)
header_margin.add_theme_constant_override("margin_bottom", 2)
root_vbox.add_child(header_margin)
var header_lbl := Label.new()
header_lbl.text = "BULLOSSEUM CONSOLE [~ close · Tab complete · ↑↓ browse]"
header_lbl.modulate = Color(0.35, 0.9, 0.35, 0.60)
header_margin.add_child(header_lbl)
root_vbox.add_child(HSeparator.new())
# ── Log ───────────────────────────────────────────────────────────────────
_log = RichTextLabel.new()
_log.bbcode_enabled = true
_log.scroll_following = true
_log.size_flags_vertical = Control.SIZE_EXPAND_FILL
_log.size_flags_horizontal = Control.SIZE_FILL
_log.add_theme_font_size_override("normal_font_size", 13)
_log.add_theme_constant_override("line_separation", 1)
root_vbox.add_child(_log)
# ── Suggestion panel ──────────────────────────────────────────────────────
_suggest_panel = PanelContainer.new()
_suggest_panel.visible = false
_suggest_panel.mouse_filter = Control.MOUSE_FILTER_IGNORE
var sg_bg := StyleBoxFlat.new()
sg_bg.bg_color = Color(0.06, 0.10, 0.06, 0.97)
sg_bg.border_width_top = 1
sg_bg.border_color = Color(0.15, 0.55, 0.15, 0.8)
_suggest_panel.add_theme_stylebox_override("panel", sg_bg)
root_vbox.add_child(_suggest_panel)
_suggest_box = VBoxContainer.new()
_suggest_box.add_theme_constant_override("separation", 0)
_suggest_panel.add_child(_suggest_box)
for _i in MAX_SUGGESTIONS:
var lbl := Label.new()
lbl.visible = false
lbl.add_theme_font_size_override("font_size", 13)
_suggest_box.add_child(lbl)
_suggest_labels.append(lbl)
root_vbox.add_child(HSeparator.new())
# ── Input row ─────────────────────────────────────────────────────────────
var in_margin := MarginContainer.new()
in_margin.add_theme_constant_override("margin_left", 10)
in_margin.add_theme_constant_override("margin_right", 10)
in_margin.add_theme_constant_override("margin_top", 4)
in_margin.add_theme_constant_override("margin_bottom", 6)
root_vbox.add_child(in_margin)
var in_row := HBoxContainer.new()
in_row.add_theme_constant_override("separation", 6)
in_margin.add_child(in_row)
var prompt_lbl := Label.new()
prompt_lbl.text = ">"
prompt_lbl.modulate = Color(0.35, 1.0, 0.35)
in_row.add_child(prompt_lbl)
_input_field = LineEdit.new()
_input_field.size_flags_horizontal = Control.SIZE_EXPAND_FILL
_input_field.placeholder_text = "param_name | param_name value | save / reset / list / help"
_input_field.clear_button_enabled = true
_input_field.add_theme_font_size_override("font_size", 14)
in_row.add_child(_input_field)
_input_field.text_changed.connect(_on_text_changed)
_input_field.text_submitted.connect(_on_submitted)
_log_raw("[color=#55bb55]Bullosseum Debug Console[/color] [color=#444444]─ Tab=complete ↑↓=browse ~=close[/color]")
_log_raw("[color=#444444]Commands:[/color] [b]save reset list [section] help[/b]")
_log_raw("")
# ── Input handling ────────────────────────────────────────────────────────────
func _input(event: InputEvent) -> void:
if not (event is InputEventKey and (event as InputEventKey).pressed
and not (event as InputEventKey).echo):
return
var ke := event as InputEventKey
# ~ (Shift+backtick) — toggle regardless of focus
if ke.keycode == KEY_QUOTELEFT and ke.shift_pressed:
_toggle()
get_viewport().set_input_as_handled()
return
if not _is_open:
return
match ke.keycode:
KEY_TAB:
_do_autocomplete()
get_viewport().set_input_as_handled()
KEY_UP:
_navigate(-1)
get_viewport().set_input_as_handled()
KEY_DOWN:
_navigate(1)
get_viewport().set_input_as_handled()
KEY_ESCAPE:
_toggle()
get_viewport().set_input_as_handled()
func _toggle() -> void:
_is_open = not _is_open
var h := get_viewport().get_visible_rect().size.y * CONSOLE_HEIGHT_RATIO
_panel.offset_bottom = h
if _tween:
_tween.kill()
_tween = create_tween().set_ease(Tween.EASE_OUT).set_trans(Tween.TRANS_QUART)
if _is_open:
_prev_mouse = Input.mouse_mode
Input.mouse_mode = Input.MOUSE_MODE_VISIBLE
_panel.position.y = -h
_panel.visible = true
_tween.tween_property(_panel, "position:y", 0.0, SLIDE_DURATION)
_tween.tween_callback(_input_field.grab_focus)
else:
_tween.tween_property(_panel, "position:y", -h, SLIDE_DURATION)
_tween.tween_callback(func() -> void: _panel.visible = false)
Input.mouse_mode = _prev_mouse
_clear_suggestions()
# ── Fuzzy autocomplete ────────────────────────────────────────────────────────
func _on_text_changed(text: String) -> void:
_selected_idx = -1
_history_idx = -1
var query := text.get_slice(" ", 0).strip_edges()
if query.is_empty():
_clear_suggestions()
return
_refresh_suggestions(query)
func _refresh_suggestions(query: String) -> void:
var ql := query.to_lower()
var scored : Array = []
for key: String in DP.get_all():
var s := _fuzzy_score(ql, key.to_lower())
if s > 0:
scored.append([s, key])
scored.sort_custom(func(a: Array, b: Array) -> bool: return a[0] > b[0])
_suggestions.clear()
for i in mini(scored.size(), MAX_SUGGESTIONS):
_suggestions.append(scored[i][1])
for i in MAX_SUGGESTIONS:
if i < _suggestions.size():
var key : String = _suggestions[i]
var meta: Dictionary = DP.get_all()[key]
_suggest_labels[i].text = " %s %s [%s]" % [
key.rpad(28), _fmt_val(key, meta).rpad(8), meta["section"]
]
_suggest_labels[i].modulate = _suggestion_color(i)
_suggest_labels[i].visible = true
else:
_suggest_labels[i].visible = false
_suggest_panel.visible = not _suggestions.is_empty()
func _suggestion_color(idx: int) -> Color:
if idx == _selected_idx:
return Color(1.0, 1.0, 0.4) # selected — yellow
if idx == 0:
return Color(0.85, 1.0, 0.70) # top match — bright green
return Color(0.60, 0.78, 0.50) # rest — muted green
func _fuzzy_score(query: String, target: String) -> int:
var qi := 0
var score := 0
var last := -1
for ti in target.length():
if qi >= query.length():
break
if target[ti] == query[qi]:
score += 10 + (5 if ti == last + 1 else 0)
last = ti
qi += 1
if qi < query.length():
return 0 # not all query chars matched
if target.begins_with(query):
score += 50
if target == query:
score += 100
return score
func _fmt_val(_key: String, meta: Dictionary) -> String:
if meta["type"] == TYPE_FLOAT:
return "%.4g" % (meta["value"] as float)
if meta["type"] == TYPE_BOOL:
var bval: bool = meta["value"]
return "true" if bval else "false"
return str(meta["value"])
func _clear_suggestions() -> void:
_suggestions.clear()
_selected_idx = -1
for lbl in _suggest_labels:
lbl.visible = false
_suggest_panel.visible = false
func _do_autocomplete() -> void:
if _suggestions.is_empty():
return
var idx := maxi(0, _selected_idx)
var key := _suggestions[idx]
var meta: Dictionary = DP.get_all()[key]
# Fill "key current_value" so the user just edits the number
_input_field.text = "%s %s" % [key, _fmt_val(key, meta)]
_input_field.caret_column = _input_field.text.length()
_clear_suggestions()
func _navigate(dir: int) -> void:
if _suggestions.is_empty():
# History navigation when no suggestion list is visible
if dir == -1 and _history_idx + 1 < _history.size():
_history_idx += 1
elif dir == 1 and _history_idx > 0:
_history_idx -= 1
elif dir == 1 and _history_idx == 0:
_history_idx = -1
_input_field.clear()
return
else:
return
if _history_idx >= 0:
_input_field.text = _history[_history_idx]
_input_field.caret_column = _input_field.text.length()
return
# Cycle through suggestion list
if _selected_idx < 0:
_selected_idx = 0 if dir == 1 else _suggestions.size() - 1
else:
_selected_idx = wrapi(_selected_idx + dir, 0, _suggestions.size())
for i in MAX_SUGGESTIONS:
if _suggest_labels[i].visible:
_suggest_labels[i].modulate = _suggestion_color(i)
var key := _suggestions[_selected_idx]
var meta: Dictionary = DP.get_all()[key]
_input_field.text = "%s %s" % [key, _fmt_val(key, meta)]
_input_field.caret_column = _input_field.text.length()
# ── Command execution ─────────────────────────────────────────────────────────
func _on_submitted(raw: String) -> void:
raw = raw.strip_edges()
if raw.is_empty():
return
_history.push_front(raw)
_history_idx = -1
_input_field.clear()
_clear_suggestions()
_execute(raw)
func _execute(cmd: String) -> void:
_log_raw("[color=#3a5a3a]> %s[/color]" % cmd)
var parts := cmd.split(" ", false)
if parts.is_empty():
return
match parts[0].to_lower():
"save":
DP.save()
_log_ok("Saved.")
return
"reset":
DP.reset_all()
_log_ok("All params reset to defaults.")
return
"list":
_cmd_list(parts)
return
"help":
_log_raw("[color=#888888] save[/color] — persist values to disk")
_log_raw("[color=#888888] reset[/color] — restore all defaults")
_log_raw("[color=#888888] list [section][/color] — print params (optional section filter)")
_log_raw("[color=#888888] <name>[/color] — read current value + range")
_log_raw("[color=#888888] <name> <value>[/color] — set param (bool: true/false/1/0)")
return
# Treat as param key, with fuzzy fall-back for partial names
var key := parts[0]
var all := DP.get_all()
if not all.has(key):
var matches := _fuzzy_find_all(key)
if matches.size() == 1:
key = matches[0]
_log_raw("[color=#8888ff]→ %s[/color]" % key)
else:
if matches.size() > 1:
_log_warn("Ambiguous '%s': %s" % [parts[0], ", ".join(matches.slice(0, 6))])
else:
_log_warn("Unknown: %s" % parts[0])
return
var meta: Dictionary = all[key]
if parts.size() == 1:
_read_param(key, meta)
else:
_set_param(key, meta, parts[1])
func _read_param(key: String, meta: Dictionary) -> void:
if meta["type"] == TYPE_FLOAT:
_log_raw(
"[b]%s[/b] = [color=#ffe080]%s[/color] [color=#484848](min %s max %s step %s default %s)[/color]" % [
key, _fmt_val(key, meta),
"%.4g" % (meta["min"] as float),
"%.4g" % (meta["max"] as float),
"%.4g" % (meta["step"] as float),
"%.4g" % (meta["default"] as float),
]
)
else:
_log_raw("[b]%s[/b] = [color=#ffe080]%s[/color]" % [key, _fmt_val(key, meta)])
func _set_param(key: String, meta: Dictionary, raw: String) -> void:
if meta["type"] == TYPE_FLOAT:
if not raw.is_valid_float():
_log_warn("Expected number, got: %s" % raw)
return
var v := snappedf(
clampf(raw.to_float(), meta["min"] as float, meta["max"] as float),
meta["step"] as float
)
DP.set_value(key, v)
_log_ok("[b]%s[/b] ← [color=#ffe080]%.4g[/color]" % [key, v])
elif meta["type"] == TYPE_BOOL:
match raw.to_lower():
"1", "true", "yes", "on":
DP.set_value(key, true)
_log_ok("[b]%s[/b] ← [color=#ffe080]true[/color]" % key)
"0", "false", "no", "off":
DP.set_value(key, false)
_log_ok("[b]%s[/b] ← [color=#ffe080]false[/color]" % key)
_:
_log_warn("Expected true/false, got: %s" % raw)
else:
_log_warn("Cannot set param of type %d" % meta["type"])
func _cmd_list(parts: PackedStringArray) -> void:
var filter := parts[1].to_lower() if parts.size() > 1 else ""
var all := DP.get_all()
var sections: Dictionary = {}
for key: String in all:
var sec: String = all[key]["section"]
if filter.length() > 0:
if not sec.to_lower().begins_with(filter) and not key.to_lower().contains(filter):
continue
if not sections.has(sec):
sections[sec] = []
sections[sec].append(key)
for sec: String in sections:
_log_raw("[color=#6699ff][b]%s[/b][/color]" % sec)
for key: String in sections[sec]:
_log_raw(" [color=#777777]%s[/color] = [color=#ffe080]%s[/color]" % [
key, _fmt_val(key, all[key])
])
func _fuzzy_find_all(query: String) -> Array[String]:
var result: Array[String] = []
var ql := query.to_lower()
for key: String in DP.get_all():
if _fuzzy_score(ql, key.to_lower()) > 0:
result.append(key)
return result
# ── Logging ───────────────────────────────────────────────────────────────────
func _log_raw(text: String) -> void:
if _log.get_line_count() > LOG_MAX_LINES:
_log.clear()
_log.append_text(text + "\n")
func _log_ok(text: String) -> void:
_log_raw("[color=#66ee88]%s[/color]" % text)
func _log_warn(text: String) -> void:
_log_raw("[color=#ff7744]%s[/color]" % text)