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

• 🤖 AI-Driven Operations: Use the /ops command to manage the server via natural language, supporting complex multi-step tasks
• 💬 @ops Chat Feature: Chat directly with AI in-game using @ops, visible to all players
• 🔌 Skill Extension System: Modular plugin architecture allowing developers to extend AI capabilities with external Skills
• 👤 Player Information Retrieval: View detailed player info such as held items, biome location, and target blocks
• 🧠 Context Memory: Maintains conversation history per player with configurable settings
• 🔐 Four-Level Permission System: Fine-grained permission control from player to super administrator
• 🌍 Internationalization Support: 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
DISABLED	No permission	Cannot use any features
PLAYER	Default player	Basic queries, online player list
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. Download Plugin: Download the latest ArkOps-Ai-2.0.0.jar from the Releases page
2. Deploy Plugin: Place the jar file into the server's plugins folder
3. Start Server: Start or restart your Minecraft server
4. Configure Plugin: Edit the plugins/ArkOps-Ai/config.yml file
5. Add API Key: Enter your AI API Key in the configuration file

Requirements

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

---

⚙️ Configuration

config.yml

# 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 🚀