About GDMC HTTP Interface
From ModrinthMinecraft Fabric/Forge Mod that implements an HTTP interface for reading and writing blocks (and more) with an external program or script.
GDMC HTTP Interface Mod
Mod for Minecraft (Java Edition) that implements an HTTP interface for reading and writing blocks (and more).
With this interface you can use other applications and scripts running on the same machine to read and modify a Minecraft world.
This is designed as a tool for the Generative Design in Minecraft Competition (GDMC). This annual competition for procedural AI systems in Minecraft, where the challenge is to write an algorithm that generates a settlement while adapting to pre-existing terrain. Feel free to join our community Discord server!
| 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 |
Usage
When you open a Minecraft world, you will see a chat message that the mod has opened an HTTP connection at the address localhost:9000. This means that you can now send HTTP requests from an external program to Minecraft while the world is open.
For testing and experimentation we recommend an API testing tool such as Kreya, Yaak, HTTPie or a command line tool such as cURL or wget.
When you want to build your own settlement generator or some other application, we recommend using the GDPC Python library, which is purpose-built by the GDMC community to work with this mod. But any programming or scripting language that supports communication over HTTP (which includes most of them, be it either built-in or via an easy-to-use library) will work.
HTTP Endpoints
When the HTTP interface is active, you have access to the following HTTP endpoints:
Highlights
From source dataGame versions
Supports 5 Minecraft versions, the newest being 1.21.11.
Loaders
Runs on Fabric, Forge and NeoForge.
Footprint
Rated a light load on a server.
GDMC HTTP Interface on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
- Server side
- Optional on the server
- Server type needed
- Fabric, Forge, NeoForge
- Server load
- light
- Smallest plan we suggest
- Minecraft — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 1.8.4-1.21.11, released 2026-05-29
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Fabric | 1.21.11 | 1.21.11 |
| NeoForge | 1.21.11 | 1.21.11 |
From 5 recorded builds of GDMC HTTP Interface.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 1.8.4-1.21.11 | 2026-05-29 | 1.21.11 | Fabric, NeoForge |
| 1.8.3-1.21.11 | 2026-03-08 | 1.21.11 | Fabric, NeoForge |
| 1.8.2-1.21.11 | 2026-02-27 | 1.21.11 | Fabric, NeoForge |
| 1.8.1-1.21.11 | 2026-02-06 | 1.21.11 | Fabric, NeoForge |
| 1.8.0-1.21.11 | 2026-01-23 | 1.21.11 | Fabric, NeoForge |
Dependencies
- Optional: modrinth project P7dR8mSH (modrinth, not in our catalogue)
- Optional: modrinth project mOgUt4GM (modrinth, not in our catalogue)
Declared by the newest build that lists any. Required ones are installed with it on one-click installs.
Run GDMC HTTP Interface on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogQuality of life & UI
Small conveniences, tweaks and interface improvements players notice straight away.
Works on a server
From source side supportModrinth lists server-side support for GDMC HTTP Interface as optional: it can run on a server, but isn’t required there.
Compatibility
- Game
- Minecraft
- Loaders
- FabricForgeNeoForge
- Runs on
- Serveroptional on the server
- Game versions
- 1.21.11 and 4 earlier
Verified at the source
- ✓ModrinthOfficial listing, checked 2026-10-02Open ↗
- ✓AuthorNiels-NTG, as published on Modrinth
- ✓LicenseMITFree
