Skip to content

COMMAND_LIST.md

Latest commit

 

History

History
178 lines (147 loc) · 5.18 KB

COMMAND_LIST.md

File metadata and controls

178 lines (147 loc) · 5.18 KB
Raw

MCP Debug Mod - 完整功能清单

📋 所有可用命令 / All Available Commands

🎮 游戏控制 / Game Control

命令 描述 状态
mc_pause 暂停游戏循环 ✅ 已修复
mc_resume 恢复游戏循环 ✅ 工作
mc_toggle 切换暂停/恢复 ✅ 工作
mc_status 获取当前状态 ✅ 工作

📝 日志系统 / Log System (NEW!)

命令 描述 状态
mc_get_logs 获取所有日志（WARN+ERROR+FATAL） ✅ 新功能
mc_get_warns 仅获取 WARN 级别日志 ✅ 新功能
mc_get_errors 仅获取 ERROR 级别日志 ✅ 新功能
mc_get_fatals 仅获取 FATAL 级别日志 ✅ 新功能
mc_get_logs_by_level 按级别查询（参数：level） ✅ 新功能
mc_clear_logs 清除日志缓存（可选参数：level） ✅ 新功能
mc_get_log_stats 获取日志统计信息 ✅ 新功能

🔍 调试工具 / Debug Tools

命令 描述 状态
mc_get_stack 主线程堆栈跟踪（已反混淆） ✅ 工作
mc_get_all_stacks 所有线程堆栈跟踪 ✅ 工作

📊 性能监控 / Performance

命令 描述 状态
mc_get_performance FPS、MSPT、内存使用 ✅ 工作
mc_get_memory 详细内存统计 ✅ 工作

🌍 世界检查 / World Inspection

命令 描述 状态
mc_get_entities 实体列表 ✅ 工作
mc_inspect_entity 检查特定实体（参数：entityId） ✅ 工作
mc_get_player 玩家信息 ✅ 工作
mc_get_chunks 加载的区块数量 ✅ 工作

🎨 OpenGL 调试 / OpenGL Debug

命令 描述 状态
mc_get_gl_info OpenGL 厂商、渲染器、版本 ✅ 工作
mc_get_gl_state 当前 GL 状态标志 ✅ 工作
mc_get_gl_errors OpenGL 错误队列 ✅ 工作

🔬 反射工具 / Reflection Tools

命令 描述 状态
mc_get_class_info 类信息（参数：className） ✅ 工作
mc_get_srg_status SRG 映射器状态 ✅ 工作

⚙️ 系统管理 / System

命令 描述 状态
mc_reload_config 重新加载配置文件 ✅ 工作

📈 统计信息 / Statistics

命令总数

  • 总计: 27 个命令
  • 新增: 7 个日志命令
  • 修复: 1 个（暂停功能）

功能覆盖

  • ✅ 游戏控制: 4 个命令
  • ✅ 日志系统: 7 个命令（新！）
  • ✅ 调试工具: 2 个命令
  • ✅ 性能监控: 2 个命令
  • ✅ 世界检查: 4 个命令
  • ✅ OpenGL: 3 个命令
  • ✅ 反射: 2 个命令
  • ✅ 系统: 1 个命令

代码统计

  • Java 文件: 13 个
  • 总代码行数: ~1,700 行
  • 新增代码: ~300 行（日志系统）

🎯 使用场景 / Use Cases

1. 调试崩溃

1. mc_get_fatals     # 查看致命错误
2. mc_get_errors     # 查看错误日志
3. mc_get_stack      # 查看主线程堆栈

2. 性能分析

1. mc_get_performance  # 查看 FPS/MSPT
2. mc_get_memory       # 查看内存使用
3. mc_get_entities     # 查看实体数量

3. 渲染问题

1. mc_get_gl_info      # 查看 OpenGL 信息
2. mc_get_gl_state     # 查看 GL 状态
3. mc_get_gl_errors    # 查看 GL 错误

4. 监控警告

1. mc_get_warns        # 查看警告日志
2. mc_get_log_stats    # 查看统计
3. mc_clear_logs WARN  # 清除警告

🔧 配置选项 / Configuration

config/mcpisnotmcp.properties

# TCP 服务器
tcp.port=25566
socket.timeout=5000
server.auto_start=true

# 日志缓存（新！）
cache.log.size=200
cache.error.size=100
cache.warn.size=100
cache.fatal.size=50

# 调试选项
logging.verbose=false

📦 文件结构 / File Structure

src/main/java/com/mcpisnotmcp/
├── MCPIsNotMCP.java              # 主类
└── debug/
    ├── DebugConfig.java          # 配置管理
    ├── DebugTcpService.java      # TCP 服务器
    ├── DebugCommands.java        # 命令实现
    ├── SRGMapper.java            # 名称映射
    ├── LogLevelCache.java        # 日志缓存 (NEW!)
    └── mixin/
        ├── MixinMinecraftPause.java    # 暂停功能
        ├── MixinLogCapture.java        # 日志捕获 (UPDATED!)
        └── MixinExceptionCapture.java  # 异常捕获 (UPDATED!)

mcp-server/
├── index.js          # MCP 服务器 (UPDATED!)
├── package.json      # NPM 配置
└── README.md         # 文档

🎉 版本历史 / Version History

v2.1.0 (2026-04-29) - 日志系统重构

  • ✅ 实现真正的日志捕获
  • ✅ 分级日志缓存（WARN/ERROR/FATAL）
  • ✅ 7 个新的日志查询命令
  • ✅ 详细的日志格式（时间戳、线程、堆栈）
  • ✅ 线程安全和性能优化

v2.0.0 (2026-04-29) - 大规模重构

  • ✅ 修复暂停功能
  • ✅ 配置系统
  • ✅ 线程池和资源管理
  • ✅ SRG 映射器改进
  • ✅ Node.js 连接池和重试

v1.0.0

  • 初始版本

当前版本: 2.1.0
总命令数: 27 个
状态: ✅ 完全工作