🤖 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 <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: [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 <prompt>
  use_global: "pixelai.use.global"   # Required for @AI in chat
  help: "pixelai.help"
  admin: "pixelai.admin"
  reload: "pixelai.admin.reload"