# GeminiMC – Gemini AI for Minecraft Server Management<\/p>\n
A powerful Minecraft plugin that integrates Google’s Gemini AI to help server administrators manage their servers through natural language commands.<\/p>\n
## Features<\/p>\n
– **Natural Language Interface**: Ask Gemini questions in plain English
\n– **Command Execution**: AI can suggest and execute server commands
\n– **Confirmation System**: Review commands before execution (or enable auto-accept)
\n– **Conversation Memory**: Maintains chat history for context-aware responses
\n– **Server Context**: AI has access to server info, player data, and recent chat
\n– **OP-Only Access**: Secure – only server operators can use the plugin
\n– **Dual Model Support**: Uses Gemini 2.0 Flash for both planning and execution<\/p>\n
## Requirements<\/p>\n
– Minecraft 1.21+ (Spigot\/Paper server)
\n– Java 21 or higher
\n– Google Gemini API key<\/p>\n
## Installation<\/p>\n
1. Download the plugin JAR file
\n2. Place it in your server’s `plugins` folder
\n3. Restart your server
\n4. Configure your API key (see Setup section)<\/p>\n
## Setup<\/p>\n
### Getting a Gemini API Key<\/p>\n
1. Go to Google AI Studio
\n2. Click “Create API Key”
\n3. Copy your API key<\/p>\n
### Configuring the Plugin<\/p>\n
1. In-game, run: `\/g setapikey YOUR_API_KEY_HERE`
\n2. Or edit `plugins\/GeminiMC\/config.yml` and add your key there<\/p>\n
## Usage<\/p>\n
### Basic Commands<\/p>\n
“` ### Example Usage<\/p>\n #### Basic Questions #### Server Management #### Complex Tasks ### Command Confirmation<\/p>\n When Gemini suggests commands, you’ll see:<\/p>\n “` [CONFIRM] [CANCEL] Click the buttons or type `\/g confirm` or `\/g cancel`.<\/p>\n ### Auto-Accept Mode<\/p>\n For trusted operations, enable auto-accept:<\/p>\n “` Commands will execute immediately without confirmation. Be careful with this mode!<\/p>\n To disable: ## How It Works<\/p>\n 1. **Context Gathering**: When you ask a question, the plugin gathers current server information: 2. **AI Processing**: Your question and context are sent to Gemini AI<\/p>\n 3. **Response Parsing**: The AI’s response is analyzed for command suggestions<\/p>\n 4. **Command Execution**: If commands are suggested: 5. **History Tracking**: The conversation is saved for future context<\/p>\n ## Configuration<\/p>\n Edit `plugins\/GeminiMC\/config.yml`:<\/p>\n “`yaml # Auto-accept command execution # Maximum chat history to keep # Maximum recent chat messages to include in context # Gemini API settings ## Security<\/p>\n – **OP-Only**: Only server operators can use `\/g` commands ## Building from Source<\/p>\n 1. Clone the repository ### Build Requirements ### Build Command ## Troubleshooting<\/p>\n ### “API key not set” error ### Commands not executing ### AI not responding ### “You must be an operator” message ## Privacy & Data<\/p>\n – Conversation history is stored locally in `plugins\/GeminiMC\/histories\/` ## Support<\/p>\n For issues, questions, or suggestions: ## License<\/p>\n This plugin is provided as-is for server management purposes.<\/p>\n ## Credits<\/p>\n – Built with Paper API ## Version<\/p>\n Current version: 1.0.0<\/p>\n —<\/p>\n **Note**: This plugin gives AI the ability to execute server commands. Always review commands before confirming unless you fully trust the AI’s suggestions. Use auto-accept mode with caution.<\/p>\n","protected":false},"excerpt":{"rendered":" Its a minecraft plugin made for admins to manage their server using AI (Gemini) because it has free api keys<\/p>\n","protected":false},"featured_media":75082,"template":"","meta":{"_minecraft_slug":"geminimc","_minecraft_project_id":"RRkw9gW6","_minecraft_author":"XoperrDev","_minecraft_license":"MIT","_minecraft_downloads":67,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"geminimc.zip","_minecraft_size_bytes":8257831,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:33:34.234306Z","_minecraft_date_created":"2025-12-02T05:09:51.006032Z","_minecraft_date_modified":"2025-11-27T11:36:31.739792Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/geminimc","_minecraft_icon_attachment_id":75082,"_minecraft_imported_at":"2026-06-04T08:31:29+00:00","_minecraft_import_hash":"e46e312462e59ea2a1202def176b8c31","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128,129],"mod_loader":[132,133,134],"minecraft_version":[40,74,38,78,79,80,81,82],"class_list":["post-75081","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n\/g
\n\/g setapikey
\n\/g autoaccept
\n\/g clearhistory – Clear conversation history
\n\/g context view – View current server context
\n\/g context clear – Clear recent chat context
\n\/g confirm – Confirm pending commands
\n\/g cancel – Cancel pending commands
\n\/g help – Show help message
\n“`<\/p>\n
\n“`
\n\/g how many players are online?
\n\/g what time is it in the overworld?
\n\/g how much memory is the server using?
\n“`<\/p>\n
\n“`
\n\/g give all online players a diamond
\n\/g teleport everyone to spawn
\n\/g change the weather to clear
\n\/g set the time to day in all worlds
\n“`<\/p>\n
\n“`
\n\/g create a new world called “mining” with seed 12345
\n\/g ban player xyz for griefing
\n\/g give op to player abc
\n“`<\/p>\n
\n\u26a0 The AI wants to execute the following commands:
\n \u2022 \/give @a diamond 1
\n \u2022 \/say Diamonds for everyone!<\/p>\n
\n“`<\/p>\n
\n\/g autoaccept true
\n“`<\/p>\n
\n“`
\n\/g autoaccept false
\n“`<\/p>\n
\n – Players online
\n – World data
\n – Server performance (TPS, memory)
\n – Recent chat messages<\/p>\n
\n – In normal mode: You’re asked to confirm
\n – In auto-accept mode: Commands execute automatically<\/p>\n
\n# Your Gemini API key
\napi-key: “”<\/p>\n
\nauto-accept: false<\/p>\n
\nmax-history: 50<\/p>\n
\nmax-chat-context: 10<\/p>\n
\ngemini:
\n planning-model: “gemini-2.0-flash-exp”
\n execution-model: “gemini-2.0-flash-exp”
\n api-url: “https:\/\/generativelanguage.googleapis.com\/v1beta\/models\/”
\n“`<\/p>\n
\n– **Command Review**: All commands can be reviewed before execution (unless auto-accept is enabled)
\n– **Console Execution**: Commands run as console with full permissions
\n– **No External Access**: The AI cannot access external services beyond the Gemini API<\/p>\n
\n2. Install Maven
\n3. Run: `mvn clean package`
\n4. Find the JAR in `target\/GeminiMC-1.0.0.jar`<\/p>\n
\n– Java 21 JDK
\n– Maven 3.6+<\/p>\n
\n“`bash
\nmvn clean package
\n“`<\/p>\n
\n– Run `\/g setapikey YOUR_KEY` in-game
\n– Or add the key to `config.yml`<\/p>\n
\n– Make sure you’re an OP: `\/op yourname`
\n– Check server logs for errors
\n– Verify your API key is valid<\/p>\n
\n– Check your internet connection
\n– Verify the Gemini API is accessible
\n– Check server console for error messages<\/p>\n
\n– Only OPs can use this plugin
\n– Ask a server admin to OP you: `\/op yourname`<\/p>\n
\n– Questions and context are sent to Google’s Gemini API
\n– No data is sent to any other external service
\n– Review Google’s Gemini API Terms of Service<\/p>\n
\n– Check the troubleshooting section above
\n– Review server console logs
\n– Check that you’re using a compatible Minecraft version (1.21+)<\/p>\n
\n– Powered by Google Gemini AI
\n– Uses OkHttp for HTTP requests
\n– Uses Gson for JSON processing<\/p>\n