Skip to content

Releases: eldor47/MCGrokChat

Release v1.1.0 - Blacklist filtering and per-group rate limits

02 Nov 09:04
3e2819a

Choose a tag to compare

MCGrokChat v1.1.0 Release Notes

New Features

Blacklist Filtering System

Prevent Grok from responding to specific words or phrases. Perfect for filtering spam, inappropriate content, or test messages!

Features:

  • Case-insensitive matching (blocks "SPAM", "spam", "Spam")
  • Partial word matching (blocks "spamming", "spam bot")
  • Silent filtering (no error messages, just ignored)
  • Runtime management via admin commands

Admin Commands:

/grokchat blacklist list          # Show current blacklist
/grokchat blacklist add <word>    # Add word/phrase to blacklist
/grokchat blacklist remove <word> # Remove word/phrase
/grokchat blacklist clear         # Clear entire blacklist
/grokchat blacklist enable        # Enable blacklist filtering
/grokchat blacklist disable       # Disable blacklist filtering

Configuration:

blacklist:
  enabled: true
  blocked-words:
    - "spam"
    - "test test test"

👥 Per-Group Rate Limits

Set different rate limits for different player groups using permissions. Perfect for VIP members who deserve more requests!

Features:

  • Permission-based (works with LuckPerms, PermissionsEx, etc.)
  • Highest limit wins (if player has multiple group permissions)
  • Falls back to default limit if no group permissions
  • Works automatically - no manual configuration needed

Configuration:

rate-limit:
  enabled: true
  max-requests-per-hour: 20  # Default for players without group permissions
  groups:
    grokchat.rate.vip: 50      # VIP players get 50/hour
    grokchat.rate.member: 20    # Members get 20/hour
    grokchat.rate.guest: 5      # Guests get 5/hour

Setup with LuckPerms:

/lp group vip permission set grokchat.rate.vip true
/lp group member permission set grokchat.rate.member true

Changes

Permissions System Updates

  • Changed grokchat.use and grokchat.command defaults from true to false
  • Permissions now require explicit granting via permission plugins
  • Better control over who can use Grok features
  • Works perfectly with LuckPerms!

Installation

  1. Download MCGrokChat-1.1.0.jar from the assets below
  2. Replace your old plugin file in plugins/ folder
  3. Restart your server (or use /grokchat reload after server restart)
  4. Update your config.yml if you want to use new features

🔗 Links

📝 Full Changelog

See CHANGELOG.md for detailed changes.


MCGrokChat v1.0.0 - Initial Release

30 Oct 05:41

Choose a tag to compare

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.