Welcome to GroqCraft

The ultimate AI-powered assistant plugin for your Minecraft server! Powered by the ultra-fast Groq API, GroqCraft brings advanced AI directly into your in-game chat — fully asynchronous, lag-free, and context-aware.

Whether you need building advice or emergency survival help while surrounded by mobs, GroqCraft is your intelligent Minecraft companion.

✨ Features

• ⚡ Fast & Lag-Free: Uses the Groq API to generate answers in milliseconds with fully asynchronous requests and zero TPS impact.
• 🧠 Smart Context Analysis: The AI analyzes your real-time situation including health, dimension, coordinates, held items, and nearby hostile mobs.
• 💬 Conversation Memory: Supports natural follow-up questions and ongoing chat sessions.
• 🛠️ Simple Setup: Easy configuration with quick in-game commands.

🛠️ Commands & Permissions

Main command: /groqcraft
Permission: groqcraft.use

🚀 Setup

1. Place GroqCraft.jar into your server's plugins folder.
2. Restart or reload the server.
3. Generate a free API key from the Groq Console.
4. Run:

   /groqcraft api gsk_your_secret_key_here

1. Configure your model and temperature settings if desired.

💡 Examples

🌋 Survival Help

You ask:

/groqcraft ask What should I do right now?!

GroqCraft responds:
"You are in the Nether with only 2 hearts remaining and multiple hostile mobs nearby. Block line of sight immediately, eat food, and move into cover before engaging."

🏗️ Building & Mechanics

You ask:

/groqcraft ask How do I build an efficient iron farm?

GroqCraft responds:
Provides a detailed guide with villager mechanics, spawning rules, and optimization tips.

⚙️ Configuration (config.yml)

# GroqCraft Configuration
api-key: "gsk_..."
model: "llama3-8b-8192"
temperature: 0.7

system-prompt: "You are a highly knowledgeable and helpful Minecraft assistant. Analyze player context and provide accurate survival and gameplay advice."