Game API

MCAPI - Minecraft 客户端 API

MCAPI 是一个 Fabric 客户端 Minecraft 模组，为外部应用程序提供了一个简单而强大的 HTTP JSON API。

该模组允许程序、机器人、仪表盘、网站和脚本实时访问 Minecraft 客户端的实时信息。MCAPI 充当 Minecraft 与外部软件之间的桥梁，使得创建集成、监控工具、覆盖层和自定义应用程序变得容易。

功能特性

玩家信息

MCAPI 提供关于当前玩家的详细信息：

• 玩家名称和 UUID
• 生命值
• 饥饿度和饱和度
• 游戏模式
• 位置
• 旋转（偏航角/俯仰角）
• 移动速度
• 疾跑状态
• 潜行状态
• 飞行状态
• 物品栏和已装备物品

世界与服务器信息

访问当前世界和服务器信息：

• 当前维度
• 难度
• 服务器 IP
• 延迟
• 在线玩家数量
• 区块位置
• 世界时间
• 生物群系
• 方块光照等级
• 天空光照等级

客户端信息

获取关于 Minecraft 客户端的信息：

• 当前 FPS
• 客户端 TPS 估算
• 已安装的 Fabric 模组

API

MCAPI 提供简单的 HTTP JSON 端点，可供外部应用程序使用。

可用端点：

端点	描述
/player	玩家信息
/world	世界和服务器信息
/client	客户端信息

所有响应均以 JSON 格式返回，便于与多种编程语言集成。

安全性

MCAPI 包含 API 密钥认证以保护您的数据。

受保护的端点要求使用 X-API-Key 头提供有效的 API 密钥。

示例： X-API-Key: your-secret-key

使用场景

MCAPI 可用于：

• Discord 机器人
• Minecraft 仪表盘
• 直播覆盖层
• 外部监控工具
• 自定义脚本
• 个人 Minecraft 工具
• 与其他应用程序集成

要求

• Minecraft 1.21.x
• Fabric Loader
• Fabric API
• Java 21

关于

MCAPI 设计为轻量、快速且对开发者友好。它不会修改游戏玩法或自动化操作。它仅通过安全的 HTTP API 向外部应用程序提供 Minecraft 客户端数据。