MemorySkill for ArkOps-Ai

A vector-based conversation memory skill for ArkOps-Ai plugin, built with Alibaba Cloud DashVector and DashScope embedding models.

Features

• 🧠 Vector Memory: Store and retrieve player conversations using vector database technology
• 🎯 Semantic Search: Find relevant conversations based on meaning, not just keywords
• 🔒 Privacy Protection: Players can only access their own conversation records (admins can access all)
• 🌍 Multilingual Support: Supports 100+ languages with text-embedding-v4 model
• 📦 Easy Integration: Seamlessly integrates with ArkOps-Ai plugin framework

Requirements

• PurpurMC 1.21.1 or higher
• Java 21
• Alibaba Cloud DashVector account
• Alibaba Cloud DashScope API Key

Installation

1. Download: Get the latest JAR file from target/memoryskill-1.0.0-Beta.jar
2. Install: Place the JAR file in plugins/ArkOps-Ai/skills/
3. Configure: Edit plugins/ArkOps-Ai/skills/MemorySkill/memory_config.properties
4. Restart: Restart the server to load the skill

Configuration

# DashScope API Key (for embedding generation)
dashscope.api_key=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Embedding model (text-embedding-v4 recommended)
dashscope.embedding_model=text-embedding-v4

# DashVector API Key (for vector storage)
dashvector.api_key=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Collection name in DashVector
dashvector.collection=arkops_memory

# Vector dimension (must match model's output)
dashvector.dimension=1024

# DashVector endpoint URL
dashvector.endpoint=https://vrs-cn-rta4rdkea0001f.dashvector.cn-hangzhou.aliyuncs.com

Usage

Saving Conversations

The AI will automatically call save_conversation when players share:

• Personal information (name, location, age)
• Preferences (favorite color, food, animals)
• Questions (how to build, where to find things)
• Requests and commands
• Stories and experiences
• Goals and plans

Retrieving Conversations

The AI will automatically call get_conversations when players ask:

• "What did I say before?"
• "What do I like?"
• "Remember when..."
• "What questions did I ask?"

Privacy Rules

1. Players: Can only access their own conversation records
2. Admins: Can access all records (need arkops.admin permission or OP status)
3. AI: Will refuse to share other players' information due to privacy protection

Permissions

• arkops.admin: Full access to all memory records
• arkops.memory.admin: Access to memory records (admin permission)

Technical Details

Vector Database

• Service: Alibaba Cloud DashVector
• Metric: Cosine similarity
• Index: Auto-managed by DashVector

Embedding Model

• Model: text-embedding-v4
• Dimension: 1024
• Max Token: 8,192
• Language Support: 100+ languages

Implementation

• Java 21
• Gson for JSON processing
• HTTP API calls to DashVector and DashScope

License

⚠️ This Skill is still in development and internal testing phase, not yet available for public use.

Thank you for your interest, please stay tuned for future releases.

If you are interested in this project, please contact DreamArkMC@163.com to apply for the internal testing program.