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

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