Features

• Ask a powerful AI directly from the in-game chat
• Uses the Groq API
• Loading animation via Bossbar OR simple chat message
• Multilingual responses (configurable via language: de, en, es, etc.)
• Fully customizable thinking messages & responses
• Anti-spam cooldown with real-time countdown in chat
• Optional logging of all questions and answers per player
• Built-in blacklist for restricted words (editable)
• Developer API: LumoAPI.ask(player, "question")
• No database needed – completely self-contained

⚙️ Configuration (config.yml)

Commands & Permissions

• /lumo <question> – Ask a question to the AI
• /lumo help – Show help messages
• /lumo clearlogs – (Admin) Clear all stored logs

Permission:
lumo.admin – For log deletion, cooldown bypass, etc.


Files Generated
✅ config.yml – Main configuration
✅ messages.yml – All editable responses and thinking messages
✅ blacklist.yml – Add restricted words here
✅ cache/ – Stores logs per player if logs: true


Installation

1. Drop the plugin into your /plugins folder
2. Start the server – config files will be generated
3. Insert your API key from https://console.groq.com
4. Restart the server
5. Try: /lumo What is a Creeper?

For Developers
Simple integration via the provided API:

Requirements

• Java 21
• Valid Groq API key (free with signup)
• Minecraft 1.20 – 1.21.4 (Paper recommended)