GDMC HTTP Interface

模组

· 作者 Niels-NTG

适用于 Minecraft 的 Fabric/Forge 模组,实现了一个 HTTP 接口,用于通过外部程序或脚本读取和写入方块(以及更多内容)。

0 本站下载 0 关注 更新于 5 个月前

最新 1.8.4-1.21.11 · 1.21.11 · Fabric / NeoForge

一键开服(送7天)

GDMC HTTP Interface Mod

适用于 Minecraft(Java 版)的模组,实现了用于读取和写入方块(以及更多功能)的 HTTP 接口。

通过此接口,你可以使用在同一台机器上运行的其他应用程序和脚本来读取和修改 Minecraft 世界。

本模组旨在作为 Minecraft 生成式设计竞赛 (GDMC) 的工具。这是一项针对 Minecraft 中过程式 AI 系统的年度竞赛,挑战在于编写一种能够适应现有地形并生成定居点的算法。欢迎加入我们的 社区 Discord 服务器!

Minecraft version GDMC-HTTP version Docs GDMC competition year
1.21.11 ? GDMC-HTTP 1.8.4 ? API Docs 2026
1.21.4 ? GDMC-HTTP 1.6.0 ? API Docs 2025
1.20.2 ? GDMC-HTTP 1.6.0 ? API Docs 2024
1.19.2 ? GDMC-HTTP 1.6.0 ? API Docs 2023
1.16.5 ? GDMC-HTTP 0.4.2 ? API Docs 2021, 2022

用法

当你打开一个 Minecraft 世界时,你会看到一条聊天消息,提示模组已在地址 localhost:9000 上打开了 HTTP 连接。这意味着你现在可以从外部程序向 Minecraft 发送 HTTP 请求,只要该世界处于打开状态。

对于测试和实验,我们推荐使用 API 测试工具,如 Kreya、Yaak、HTTPie,或者像 cURL 或 wget 这样的命令行工具。

如果你想构建自己的定居点生成器或其他应用程序,我们推荐使用 GDPC Python 库,这是由 GDMC 社区专门为配合此模组而开发的。但任何支持通过 HTTP 进行通信的编程语言或脚本语言(包括大多数语言,无论是内置支持还是通过易于使用的库实现)都可以使用。

HTTP 端点

当 HTTP 接口处于活动状态时,你可以访问以下 HTTP 端点:

HTTP 方法 URL 描述 文档
POST /commands ? 发送 Minecraft 控制台命令 ? API 文档
GET /blocks ? 获取指定区域的方块信息 ? API 文档
PUT /blocks ? 放置方块 ? API 文档
GET /biomes ?️ 获取指定区域的生物群系信息 ? API 文档
GET /chunks ⛏ 获取指定区域的原始区块数据 ? API 文档
GET /structure ?️ 从指定区域创建 NBT 结构文件 ? API 文档
POST /structure ?️ 将 NBT 结构文件放置到世界中 ? API 文档
GET /entities ? 获取指定区域的实体信息 ? API 文档
PUT /entities ? 召唤实体到世界中 ? API 文档
PATCH /entities ? 编辑世界中已存在的实体 ? API 文档
DELETE /entities ? 从世界中移除实体 ? API 文档
GET /players ? 获取指定区域的玩家信息 ? API 文档
GET /buildarea ? 获取当前建筑区域的信息 ? API 文档
GET /heightmap ?️ 获取建筑区域的高度图信息 ? API 文档
OPTIONS / ? 获取当前的 Minecraft 和模组版本 ? API 文档

端点的详细文档请参见 docs/Endpoints。

命令

此模组为游戏添加了以下自定义控制台命令:

命令 描述
/buildarea 获取当前建筑区域(如果存在)。部分 端点 可使用 withinBuildArea 标志将操作限制在此区域内。
/buildarea set <fromX> <fromY> <fromZ> <toX> <toY> <toZ> 将虚拟“建筑区域”设置为世界的特定区域。对于命令参数,你可以混合使用绝对坐标、局部坐标 或 相对世界坐标。
/buildarea set <fromX> <fromY> <fromZ> <toX> <toY> <toZ> <name> 设置当前建筑区域,并将此数据以 <name> 为键 存储 到存档数据中,以便后续使用。
/buildarea load <name> 加载之前设置的建筑区域。
/buildarea remove 移除当前建筑区域。
/buildarea remove <name> 移除指定 <name> 的建筑区域。
/buildarea tp 传送至当前建筑区域内(如果存在)。
/buildarea tp <name> 传送至之前保存的建筑区域内。
/buildarea list 列出所有已保存的建筑区域。
/buildarea makebook 给予玩家一本书,其中列出了所有已保存的建筑区域作为链接,点击后可传送至相应位置。
/buildarea makebook <author> 创建书籍(见上文),由 <author> 署名。若省略,作者默认为 “GDMC”。
/gethttpport 显示 HTTP 接口当前的端口号。
/sethttpport 将 HTTP 接口的端口号重置为默认值 9000。
/sethttpport <number> 更改 HTTP 接口的端口号。当默认端口 (9000) 与机器上的其他应用程序冲突时非常有用。你需要重新加载世界才能使此设置生效。

致谢

GDMC-HTTP 在 GDMC 社区的帮助下得到了积极开发。特别值得一提的是 Niki Gawlik,他为 Minecraft 1.16.5 创建了该模组的原始版本。本仓库是其工作的延续。对 Fabric 加载器的支持部分基于 Simon Pribylski 的 fork。支持多个加载器和 Minecraft 版本并共存于同一分支的项目结构,借鉴自 Distant Horizons 模组。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源