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

Model	Provider	API Format
deepseek-v4-pro	DeepSeek	OpenAI
deepseek-v4-flash	DeepSeek	OpenAI
kimi-k2-6	Kimi (Moonshot)	OpenAI
qwen3.7-plus	Qwen (Alibaba)	OpenAI
qwen3.7-max	Qwen (Alibaba)	OpenAI
glm-5.1	GLM (ZhipuAI)	OpenAI
minimax-m3	MiniMax	Anthropic

---

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

Command	Description
/syai chat true	Enable AI chat mode — all messages are sent to AI
/syai chat false	Disable AI chat mode
/syai task <requirement>	Let AI take over your client to complete a task
/syai task cancel	Cancel the current AI task
/syai api <model> <key>	Set your personal API key for a model
/syai model [name]	View or change your active model
/syai status	View your current status
/syai reload	Reload configuration (admin only)

---

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)

Tool	Description
execute_command	Execute a player command (admin commands are blocked)
send_message	Send a chat message
move_to	Teleport to specific coordinates
move_forward	Move forward in the facing direction
look_at	Change view direction (yaw/pitch)
get_position	Get current position and direction
get_inventory	View inventory contents
place_block	Place a block from inventory
break_block	Break a block
attack_entity	Attack the nearest entity
interact_chest	View/deposit/withdraw chest items
drop_item	Drop items from inventory
switch_hotbar	Switch held hotbar slot (0-8)
switch_hand_item	Swap items between two inventory slots
use_item	Consume/use held item
get_nearby_blocks	Scan nearby blocks
get_nearby_entities	List nearby entities
finish_task	Signal task completion

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

Permission	Default	Description
syai.use	true (everyone)	Access to all SyAI commands
syai.admin	op	Access to /syai reload

---

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.

---

.