PixelAI

# 🤖 PixelAI Bring the power of AI to your Minecraft server. PixelAI is a lightweight, high-performance integration that allows players to interact with state-of-the-art AI models directly in-game. Whether you need an assistant for all your server features or a witty global chatbot to entertain your community, PixelAI has you covered. ## ✨ Key Features **Dual AI Personalities**: Configure a Private Assistant for individual help and a Global AI for public chat interactions. **Total Model Control**: Powered by OpenRouter. Use GPT-4, Claude 3, Llama 3, or any other AI model. **Smart Memory**: Built-in conversation history that remembers context without bloating your server's RAM. **Fully Customizable**: Change every setting and every single message to fit your server's theme. **Asynchronous Logic**: All API calls happen off-thread, ensuring zero lag for your players. **Flexible Storage**: Choose between local YAML files or a MySQL database for cross-server data syncing. **MiniMessage**: No more messy legacy color codes. PixelAI natively supports MiniMessage. ## 🛠️ Commands & Permissions ``` /pixelai <prompt> ``` - Chat privately with your AI assistant. (pixelai.use.private) ``` /pixelai model <model> ``` - Switch your personal AI model on the fly. (pixelai.model) ``` /pixelai clear ``` - Reset your private conversation history. (pixelai.use.private) ``` /pixelai reload ``` - Reload the configuration and messages. (pixelai.admin.reload) ## 🚀 Getting Started Drop the PixelAI.jar into your plugins folder. Get an API Key from (https://openrouter.ai/) and add your key to config.yml. Start chatting! Use @AI in public chat or /pixelai for private help. ### config.yml ``` # ========================================================== # PixelAI Configuration # ========================================================== # OpenRouter API Key: https://openrouter.ai/settings/keys # OpenRouter offers free and paid AI models api-key: "YOUR_OPENROUTER_KEY_HERE" # --- AI Model Settings --- # Default for new players or if no model is selected default-model: "openai/gpt-3.5-turbo" # The specific model used for public @AI messages public-model: "meta-llama/llama-3-8b-instruct" # Models available in the /pixelai model <model> tab completion # Explore all models at https://openrouter.ai/models allowed-models: - "openai/gpt-3.5-turbo" - "openai/gpt-4o" - "anthropic/claude-3-haiku" - "meta-llama/llama-3-8b-instruct" - "nvidia/nemotron-3-nano-30b-a3b:free" - "tngtech/tng-r1t-chimera:free" # --- AI Personalities --- private-system-prompt: "You are a helpful assistant on a Minecraft server. Keep responses concise and friendly." global-system-prompt: "You are the server's Global Assistant. You are talking to everyone in the public chat." # Prefix to trigger the AI in public chat chat-trigger: "@AI" # --- Memory Settings --- memory: public-size: 5 # Shared history for @AI private-size: 15 # Personal history for /pixelai <prompt> # --- Storage Settings --- storage: type: "YAML" # Options: YAML, MYSQL mysql: host: "localhost" port: 3306 database: "pixelai" username: "root" password: "" use-ssl: false # --- Rate Limiting --- # Permission: limits: private: pixelai.limit.admin: # Admins: Infinite pixelai.limit.vip: # VIPs: 50/day pixelai.limit.default: # Default: 10/hour global: pixelai.limit.admin: # Admins: Infinite pixelai.limit.vip: # VIPs: 20/hour pixelai.limit.default: # Default: 5/hour # --- Default Command --- # Customize the default command # Requires reload when changed command: name: "pixelai" aliases: - "ai" - "ask" # --- Permission Nodes --- permissions: use_private: "pixelai.use.private" # Required for /pixelai <prompt> use_global: "pixelai.use.global" # Required for @AI in chat help: "pixelai.help" admin: "pixelai.admin" reload: "pixelai.admin.reload" ```