Sculk Companion:AI 驱动的服务器助手
Sculk Companion 将大型语言模型直接集成到服务器聊天中,创建一个能够记住玩家、追踪关系、分配任务、处理献祭并执行游戏内命令的互动伴侣。该插件支持任何兼容 OpenAI 的 LLM API,如 DeepSeek、OpenAI、Ollama、LM Studio 或 vLLM。
主要功能
与具有持久记忆的 AI 聊天
- 通过在服务器聊天中使用
sculk 关键词或命令(/ask <问题> 或 /sculk ask <问题>)与 Sculk 对话。
- 切换 聊天模式(
/sculk toggle),将所有消息直接发送给 Sculk。
- 每个玩家拥有独立的持久化对话历史,以 JSON 配置文件形式本地存储。
- 通过
config.yml 和 lore.txt 自由注入角色性格与背景设定。
动态关系与好感度系统
- 记录玩家的好感度分数,范围从 -100(敌对) 到 +100(忠诚)。
- AI 会根据玩家的互动情况动态更新此分数。
- 高好感度会解锁诸如治疗、赠送物品和提供增益等辅助行为。
- 低好感度会使 Sculk 表现出敌意、冷漠或讽刺的态度。
- 正向的关系变化设有 2 分钟的冷却时间以防止刷取,但涉及高价值物品时不受此限制。
交互式献祭系统
- 手持任意物品并请求 Sculk 将其作为祭品接受。
- AI 会评估该物品的价值,并相应地调整你的关系分数。
- 交易安全:仅在关系更新成功时才会消耗物品。如果冷却时间阻止了更新,你手中的物品将保留原样。
游戏内任务系统
- Sculk 可以向你分配 KILL_MOB(击杀生物)或 COLLECT_ITEM(收集物品)类型的任务。
- 针对击杀僵尸或收集铜锭等目标,进度会自动追踪。
- 通过动作栏通知显示实时进度,并配有自定义粒子效果和音效反馈。
地标与传送
- 在对话期间以自定义名称保存坐标(例如“我的基地”、“传送门”)。
- 让 Sculk 将你传送到任意已保存的地标。
AI 工具权限与系统(18 项操作)
Sculk 可以访问标准的游戏内命令和工具,并在聊天循环中执行:
| 工具名称 |
所需好感度 |
描述 |
heal_player |
30+ |
完全恢复玩家生命值并补充饥饿值 |
gift_item_to_player |
20+ |
在玩家脚下掉落指定的物品 |
apply_potion_effect |
10+ |
给予药水增益效果(如速度、夜视等) |
play_sound |
0+ |
本地触发 Bukkit 音效 |
spawn_particles |
0+ |
生成装饰性粒子效果 |
execute_console_command |
0+ |
运行白名单内的命令 |
save_landmark |
0+ |
将当前位置保存为地标 |
teleport_to_landmark |
0+ |
将玩家传送至已保存的位置 |
start_quest |
0+ |
分配新的怪物狩猎或收集任务 |
check_quest_status |
任意 |
检查/刷新当前活跃任务的进度 |
complete_quest |
任意 |
任务完成后清除活跃任务状态 |
modify_relationship |
任意 |
调整好感度分数 |
sacrifice_held_item |
任意 |
消耗手中物品以增加好感度 |
remember_player_fact |
任意 |
记住细节信息(长期记忆) |
kick_player |
0+ |
踢出玩家(需要 sculk.sudo 权限) |
teleport_player |
0+ |
传送玩家(需要 sculk.sudo.teleport 权限) |
get_server_status |
0+ |
显示 TPS 和内存使用情况(需要 sculk.sudo.monitor 权限) |
broadcast_announcement |
0+ |
广播公告(需要 sculk.sudo.broadcast 权限) |
配置与设置
要求
- 服务器引擎: Paper、Spigot 或兼容分支(例如 Purpur)。
- Minecraft 版本: 1.20+(目标支持 1.20 - 1.26.x+)
- Java 版本: 25+
- LLM API 提供商: 任何 OpenAI 兼容的 API(本地部署或云端托管)。
安装步骤
- 将
Sculk-1.0.0.jar 放入服务器的 plugins/ 目录中。
- 启动服务器以生成默认配置文件。
- 打开
plugins/sculk/config.yml 并填入你的 API URL 和 Token:
api:
url: "[https://api.deepseek.com/chat/completions](https://api.deepseek.com/chat/completions)" # 你的端点地址
token: "your-api-key-here" # 你的 API 密钥
model: "deepseek-v4-flash" # LLM 模型
- 自定义
plugins/sculk/lore.txt,添加你自己的服务器规则、背景故事和指导原则。
- 使用
/sculk reload 命令重新加载配置,或者重启服务器。
权限
sculk.use(默认:true)- 允许玩家与幽匿互动。
sculk.admin(默认:op)- 访问配置重载功能。
sculk.sudo(默认:op)- 允许 AI 根据请求踢出玩家。
sculk.sudo.teleport(默认:op)- 允许 AI 传送玩家。
sculk.sudo.monitor(默认:op)- 允许 AI 访问服务器状态指标。
sculk.sudo.broadcast(默认:op)- 允许 AI 发送公告。
Sculk Companion: AI-Powered Server Helper
Sculk Companion integrates Large Language Models directly into your server chat, creating an interactive companion that remembers players, tracks relationships, assigns quests, handles sacrifices, and runs in-game commands. The plugin is powered by any OpenAI-compatible LLM API like DeepSeek, OpenAI, Ollama, LM Studio, or vLLM.
Key Features
AI Chat with Persistent Memory
- Talk to Sculk via server chat using the
sculk keyword or commands (/ask <question> or /sculk ask <question>).
- Toggle Chat Mode (
/sculk toggle) to route all your messages straight to Sculk.
- Per-player persistent conversation history stored locally as JSON profiles.
- Free-form personality and lore injection via
config.yml and lore.txt.
Dynamic Relationship & Affection System
- Tracks a player affection score ranging from -100 (Hostile) to +100 (Devoted).
- The AI dynamically updates this score based on player interactions.
- High affection levels unlock helpful actions like healing, item gifting, and buffs.
- Low affection makes Sculk hostile, cold, or sarcastic.
- Positive relationship changes have a 2-minute cooldown to prevent spam, which is bypassed for high-value items.
Interactive Sacrifice System
- Hold any item in your hand and ask Sculk to accept it as a sacrifice.
- The AI evaluates the item's worth and modifies your relationship score accordingly.
- Transaction Safety: Items are only consumed if the relationship update succeeds. If the cooldown blocks it, your item stays safe in your hand.
In-Game Questing
- Sculk can assign you KILL_MOB or COLLECT_ITEM quests.
- Progress is tracked automatically for objectives like killing zombies or collecting copper.
- Displays real-time progress via action-bar notifications with custom particle and sound feedback.
Landmarks & Teleportation
- Save coordinates under a custom name during conversation (e.g., "my base", "portal").
- Ask Sculk to teleport you back to any of your saved landmarks.
AI Tool Permissions & System (18 Actions)
Sculk has access to standard in-game commands and tools it can execute during chat loops:
| Tool Name |
Affection Required |
Description |
heal_player |
30+ |
Fully restores health and feeds the player |
gift_item_to_player |
20+ |
Drops requested items at the player's feet |
apply_potion_effect |
10+ |
Gives potion buffs (Speed, Night Vision, etc.) |
play_sound |
0+ |
Triggers a Bukkit sound locally |
spawn_particles |
0+ |
Spawns cosmetic particles |
execute_console_command |
0+ |
Runs whitelisted commands |
save_landmark |
0+ |
Saves current location under a name |
teleport_to_landmark |
0+ |
Teleports player to a saved location |
start_quest |
0+ |
Assigns a new mob-hunting or collecting quest |
check_quest_status |
Any |
Checks/refreshes active quest progress |
complete_quest |
Any |
Clears active quest after completion |
modify_relationship |
Any |
Adjusts affection score |
sacrifice_held_item |
Any |
Consumes hand item to gain affection |
remember_player_fact |
Any |
Remembers details (long-term memory) |
kick_player |
0+ |
Kicks player (requires sculk.sudo permission) |
teleport_player |
0+ |
Teleports players (requires sculk.sudo.teleport permission) |
get_server_status |
0+ |
Displays TPS and RAM (requires sculk.sudo.monitor permission) |
broadcast_announcement |
0+ |
Broadcasts announcements (requires sculk.sudo.broadcast permission) |
Configuration & Setup
Requirements
- Server Engine: Paper, Spigot, or compatible forks (e.g., Purpur).
- Minecraft Version: 1.20+ (Targeted for 1.20 - 1.26.x+)
- Java Version: 25+
- LLM API Provider: Any OpenAI-compatible API (local or cloud-hosted).
Installation Steps
- Place the
Sculk-1.0.0.jar into your server's plugins/ directory.
- Start the server to generate default configurations.
- Open
plugins/sculk/config.yml and insert your API URL and Token:
api:
url: "[https://api.deepseek.com/chat/completions](https://api.deepseek.com/chat/completions)" # Your endpoint
token: "your-api-key-here" # Your API key
model: "deepseek-v4-flash" # LLM Model
- Customize
plugins/sculk/lore.txt with your own server rules, backstory, and guidelines.
- Reload config using
/sculk reload or restart your server.
Permissions
sculk.use (Default: true) - Allows players to talk to Sculk.
sculk.admin (Default: op) - Access to config reloading.
sculk.sudo (Default: op) - Allows AI to kick players on request.
sculk.sudo.teleport (Default: op) - Allows AI to teleport players.
sculk.sudo.monitor (Default: op) - Allows AI to access server status metrics.
sculk.sudo.broadcast (Default: op) - Allows AI to send announcements.
评论 0
登录后参与评分
还没有评论,来抢沙发吧