Codex Client Control

📖 简介

Codex Client Control 是一款专为 Minecraft 1.21.11 设计的客户端控制模组，支持 Fabric 和 NeoForge 双平台。它在本地启动一个仅监听 127.0.0.1 的 HTTP/WebSocket 服务器，为外部脚本和程序提供安全、便捷的客户端控制接口。

无论你是想实现自动化农场、批量建造、自动采集，还是需要开发复杂的 AI 控制逻辑，Codex Client Control 都能为你提供强大的底层支持。

🌟 核心优势

• 🔒 安全可靠 - 仅监听本地回环地址，内置 Token 认证机制
• ⚡ 双模通信 - HTTP REST API + WebSocket 实时推送
• 🎮 完整控制 - 支持移动、视角、GUI 操作、物品栏管理等全功能
• 🤖 智能托管 - 内置动作序列和托管任务系统
• 🔧 灵活扩展 - 配套 LAN Bot 子项目，支持更流畅的连续动作
• 📊 状态同步 - 实时获取游戏状态、聊天、屏幕、容器等信息

---

✨ 核心功能与特色

🔌 HTTP REST API

提供完整的 RESTful 接口，支持所有核心控制功能：

状态查询

• GET /status - 获取客户端基本状态
• GET /full-state - 获取完整状态（状态 + 聊天 + 屏幕 + 目标 + 容器 + 玩家列表）
• GET /chat - 读取聊天缓存
• GET /screen - 读取当前 GUI 信息和可见控件
• GET /target - 读取准星目标信息
• GET /container - 读取容器内容
• GET /players - 读取玩家列表
• GET /debug/fake-player - 读取本地调试假人列表

控制操作

• POST /chat - 发送聊天消息
• POST /command - 执行游戏命令
• POST /look - 转动视角
• POST /key - 按住/松开按键
• POST /input - 应用综合控制状态（按键 + 视角 + 快捷栏）
• POST /tap - 轻点按键
• POST /hotbar - 切换快捷栏
• POST /release-all - 松开所有控制键

GUI 操作

• POST /gui/close - 关闭当前 GUI
• POST /gui/click - 点击 GUI 坐标
• POST /gui/release - 松开 GUI 鼠标按键
• POST /gui/scroll - 滚动 GUI
• POST /gui/key - 向 GUI 发送按键
• POST /gui/type - 向 GUI 输入文本
• POST /gui/click-widget - 按控件索引点击按钮

高级功能

• POST /screenshot - 截图
• POST /sequence - 执行动作序列
• POST /action/run - 运行托管动作
• POST /action/cancel - 取消托管动作
• POST /debug/fake-player/* - 本地调试假人管理

🔌 WebSocket 实时通信

连接到 ws://127.0.0.1:47862/ws，支持实时双向通信：

• 心跳检测 - ping 保持连接活跃
• 状态订阅 - 订阅特定事件，实时接收推送
• 全功能支持 - 所有 HTTP 接口功能均可通过 WebSocket 调用
• 低延迟 - 适合需要快速响应的实时控制场景

🤖 托管动作系统

内置智能托管动作，解放你的双手：

• 动作序列 - 执行预定义的动作序列
• 托管任务 - 运行后台托管动作（如自动寻路、批量操作）
• 可取消 - 随时取消正在执行的托管动作

🎭 本地调试假人

支持生成和管理本地调试假人实体：

• 生成假人到指定位置
• 移动假人
• 移除假人
• 清空所有假人

🤖 LAN Bot 配套项目（可选）

仓库包含独立的 lan-bot 子项目，作为第二个玩家加入你开放的局域网世界：

• 更流畅的连续动作 - 独立客户端，不受主客户端性能影响
• 自动寻路系统 - 基于 mineflayer-pathfinder
• 物品栏管理 - 完整的物品栏操作支持
• 批量操作 - 支持批量放置、种植、采集等任务
• 托管动作 - 内置种植催熟、建造小屋等高级动作

---