Перейти к содержимому
Mineforgian

GrokChat

Integrates Grok AI into server chat with @mentions, auto-response, and contextual awareness

Загрузки
358
Подписчики
3
Обновлён
2 ноября 2025 г.
Лицензия
MIT

Опубликован 30 октября 2025 г.

Исходный кодСообщить об ошибке

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

Support

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

Ченджлог

1.1.0Релиз1.21.8, 1.21.9, 1.21.10 · 2 ноября 2025 г.

MCGrokChat v1.1.0

New Features

Blacklist Filtering

Prevent Grok from responding to specific words or phrases. Runtime management via /grokchat blacklist commands.

Commands:

  • /grokchat blacklist list - Show current blacklist
  • /grokchat blacklist add <word> - Add word to blacklist
  • /grokchat blacklist remove <word> - Remove word from blacklist
  • /grokchat blacklist clear - Clear entire blacklist

Per-Group Rate Limits

Set different rate limits for different player groups using permissions. Perfect for VIP servers!

Setup:

  1. Configure groups in config.yml:
rate-limit:
  groups:
    grokchat.rate.vip: 50
    grokchat.rate.member: 20
    grokchat.rate.guest: 5
  1. Grant permissions via LuckPerms:
/lp group vip permission set grokchat.rate.vip true

Players get the highest limit they qualify for.

Changes

  • Permissions now default to false (requires explicit granting via permission plugins)
  • Better LuckPerms integration
  • Enhanced admin commands with blacklist management
1.0.0Релиз1.21.8, 1.21.9, 1.21.10 · 30 октября 2025 г.

MCGrokChat v1.0.0

Initial release of MCGrokChat - a Minecraft plugin that integrates Grok AI into your server chat.

Features

  • @grok mentions and /grok command
  • Auto-response when keywords are mentioned
  • Chat history context (last 10 messages)
  • Optional player data context (location, biome, health, etc.)
  • Customizable system prompts
  • Rate limiting and cooldowns
  • Tab completion for all commands
  • Admin tools for management

Quick Start

  1. Download the jar file
  2. Place in your plugins folder
  3. Add your xAI API key to config.yml
  4. Restart server

Requirements: Java 17+, Spigot/Paper/Purpur 1.21+, xAI API key

See README for full documentation.

Комментарии

Загружаем…