💬︎ ChatBuddy – 随性的 AI 伙伴 💬︎
“让你的 Minecraft 服务器真正充满活力。”
✔ 自主运行 • ✔ 可点击支持 • ✔ 多重人格 • ✔ 零延迟 • ✔ 高度可配置
MC 版本: 1.16 – 1.21+ • NSR-AI Core: v1.4+ • API 版本: v3.0-pre+
类型: NSR-AI 插件集成 • 开发者: BlackForge
🌐︎ 什么是 ChatBuddy?
ChatBuddy 是 NSR-AI 生态系统的先进集成方案。与仅在通过命令触发时才发言的传统 AI 机器人不同,ChatBuddy 直接存在于服务器的聊天流中。它是一个完全自主、高度智能的伙伴,能够有机地参与玩家的对话,对游戏事件做出反应,并在服务器冷清时打破沉默。
注意:ChatBuddy 需要基础 NSR-AI 插件以及 NSR-AI API v3.0-pre+ 才能正常运行。
🚀︎ 为什么选择 ChatBuddy
- 真正的自主性 — 玩家无需使用
/ai 命令即可与其交谈。ChatBuddy 原生读取聊天内容,并根据概率和上下文决定何时介入对话。
- 难以置信的人性化 — 凭借终极 Gamer Prompt(玩家提示词),ChatBuddy 会使用俚语、讲笑话并保持角色设定。它被编程为像真实玩家一样行动,而非机器人。
- 集成式支持 — 发现 bug?你可以直接在 GitHub 上报告,或者留在游戏中直接询问 Buddy 获取链接!只需说:“Hey Buddy, I want to report a bug, give me the link” 或提及 “bug” 或 “error” 的类似语句。如果 Buddy 没有立即提供链接,请尝试更清晰地提问,他将在聊天中为你生成一个加粗、蓝色、可点击的链接。
- API 成本节约波次系统 — 如果多名玩家在同一时间加入,ChatBuddy 会智能地将他们合并为一个问候波次,从而为你节省大量的 API 令牌成本。
- 轻量级且线程安全 — 基于 Spigot 的异步线程池、Atomic 变量和严格的内存管理构建。它绝不会拖慢你的主服务器线程。
🛠︎ 核心功能
? 智能对话触发机制
- 模糊关键词检测: 当玩家提及特定主题(如“钻石”、“帮助”或“卡顿”)时,ChatBuddy 的回复概率会动态提升。它内置了先进的 Levenshtein Distance 算法,能够完美识别诸如 "daimonds" 这样的拼写错误。
- 伙伴提及: 如果玩家在句子中随意输入 “Hey Buddy”、“Buddy” 或 “CB”,AI 会通过智能正则表达式边界检测到这些提及,并几乎保证做出回应。
- 加入延迟与冷却时间: Buddy 会等待 10 秒让玩家安顿下来后再打招呼,并包含 2 分钟的重新加入冷却时间,以防止连接不稳定的玩家刷屏问候。
- “破冰者”(非活跃引擎): 如果服务器聊天完全沉默一段设定好的时间(例如 10 分钟),ChatBuddy 将自动发送一条消息以开启新的对话。
- 消息计数保证: 您可以配置 ChatBuddy 确保每 X 条消息恰好回复一次,从而让 AI 为您的社区保持完美的活跃度。
? 个性与游戏感知
- 动作/事件挂钩: ChatBuddy 会积极观察服务器动态。它会针对 玩家死亡(根据死亡方式给出机智评论)和 成就达成 发表祝贺。
- 上下文记忆缓冲区: 它在发言前会无缝读取最近 15 条消息(可自定义),确保它能理解内部梗、服务器背景故事以及玩家当前的情绪状态。
- 多人格引擎: 将核心的“玩家”基础与配置文件中随机选取的特质列表(例如“友好”、“愤世嫉俗的幸存者”、“兴奋的新手”)相结合,使互动始终保持新鲜感。
⚙️ 后端控制
- 模型与提供商覆盖: 可以直接在 ChatBuddy 配置中强制 AI 使用特定的提供商,如 OpenAI 或 Claude。
- 智能 API 密钥路由: 它会自动尝试使用触发对话的玩家的个人 API 密钥。如果该玩家没有密钥,则会回退到服务器的全局密钥。
📜︎ 命令与权限
命令
/chatbuddy reload (别名: /cb reload) — 即时热重载 config.yml 配置文件。
权限
chatbuddy.admin — 用于执行重载命令所需权限。
示例配置 (`config.yml`)
# ChatBuddy: 高级配置
# --- 1. 概率设置 ---
base-chance: 0.2
mention-chance: 80.0
messages-until-reply: 8
min-players: 1
cooldown-seconds: 60
# --- 2. 模糊关键词增益 ---
keyword-boosts:
diamonds: 50.0
help: 60.0
lag: 70.0
admin: 90.0
fuzzy-sensitivity: 7
--- 3. 人格设定 ---
personalities:
- "你是一位休闲、随性的 Minecraft 老玩家,热爱建造,讨厌苦力怕。你喜欢开玩笑。"
- "你是一位兴奋的新手玩家,觉得一切都棒极了。你会使用“bro”、“man”、“rip”等俚语。"
- "你是一位略带讽刺的幸存者,因为掉进岩浆而死过太多次。你很友善但言辞机智。"
- "你是一位非常友好、乐于助人的玩家,喜欢帮助他人。你总是保持积极态度,并为其他玩家加油打气。"
--- 4. 不活跃触发器 ---
inactivity:
enabled: true
minutes: 10
chance: 100.0
--- 5. API 密钥与优先级逻辑 ---
api-priority: "AUTO"
api-provider: "AUTO"
api-model: "AUTO"
silent-key-failure: true
--- 6. 上下文 ---
context-window: 15
broadcast-prefix: "&8[&bAI&8] &f"
</details>
---
<center>
[](https://modrinth.com/plugin/chatbuddy) [](https://github.com/BlackForgeStudio/ChatBuddy/issues/new/choose) [](https://modrinth.com/plugin/chatbuddy/versions)
</center>
<p align="center">
<b>以更智能的游戏体验,为你的世界注入活力。</b><br>
<i>由 BlackForge Studio 开发</i>
</p>
💬︎ ChatBuddy – The Spontaneous AI Companion 💬︎
“Making your Minecraft server feel truly alive.”
✔ Autonomous • ✔ Clickable Support • ✔ Multi-Personality • ✔ Zero Lag • ✔ Highly Configurable
MC Versions: 1.16 – 1.21+ • NSR-AI Core: v1.4+ • API Version: v3.0-pre+
Type: NSR-AI Plugin Integration • Developer: BlackForge
🌐︎ What is ChatBuddy?
ChatBuddy is an advanced integration for the NSR-AI ecosystem. Unlike traditional AI bots that only speak when spoken to via a command, ChatBuddy lives directly inside your server's chat stream. It is a fully autonomous, highly intelligent companion that organically participates in player conversations, reacts to game events, and breaks the ice when the server goes quiet.
Note: ChatBuddy requires the base NSR-AI plugin and the NSR-AI API v3.0-pre+ to function.
🚀︎ Why Choose ChatBuddy
- True Autonomy — Players don't need to use
/ai to talk to it. ChatBuddy reads the chat natively and decides when to jump into the conversation based on probability and context.
- Unbelievably Human — Powered by the ultimate Gamer Prompt, ChatBuddy uses slang, cracks jokes, and stays in character. It is programmed to act like a real player, not a robot.
- Integrated Support — Found a bug? You can report it directly on GitHub or stay in-game and just ask Buddy for the link! Simply say: "Hey Buddy, I want to report a bug, give me the link" or similar phrasing mentioning "bug" or "error." If Buddy doesn't provide the link immediately, try asking more clearly, and he will generate a bold, blue clickable link in the chat for you.
- API Cost-Saving Wave System — If multiple players join around the same time, ChatBuddy intelligently batches them into a single greeting wave, saving you significant API token costs.
- Lightweight & Thread-Safe — Built with Spigot's Async thread pools, Atomic variables, and strict memory management. It will never lag your main server thread.
🛠︎ Core Features
? Intelligent Conversational Triggers
- Fuzzy Keyword Detection: If players mention specific topics (like "diamonds", "help", or "lag"), ChatBuddy's chance to respond jumps dynamically. It includes an advanced Levenshtein Distance algorithm, meaning it will perfectly detect typos like "daimonds".
- Buddy Mentions: If a player casually types "Hey Buddy", "Buddy", or "CB" in the middle of a sentence, the AI detects it via smart regex boundaries and almost guarantees a response.
- Join Delay & Cooldown: Buddy waits 10 seconds for players to settle in before greeting them, and includes a 2-minute rejoin cooldown to prevent greeting spam from players with unstable connections.
- The "Icebreaker" (Inactivity Engine): If the server chat goes completely silent for a set amount of time (e.g., 10 minutes), ChatBuddy will automatically send a message to start a new conversation.
- Message Counter Guarantee: Configure ChatBuddy to guarantee a response exactly every X messages, ensuring the AI is perfectly active for your community.
? Personality & Game Awareness
- Action/Event Hooking: ChatBuddy actively watches the server. It will comment on Player Deaths (with a witty remark based on how they died) and congratulate players on Achievements.
- Contextual Memory Buffer: It seamlessly reads the last 15 messages (customizable) before it speaks, ensuring it understands inside jokes, server lore, and the current mood of the players.
- Multi-Personality Engine: Combines a core "Gamer" foundation with a randomized list of traits from the config (e.g., "friendly", "salty survivor", "excited newbie") to keep interactions fresh.
⚙️ Backend Control
- Model & Provider Overrides: Force the AI to use specific providers like OpenAI or Claude, directly in the ChatBuddy config.
- Smart API Key Routing: It automatically attempts to use the personal API key of the player who triggered the conversation. If they don't have one, it falls back to the Server's Global Key.
📜︎ Commands & Permissions
Commands
/chatbuddy reload (Alias: /cb reload) — Hot-reloads the config.yml instantly.
Permissions
chatbuddy.admin — Required to use the reload command.
Example Configuration (`config.yml`)
# ChatBuddy: Advanced Configuration
# --- 1. Probability Settings ---
base-chance: 0.2
mention-chance: 80.0
messages-until-reply: 8
min-players: 1
cooldown-seconds: 60
# --- 2. Fuzzy Keyword Boosts ---
keyword-boosts:
diamonds: 50.0
help: 60.0
lag: 70.0
admin: 90.0
fuzzy-sensitivity: 7
# --- 3. Personalities ---
personalities:
- "You are a casual, laid-back Minecraft veteran who loves building and hates creepers. You joke around."
- "You are an excited newer player who thinks everything is awesome. You use slang like 'bro', 'man', 'rip'."
- "You are a slightly sarcastic survivor who has died too many times to lava. You are friendly but witty."
- "You are a very friendly, supportive gamer who loves helping others out. You always try to be positive and hype up your fellow players."
# --- 4. Inactivity Trigger ---
inactivity:
enabled: true
minutes: 10
chance: 100.0
# --- 5. API Key & Priority Logic ---
api-priority: "AUTO"
api-provider: "AUTO"
api-model: "AUTO"
silent-key-failure: true
# --- 6. Context ---
context-window: 15
broadcast-prefix: "&8[&bAI&8] &f"
Powering your world with smarter gameplay.
Developed by BlackForge Studio
评论 0
登录后参与评分
还没有评论,来抢沙发吧