BlockGPT
A plugin that integrates Minecraft with Google Gemini AI
How it works
This plugin integrates with Gemini API using a API key and adds 2 commands /ask and /reply.
/ask: Creates a new chat, sends the message and waits for the AI to respond.
/reply: Replies to the answer sent by the AI in the last created chat
Setting up
- Head over to Gemini's API key page (witch can be found here).
- Generate a API key following the steps provided by the page.
- Head over to the config.yml file and edit the APIKey field to your API key
- The configuration is done!
Permissions
All of BlockGPT commands use the same permission, witch is blockgpt.ask
FAQ
- Why Gemini instead of ChatGPT
Gemini is free for a time period quota, and ChatGPT only have a specific amount of credits for free use, with no refresh time period
For developers
At the moment, there is no specific documentation, but here is how you can use BlockGPT in your project:
- Download the latest .jar file from the versions page
- Add this file to your project as an external library
You can also do steps 1 and 2 via JitPack
Click here for instructions on how to install via JitPack
Use the following code to get the GeminiLibrary class
Spigot
GeminiLibrary library = ((BlockGPT) Bukkit.getPluginManager().getPlugin("BlockGPT")).getGeminiAPI()
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as blockgpt-0.1.02-BETA.jar — drop this file into the mods folder
- Download size: 3.8 MB
- Download link checked 9 Sept 2026 — working
These come from our own check of the pack file, not from the source page.
