GrokChat

MCGrokChat

Bring Grok AI directly into your Minecraft server chat! Players can ask questions, get help, and have natural conversations with Grok AI using simple @grok mentions or commands.

GitHub Repository | Issues | Wiki

Features

• Chat Integration - Mention @grok in chat or use /grok command
• Auto-Response - Grok joins conversations naturally when keywords are mentioned (enabled by default)
• Chat History Context - Remembers the last 10 messages for better conversation flow
• Player Data Context - Optional location, biome, health, and equipment awareness for location-specific advice
• Tab Completion - Smart autocomplete for all commands
• Custom System Prompts - Change Grok's personality with configurable prompts
• Rate Limiting & Cooldowns - Prevent spam with configurable limits
• Admin Tools - Reload config, test API, view stats, and more
• Full Permissions System - Fine-grained control over who can use what

Requirements

• Java 17 or higher
• Spigot/Paper/Purpur 1.21+ (or compatible Spigot-based server)
• xAI API key (get one here)

Supported Servers

• Spigot 1.21+
• Paper 1.21+ (recommended)
• Purpur 1.21+
• Other Spigot-based servers

Configuration

All settings can be configured in plugins/MCGrokChat/config.yml. You'll need an xAI API key to get started - sign up at console.x.ai to get yours.

Example configuration:

api:
  key: "your-xai-api-key-here"
  model: "grok-3-mini"

chat:
  enable-auto-response: true
  auto-response-keywords:
    - "grok"
    - "hey grok"

chat-history:
  enabled: true
  size: 10

Example Usage

# Direct Mention (Private Response)
Player: @grok how do I find diamonds?
[Grok] The best way to find diamonds is to mine at Y-level -59. Bring iron pickaxes and watch out for lava!

# Auto-Response (Public - Everyone sees)
Player: hey grok what's the best enchantment for a sword?
[Grok] For swords, Sharpness V is essential! Also get Sweeping Edge III for crowd control. Don't forget Looting III for better drops!

# Command Usage
/grok what's the best food in minecraft?
[Grok] Golden carrots are the best food for saturation, but cooked porkchops and steak are great for hunger restoration!

Documentation

• Full README - Complete documentation and examples
• Configuration Examples - Pre-made config files for different setups
• Setup Guide - Detailed installation instructions
• Feature Guides - Guides for auto-response, chat history, customization, and more

Support

• Report Issues: GitHub Issues
• Wiki: GitHub Wiki
• Source Code: GitHub Repository

API Costs

This plugin uses the xAI API. Check xAI's pricing page for current rates. The plugin uses grok-3-mini by default, which is optimized for cost efficiency.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Made with love for the Minecraft community

Not affiliated with Mojang, Microsoft, or xAI