SyAI

SyAI - AI Integration Plugin for Minecraft

SyAI connects Minecraft players to AI models, enabling AI-powered chat conversations and autonomous task execution directly in-game.

Supported AI Models

Installation

1. Download SyAI.jar and place it in your server's plugins/ folder.
2. Start/restart the server.
3. Edit plugins/SyAI/config.yml to configure API keys (see below).
4. Use /syai reload to reload configuration without restarting.

Configuration (config.yml)

# Whether to use admin-provided API keys
# If true, players will use the keys configured below
# If false, players must provide their own API keys via /syai api
use-admin-api: true

# Admin API keys (only used if use-admin-api is true)
admin-api-keys:
  deepseek-v4-pro: "sk-your-key-here"
  deepseek-v4-flash: "sk-your-key-here"
  kimi-k2-6: "sk-your-key-here"
  qwen3.7-plus: "sk-your-key-here"
  qwen3.7-max: "sk-your-key-here"
  glm-5.1: "your-key-here"
  minimax-m3: "your-key-here"

# Default model for chat and tasks
default-model: "deepseek-v4-flash"

# Maximum context messages for chat
max-context: 100

# AI task settings
task:
  max-rounds: 50
  action-delay: 10

Two API Key Modes

Admin Mode (use-admin-api: true):
All players share the API keys configured by the admin. Players do not need to configure anything.

Player Mode (use-admin-api: false):
Each player must provide their own API key using /syai api <model> <key>. Keys are stored in a local JSON file (api_keys.json).

Commands

AI Chat Mode

When chat mode is enabled, every message the player sends in chat is forwarded to the AI. The AI responds with the conversation context.

• 100 messages of context are maintained per player.
• The AI is aware of the player's Minecraft username.
• The AI responds in the same language the player uses.
• Context is cleared when chat mode is disabled or the player logs out.

AI Task Mode

AI tasks allow the AI to take control of a player's client and perform actions in the world. The AI uses function calling (tool use) to interact with the game.

Available Tools (18 tools)

Command Security

For security, AI cannot execute administrative commands. The following command types are blocked:

• Bans/punishment: /ban, /ban-ip, /kick, /mute, /warn, /jail, /tempban, /ipban, /pardon, /unban, /unmute
• Operator: /op, /deop, /stop, /restart, /reload, /plugins, /pl, /whitelist
• Game manipulation: /kill, /gamemode, /give, /xp, /enchant, /effect, /summon, /clear, /difficulty, /gamerule, /time, /weather
• World editing: /setblock, /fill, /clone, /setworldspawn, /worldborder, // (WorldEdit)
• Economy manipulation: /eco, /economy, /money give, /money take, /money set
• Permissions: /lp, /luckperms, /perm, /pex, /groupmanager
• Server control: /save-all, /save-off, /save-on, /timings, /spark, /paper, /purpur
• Invasion: /invsee, /openinv, /vanish, /sudo, /force, /socialspy, /spectate

Allowed commands include: /tpa, /tpahere, /tpaccept, /res tp, /money, /pay, /home, /spawn, /warp, /msg, /kit, /trade, /shop, /ah, /fly, /nick, and other common player commands.

Permissions

API Key Privacy

• Player API keys are stored locally in plugins/SyAI/api_keys.json (JSON file).
• Keys are never transmitted to third parties — they are only used to call the respective AI provider's API.
• When use-admin-api is enabled, individual player keys are not required.

.