DER AntiCheat v1.8.0 Official Documentation DER AntiCheat v1.8.0 官方文档 Version Information / 版本信息 - Version / 版本: 1.8.0- Godot Version / 适配引擎: 4.6+- Author / 作者: 222- License / 协议: MIT Overview / 概述 English DER AntiCheat v1.8.0 is a Monitoring & Visualization Suite that transforms raw security telemetry into actionable in-game insights and shareable reports. This update delivers four core modules working in tandem: a robust alert logging system ( DERAlertManager ), an in-game statistics dashboard ( DERDashboard ), a multi-format report exporter ( DERReportExporter ), and a real-time chart visualization component ( DERStatsChart ). It provides developers with complete visibility into their game's security posture. 中文 DER AntiCheat v1.8.0 是一套监控与可视化套件,它将原始的安全运行数据转化为直观的游戏内状态和可分享的报告。本次更新包含四个协同工作的核心模块:强大的告警日志系统( DERAlertManager )、游戏内统计仪表盘( DERDashboard )、多格式报告导出工具( DERReportExporter )以及实时图表可视化组件( DERStatsChart )。它为开发者提供了关于游戏安全状态的全维度可视性。 Core Modules & Features / 核心模块与功能 1. DERAlertManager - Alert Logging System / 告警日志系统 English The central hub for all security events. It handles filtering, anti-spam, and multi-channel delivery of alerts. - Multi-Level Alerts: Supports 4 severity levels (INFO, WARNING, HIGH, CRITICAL).- Anti-Deduplication: Prevents spamming with a configurable cooldown ( alert_cooldown ).- Multi-Output: Logs to console, local file, HTTP endpoints, and custom signals.- Log Rotation: Automatically archives old logs when the file size limit ( max_log_size_mb ) is reached.- Statistics Tracking: Maintains an in-memory cache of threat counts for the dashboard. 中文 所有安全事件的中枢枢纽。负责处理过滤、防抖动和多通道告警分发。 - 多级告警:支持 4 个严重等级(信息、警告、高危、严重)。- 防抖动机制:通过可配置的冷却时间( alert_cooldown )防止短时间内重复刷屏。- 多通道输出:同时支持控制台、本地文件、HTTP 接口和自定义信号。- 日志轮转:当日志文件达到大小上限( max_log_size_mb )时,自动归档备份。- 统计追踪:维护内存中的各类威胁计数缓存,供仪表盘实时读取。 2. DERDashboard - In-Game Health Dashboard / 游戏内健康面板 English A UI control for real-time display of the game's security health. - Health Score Calculation: Computes a dynamic score (0-100) based on threat severity (Critical * 15 + High * 5 + Warning * 1).- Threat Overview: Displays real-time counts for Total, Critical, High, Warning, and Info events.- Historical Trend: Keeps a short history of stats to visualize threat patterns.- Custom Drawing: Renders threat trend lines directly via _draw() function without external libraries. 中文 用于实时展示游戏安全健康状态的 UI 控件。 - 健康评分算法:根据威胁严重程度动态计算 0-100 分的健康分(严重 *15 + 高危 *5 + 警告 *1)。- 威胁概览:实时显示总数、严重、高危、警告和信息事件的计数。- 历史趋势:维护短时间的统计队列,用于可视化威胁变化模式。- 自定义绘制:直接通过 _draw() 函数绘制威胁趋势线,无需依赖外部库。 3. DERReportExporter - HTML/JSON/CSV Report Exporter / 报告导出工具 English Generates professional, shareable reports from collected security data. - HTML Security Report: Exports a standalone HTML file with embedded CSS and Chart.js. Features include a health score badge, threat statistics cards, and an interactive threat trend chart.- Multi-Format Support: Exports to JSON (data archiving) and CSV (spreadsheet compatibility) as well.- Auto-Export: Automatically generates backups at a set interval ( enable_auto_export ).- Data Adaption: Flexibly reads statistics from various data sources (Dashboard/Alert Manager). 中文 将收集的安全数据生成专业、可分享的报告。 - HTML 安全报告:导出包含内嵌 CSS 和 Chart.js 的独立 HTML 文件。特色功能包括健康评分徽章、威胁统计卡片和交互式威胁趋势图表。- 多格式支持:同时支持导出 JSON(数据存档)和 CSV(表格兼容)。- 自动导出:支持定时自动生成备份( enable_auto_export )。- 数据适配:灵活读取不同数据源(仪表盘/告警管理器)的统计数据。 4. DERStatsChart - In-Game Visualization / 游戏内图表组件 English A reusable UI control for rendering statistical charts within the game. - Chart Types: Supports Line, Bar, and Pie chart rendering.- Data Binding: Automatically fetches and displays stats from the linked DERDashboard .- Animation Effects: Supports smooth load animations for data presentation.- Customization: Configurable title, grid lines, legend, and color scheme. 中文 可复用的 UI 控件,用于在游戏内绘制统计图表。 - 图表类型:支持折线图、柱状图和饼图三种渲染模式。- 数据绑定:自动从关联的 DERDashboard 读取并展示统计数据。- 动画效果:支持数据加载时的平滑过渡动画。- 自定义配置:可配置标题、网格线、图例和配色方案。 Key Features in v1.8.0 / v1.8.0 核心亮点功能 HTML Security Report Generator / HTML 安全报告生成器 - Visual Security Grade: Generates a visual HTML report showing a live Health Score (0-100) with color coding (Green = Excellent, Red = Critical).- Interactive Charts: Embeds Chart.js to display threat trends directly in the browser.- Professional UI: Includes styled statistic cards and a detailed alert log table.- One-Click Export: Simple API to generate a shareable document of the current security status. 结构化调试日记 / Structured Debug Journal - Time-Stamped Events: Every alert is recorded with a precise system timestamp.- Structured Logs: Exports machine-readable JSON format for easy post-processing and analysis.- File Rotation: Prevents log bloat with automatic archiving based on file size. 游戏内实时监控 / In-Game Real-Time Monitoring - Health Status: Players/QA can view the current security health without external tools.- Threat Count: Instant visibility of how many threats have been detected.- Visual Trends: In-game line charts showing the historical rate of threat occurrences. Technical Implementation / 技术实现 English - Signal-Driven Architecture: Modules communicate via Godot Signals and Callables for loose coupling and high performance.- Class-Based Singletons: All scripts use class_name for easy global access and type safety.- File I/O Optimization: Implements size limits and proper error handling for file operations to prevent memory leaks.- Custom Drawing: Utilizes Godot's _draw() function for direct UI rendering, avoiding overhead from external UI frameworks. 中文 - 信号驱动架构:各模块通过 Godot 信号(Signals)和回调(Callable)进行通信,实现低耦合和高性能。- 类单例模式:所有脚本均使用 class_name 定义,方便全局访问且保证类型安全。- 文件 I/O 优化:实现了文件大小限制和完善的错误处理,防止日志文件过大导致性能问题或内存泄漏。- 自定义绘制:利用 Godot 的 _draw() 函数进行直接 UI 渲染,避免依赖外部 UI 框架带来的额外开销。 Changelog / 更新日志 English - v1.8.0: Initial release of the Monitoring Suite. Added DERAlertManager , DERDashboard , DERReportExporter , and DERStatsChart .- v1.7.0: Added full SL Protection suite (Rollback, Save Limit, Cloud Validator). 中文 - v1.8.0:监控套件首发。新增 DERAlertManager 、 DERDashboard 、 DERReportExporter 和 DERStatsChart 四大核心模块。- v1.7.0:新增完整的 SL 防护套件(回滚检测、保存限制、云存档验证)。 Final Notes / 最终说明 This update represents a significant milestone for the DER AntiCheat project, moving beyond simple detection to provide complete operational visibility. The combination of real-time in-game monitoring and shareable HTML reports makes it easier than ever for developers to audit security posture and debug potential vulnerabilities. 本次更新标志着 DER AntiCheat 项目的一个重要里程碑,从单纯的检测功能升级为完整的运营监控体系。结合实时游戏内监控与可分享的 HTML 报告,开发者能更轻松地审计安全状态并排查潜在漏洞