mineGPT

Use ChatGPT Desktop as a companion in your Minecraft 1.21.1 game. Type a question with @gpt in Minecraft and receive the reply as a local chat message. MineGPT is client-only: it does not require a server Mod or plugin, and your @gpt messages are never sent to a multiplayer server or other players.

Minecraft @gpt message -> local MineGPT Bridge -> ChatGPT Desktop -> local reply

Install MineGPT

1. Add the MineGPT Mod JAR to the mods folder of the Minecraft instance you will play. Fabric users must also install Fabric API in that same instance.

2. Extract the MineGPT Bridge distribution somewhere that will remain available on your computer. You will give ChatGPT Desktop the absolute path to its launch script:

   • macOS/Linux: bin/minegpt-bridge
   • Windows: bin/minegpt-bridge.bat

3. Start the selected Minecraft instance once. MineGPT runs only on your client; there is nothing to install on the multiplayer server.

Connect ChatGPT Desktop

1. In ChatGPT Desktop, open Settings -> MCP servers and add a STDIO server named minegpt.
2. Set its command to the absolute Bridge script(Download from Github) path from the previous section. Do not add arguments or an API key.
3. Restart ChatGPT Desktop, then run /mcp in a conversation to confirm that minegpt is connected.
4. In that conversation, ask ChatGPT to call minegpt_pairing_code, then copy the returned token.
5. In Minecraft, run:

   /minegpt pair <token>

1. Tell ChatGPT to listen for your in-game questions. This prompt is a useful starting point:

   Start listening to Minecraft. For every MineGPT player message, answer it,
   call minegpt_reply with the exact message_id, then immediately call
   minegpt_next_message again with wait_seconds 45. Continue until I tell you
   to stop.

Keep this ChatGPT conversation open while it is listening. Minecraft cannot open or wake a conversation on its own.

Leaving a Minecraft world or returning to the title screen keeps the MineGPT Bridge session open. The Bridge closes only when the Minecraft client exits.

Use It In Game

• Type @gpt <message> in the normal Minecraft chat box. For example:

  @gpt What can I craft with the items in my inventory?

• ChatGPT replies appear as local [MineGPT] system messages. Ordinary chat without the @gpt prefix is unchanged.
• Run /minegpt status to check pairing, Bridge connection, and queued-message status.
• Run /minegpt github <github_url> to install one public GitHub Markdown skill into this Minecraft instance. Use a normal GitHub file-page URL or a raw.githubusercontent.com URL. Existing skills are never overwritten.