DebugConsole
實時外部控制台用於查看日誌，日誌按級別着色並自動保存日誌文件。
截圖 共 1 張
模組介紹 作者原文
實時外部控制台用於查看日誌，日誌按級別着色並自動保存日誌文件。
DebugConsole 🎮
遊戲啓動時自動彈出一個獨立的控制台窗口，實時顯示所有日誌輸出。
---
✨ 功能特性
- **實時日誌窗口**：遊戲啓動時自動彈出 Windows 控制台，實時滾動顯示日誌。
- **全量日誌捕獲**：捕獲遊戲 Logger 系統和 Godot 引擎的所有輸出。
- **顏色區分級別**：Error 紅色、Warn 黃色、Info 白色、Debug 灰色、引擎輸出青色。
- **日誌文件持久化**：自動保存當前會話和上一次會話的日誌，崩潰後也能查看。
- **告別翻文件**：再也不用手動打開 log 文件的痛苦了！
---
📦 安裝指南
- 將 **DebugConsole.dll** 和 **DebugConsole.json** 複製到遊戲目錄下的 **mods** 文件夾：
```
Slay the Spire 2/
└── mods/
├── DebugConsole.dll
└── DebugConsole.json
```
- 啓動遊戲，控制台窗口會自動彈出。
---
📁 日誌文件
日誌保存在遊戲用戶數據目錄的 logs 文件夾下：
```
%AppData%/SlayTheSpire2/logs/
├── DebugConsole.log # 當前運行日誌
└── DebugConsole-prev.log # 上一次運行日誌
```
---
⚙️ 技術實現
- 通過 Win32 AllocConsole 創建外部控制台窗口。
- 訂閱遊戲全局 Log.LogCallback 事件以捕獲 Logger 日誌。
- 通過管道攔截進程 stdout 以捕獲 Godot 引擎輸出，並自動去重。
- **僅限 Windows 平臺**。
---
🙏 致謝
本項目基於 Alchyr/ModTemplate-StS2 模板創建。
安裝與使用 安裝：按包內說明操作
- 解壓本站下載的壓縮包，先讀包內的 readme / 說明檔案。
- 這類遊戲沒有通用的模組管理器：有的模組直接替換遊戲檔案、有的放進遊戲專屬的 Mods 資料夾、有的要先裝遊戲對應的社群載入器或工具，以包內說明為準。
- 嚴格按說明放置檔案；標註「前置依賴」的模組需要把依賴一併裝好。
- 啟動遊戲確認載入成功；部分遊戲需要在設定或模組選單裡手動啟用。
不同遊戲、不同模組的安裝位置差異很大，包內說明是最可靠的依據。