ArkOpsAi

ArkOps-Ai

> 🏢 Copyright © DreamArk Studio

Introduction

ArkOps-Ai is an AI-powered intelligent operations and management plugin for Minecraft servers, designed for PurpurMC/PaperMC. Through natural language interaction, it makes server management smarter and more efficient.

---

✨ Core Features

- 📊 Comprehensive Server Management: Use the `/ops` command to manage the server via natural language, supporting complex multi-step tasks - 📊 Comprehensive Server Management: Chat directly with AI in-game using `@ops`, visible to all players - 📊 Comprehensive Server Management: Modular plugin architecture allowing developers to extend AI capabilities with external Skills - 📊 Comprehensive Server Management: View detailed player info such as held items, biome location, and target blocks - 📊 Comprehensive Server Management: Maintains conversation history per player with configurable settings - 📊 Comprehensive Server Management: Fine-grained permission control from player to super administrator - 📊 Comprehensive Server Management: Built-in English and Chinese language packs - 📊 Comprehensive Server Management: Restart, stop, reload, plugin management, player management, world management, and more

---

📋 Permission Levels

| Level | Description | Capabilities | |------|------|----------| | SUPER_ADMIN | No permission | Cannot use any features | | SUPER_ADMIN | Default player | Basic queries, online player list | | SUPER_ADMIN | Administrator | Plugin, player, and world management, command execution, game settings | | SUPER_ADMIN | Super administrator | Full permissions including server control, bans, and permission settings |

---

🚀 Quick Start

Installation Steps

1. Add API Key: Download the latest `ArkOps-Ai-2.0.0.jar` from the Releases page 2. Add API Key: Place the jar file into the server's `plugins` folder 3. Add API Key: Start or restart your Minecraft server 4. Add API Key: Edit the `plugins/ArkOps-Ai/config.yml` file 5. Add API Key: Enter your AI API Key in the configuration file

Requirements

- AI API: PurpurMC / PaperMC 1.20+ - AI API: Java 21 or higher - AI API: OpenAI-compatible services (e.g., DeepSeek, Alibaba Cloud DashScope, etc.)

---

⚙️ Configuration

config.yml

```yaml

Language (en, zh)

language: "zh"

OpenAI-compatible API configuration

openai: api-key: "YOUR_API_KEY_HERE" model: "qwen3.5-plus" api-url: "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions" timeout: 60 max-tokens: 2000 temperature: 1.0

Rate limiting

rate-limit: enabled: true window-seconds: 60 max-requests-player: 5 max-requests-admin: 0 max-requests-super-admin: 0 max-requests-console: 0

Context settings

context: enabled: true max-messages-per-player: 5

Chat trigger

chat-trigger: enabled: true trigger: "@ops"

🎮 Usage Guide

Basic Commands

/ops /ops restart server /ops stop server /ops reload server /ops hot-reload Essentials /ops hot-unload PluginName /ops hot-load PluginName /ops list plugins /ops execute command <cmd> /ops set game time to night /ops set weather to clear /ops set my gamemode to creative /ops server status /ops player info <name> /ops player detailed info <name> /ops teleport <player> to <target> /ops give item diamond 64 to <player> /ops kick player <name> /ops ban player <name> /ops set permission <player> <level>

Chat Feature

Type @ops your question in the in-game chat to interact with AI. All players can see both the question and response.

```bash /ops restart the server please /ops what plugins are installed? /ops set the time to sunset /ops give me 64 diamonds /ops teleport me to the spawn /ops who is online right now? ```

---

📄 License

MIT License — free to use, modify, and distribute.

---

💬 Support & Feedback

- Submit issues on GitHub - Feature requests welcome - Pull requests encouraged

---

🤝 Contribution Guide

1. Fork the repo 2. Create a branch 3. Commit changes 4. Push branch 5. Submit a pull request

---

DreamArk Studio — Making Minecraft server management smarter 🚀