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 | 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`) ```yaml # 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 ` | 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`, `/tpaher