✦ AI-Asystent

Your elegant in-game AI companion for Paper servers

Built by xFevi
YouTube: @xfevik · Studio: xfevi.pl

✨ Bring AI directly into Minecraft

AI-Asystent is a polished AI assistant plugin for Paper servers.
Players can ask questions naturally in chat, while administrators retain full control over the AI provider, model, server context, rate limits, visuals, language, and theme.

Every answer is delivered privately to the player who asked the question. No chat spam. No server lag. No shared conversation history.

Ask. Receive. Keep playing.

⚡ Why AI-Asystent?

| ### 🧠 Smart, server-aware answers Add your own rules, commands, reporting instructions, and server knowledge in config.yml. The assistant uses this context to give useful, server-specific guidance. |### 🔒 Private by design AI replies are visible only to the player who asked. No previous questions are remembered, saving API tokens and ensuring maximum privacy. | | ### ⚙️ Seamless Integrations Use Groq, OpenAI, or Gemini. Switch between OpenAI-compatible providers instantly with a single command. |### 🎨 Made for Minecraft chat Beautiful MiniMessage gradients, titles, sounds, particles, and configurable spacing make each answer feel premium. |

🚀 Quick Start

Getting started takes less than a minute. Ensure your server runs Paper 1.21.11 with Java 21.

1. Install: Drop the .jar file into your plugins folder and restart the server.
2. Connect API: Set your private API key in-game: /aa api YOUR_API_KEY
3. Pick a Provider: Choose a ready-to-use preset: /aa preset <groq/openai/gemini>
4. Test it: Ask your first question: /ai How do I report a cheater?

🛠️ Commands & Permissions

Everything can be configured directly in-game without editing files.

💬 Player Command (xfevi.ai.player)

• /ai <question> — Asks the AI a question.

⚙️ Admin Commands (xfevi.aa.admin)

• Core:
  • /aa api <key> — Saves your API key.
  • /aa preset <provider> — Switches provider (Groq, OpenAI, Gemini).
  • /aa system-prompt <text> — Changes the AI personality and context.
  • /aa reload — Reloads the configuration.
• Appearance & Language:
  • /aa color <ORANGE/YELLOW/GREEN/RED> — Changes the chat theme.
  • /aa PL / /aa ANG — Switches plugin language.
• Rate Limits:
  • /aa limit <number> — Question limit for standard players.
  • /aa limit-vip <number> — Question limit for VIPs (requires xfevi.ai.vip permission).
  • /aa limit-time <minutes> — Time window for limit resets.

📚 Advanced Features (via config.yml)

• Server Knowledge: Inject your Discord link, rules, and VIP info so the AI can answer server-specific questions perfectly.
• Custom Endpoints: Change api.base_url and api.model to use any custom OpenAI-compatible provider.
• Visuals: Fine-tune sounds (e.g., UI clicks, level-up chimes), particles, titles, and the amount of empty chat space above/below answers.

⚙️ Requirements: Paper 1.21.11 | Java 21
📄 License: Copyright © 2026 xFevi. All Rights Reserved. Do not redistribute, modify for resale, or claim ownership.