# ArkOps-Ai<\/p>\n
> \ud83c\udfe2 Copyright \u00a9 DreamArk Studio<\/p>\n
## Introduction<\/p>\n
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.<\/p>\n
—<\/p>\n
## \u2728 Core Features<\/p>\n
– **\ud83e\udd16 AI-Driven Operations**: Use the `\/ops` command to manage the server via natural language, supporting complex multi-step tasks
\n– **\ud83d\udcac @ops Chat Feature**: Chat directly with AI in-game using `@ops`, visible to all players
\n– **\ud83d\udd0c Skill Extension System**: Modular plugin architecture allowing developers to extend AI capabilities with external Skills
\n– **\ud83d\udc64 Player Information Retrieval**: View detailed player info such as held items, biome location, and target blocks
\n– **\ud83e\udde0 Context Memory**: Maintains conversation history per player with configurable settings
\n– **\ud83d\udd10 Four-Level Permission System**: Fine-grained permission control from player to super administrator
\n– **\ud83c\udf0d Internationalization Support**: Built-in English and Chinese language packs
\n– **\ud83d\udcca Comprehensive Server Management**: Restart, stop, reload, plugin management, player management, world management, and more <\/p>\n
—<\/p>\n
## \ud83d\udccb Permission Levels<\/p>\n
| Level | Description | Capabilities |
\n|——|——|———-|
\n| **DISABLED** | No permission | Cannot use any features |
\n| **PLAYER** | Default player | Basic queries, online player list |
\n| **ADMIN** | Administrator | Plugin, player, and world management, command execution, game settings |
\n| **SUPER_ADMIN** | Super administrator | Full permissions including server control, bans, and permission settings |<\/p>\n
—<\/p>\n
## \ud83d\ude80 Quick Start<\/p>\n
### Installation Steps<\/p>\n
1. **Download Plugin**: Download the latest `ArkOps-Ai-2.0.0.jar` from the Releases page
\n2. **Deploy Plugin**: Place the jar file into the server’s `plugins` folder
\n3. **Start Server**: Start or restart your Minecraft server
\n4. **Configure Plugin**: Edit the `plugins\/ArkOps-Ai\/config.yml` file
\n5. **Add API Key**: Enter your AI API Key in the configuration file <\/p>\n
### Requirements<\/p>\n
– **Minecraft Server**: PurpurMC \/ PaperMC 1.20+
\n– **Java Version**: Java 21 or higher
\n– **AI API**: OpenAI-compatible services (e.g., DeepSeek, Alibaba Cloud DashScope, etc.) <\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### config.yml<\/p>\n
“`yaml
\n# Language (en, zh)
\nlanguage: “zh”<\/p>\n
# OpenAI-compatible API configuration
\nopenai:
\n api-key: “YOUR_API_KEY_HERE”
\n model: “qwen3.5-plus”
\n api-url: “https:\/\/dashscope.aliyuncs.com\/compatible-mode\/v1\/chat\/completions”
\n timeout: 60
\n max-tokens: 2000
\n temperature: 1.0<\/p>\n
# Rate limiting
\nrate-limit:
\n enabled: true
\n window-seconds: 60
\n max-requests-player: 5
\n max-requests-admin: 0
\n max-requests-super-admin: 0
\n max-requests-console: 0<\/p>\n
# Context settings
\ncontext:
\n enabled: true
\n max-messages-per-player: 5<\/p>\n
# Chat trigger
\nchat-trigger:
\n enabled: true
\n trigger: “@ops”<\/p>\n
## \ud83c\udfae Usage Guide ### Chat Feature<\/p>\n Type @ops your question in the in-game chat to interact with AI. All players can see both the question and response.<\/p>\n “`bash — MIT License \u2014 free to use, modify, and distribute.<\/p>\n —<\/p>\n ## \ud83d\udcac Support & Feedback<\/p>\n – Submit issues on GitHub —<\/p>\n ## \ud83e\udd1d Contribution Guide<\/p>\n 1. Fork the repo —<\/p>\n **DreamArk Studio** \u2014 Making Minecraft server management smarter \ud83d\ude80<\/p>\n","protected":false},"excerpt":{"rendered":" Intelligent Server Management Assistant<\/p>\n","protected":false},"featured_media":18880,"template":"","meta":{"_minecraft_slug":"arkopsai","_minecraft_project_id":"5NlNrVxy","_minecraft_author":"Nebulae","_minecraft_license":"MIT","_minecraft_downloads":3,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"arkopsai.zip","_minecraft_size_bytes":3193940,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:20:32.274929Z","_minecraft_date_created":"2026-05-05T23:01:52.882039Z","_minecraft_date_modified":"2026-04-27T11:39:10.956836Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/arkopsai","_minecraft_icon_attachment_id":18880,"_minecraft_imported_at":"2026-05-31T20:12:42+00:00","_minecraft_import_hash":"1e658448aad3bd09dd86746ca5924b59","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,867,123,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-18879","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n### Basic Commands
\n\/ops
\n\/ops restart server
\n\/ops stop server
\n\/ops reload server
\n\/ops hot-reload Essentials
\n\/ops hot-unload PluginName
\n\/ops hot-load PluginName
\n\/ops list plugins
\n\/ops execute command
\n\/ops set game time to night
\n\/ops set weather to clear
\n\/ops set my gamemode to creative
\n\/ops server status
\n\/ops player info
\n\/ops player detailed info
\n\/ops teleport
\n\/ops give item diamond 64 to
\n\/ops ban player
\n\/ops set permission
\n\/ops restart the server please
\n\/ops what plugins are installed?
\n\/ops set the time to sunset
\n\/ops give me 64 diamonds
\n\/ops teleport me to the spawn
\n\/ops who is online right now?
\n“`<\/p>\n
\n## \ud83d\udcc4 License<\/p>\n
\n– Feature requests welcome
\n– Pull requests encouraged <\/p>\n
\n2. Create a branch
\n3. Commit changes
\n4. Push branch
\n5. Submit a pull request <\/p>\n