🤖 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 OpenRouter 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 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

--- Storage Settings ---

storage: type: "YAML" # Options: YAML, MYSQL mysql: host: "localhost" port: 3306 database: "pixelai" username: "root" password: "" use-ssl: false

--- Rate Limiting ---

Permission: [max_requests, time_in_seconds]

limits: private: pixelai.limit.admin: [-1, 0] # Admins: Infinite pixelai.limit.vip: [50, 86400] # VIPs: 50/day pixelai.limit.default: [10, 3600] # Default: 10/hour global: pixelai.limit.admin: [-1, 0] # Admins: Infinite pixelai.limit.vip: [20, 3600] # VIPs: 20/hour pixelai.limit.default: [5, 3600] # 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 use_global: "pixelai.use.global" # Required for @AI in chat help: "pixelai.help" admin: "pixelai.admin" reload: "pixelai.admin.reload"