🐱 MeowChat

A cute catgirl AI chatbot for your Minecraft server

    /\_/\
   ( o.o )
    > ^ <
   ╔═══════════╗
   ║  MeowChat ║
   ╚═══════════╝

English · 中文介绍

---

✨ Features

• 🤖 Multiple AI Providers — Support for MiniMax, DeepSeek, and OpenRouter
• 💬 Natural Chat — Players mention the bot with @bot in chat
• 🎭 Catgirl Personality — Cute, friendly responses in Chinese with "喵~"
• ⚡ Streaming Responses — Real-time AI responses via action bar
• 🛡️ Rate Limiting — Per-player and global rate limits to prevent abuse
• 🎮 Game Events — AI responds to deaths, rare block mining, achievements
• 🔧 Tools — AI can heal and feed players
• 📊 Statistics — Track bot usage and performance
• 🔊 Sound Effects — Configurable audio feedback

---

🚀 Quick Start

Prerequisites

• Minecraft Paper Server 1.21+
• Java 17+

Installation

# 1. Build the plugin
gradle fatJar

# 2. Copy JAR to plugins folder
cp build/libs/MeowChat.jar /path/to/your/server/plugins/

# 3. Restart your server

# 4. Edit config.yml with your API key
# plugins/MeowChat/config.yml

Configuration

Edit plugins/MeowChat/config.yml:

provider: "deepseek"  # or "minimax", "openrouter"

deepseek:
  key: "your-api-key-here"
  model: "deepseek-chat"

bot:
  name: "bot"           # Mention name (use @bot in chat)
  display_name: "🐱 MeowChat"

---

🎮 Usage

Command	Description
@bot <message>	Chat with the AI bot
/meowchat help	Show help menu
/meowchat reload	Reload configuration
/meowchat stats	Show usage statistics

---

🏗️ Architecture

MeowChat/
├── api/                    # AI client implementations
│   ├── MiniMaxClient       # MiniMax API
│   ├── DeepSeekClient      # DeepSeek API
│   ├── OpenRouterClient    # OpenRouter (non-streaming)
│   └── OpenRouterStreamClient  # OpenRouter (streaming)
├── command/                # Plugin commands
├── config/                  # Configuration management
├── context/                 # Server context for AI prompts
├── listener/                # Event listeners
├── ratelimit/               # Rate limiting
├── sound/                   # Sound effects
├── stats/                   # Statistics tracking
└── tools/                   # AI tools (heal, feed)

---

⚙️ Config Options

Section	Options
provider	AI provider: minimax, openrouter, deepseek
ai.max_tokens	Max response length (default: 150)
ai.temperature	Creativity (0.0-1.0, default: 0.7)
ai.system_prompt	Bot personality prompt
ratelimit.player	Per-player rate limit
ratelimit.global	Global rate limit
events.death/rare_block/achievement	Game event responses
sound.*	Sound effect configuration

---

🔧 Build

gradle fatJar      # Build standalone JAR (recommended)
gradle test        # Run unit tests
gradle clean       # Clean build artifacts

Output: build/libs/MeowChat.jar

---

📝 License

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

---

🙏 Credits

• Powered by MiniMax, DeepSeek, or OpenRouter
• Built with Paper API

---

---

中文介绍

  /\_/\    「喵~ 你好呀！」
 ( ^.o^)   「有什么可以帮到你的吗？」
  > ^ <    「我是 MeowChat！」

MeowChat 是一个运行在 Minecraft Paper 服务器上的 AI 聊天机器人插件。玩家在聊天中输入 @bot 即可与 AI 对话。

特色功能

• 🐱 可爱的猫娘人格，中文对话
• 🤖 支持 MiniMax、DeepSeek、OpenRouter 多种 AI
• ⚡ 实时流式响应
• 🎮 游戏事件触发（死亡、挖矿稀有方块、成就解锁）
• 🔧 AI 工具（治疗、喂食玩家）
• 🛡️ 频率限制防止滥用
• 📊 使用统计

快速开始

gradle fatJar                    # 构建插件
cp build/libs/MeowChat.jar <服务器>/plugins/
# 编辑 plugins/MeowChat/config.yml 填入你的 API Key
# 重启服务器

鸣谢

由 MiniMax、DeepSeek 或 OpenRouter 提供 AI 能力支持。