Sculk Companion

插件

· 作者 emkacztoja

一个 AI 伴侣插件,通过任何兼容 OpenAI 的 API 异步与玩家互动并执行游戏内命令。

0 本站下载 0 关注 更新于 4 个月前

最新 1.1.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

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(本地部署或云端托管)。

安装步骤

  1. 将 Sculk-1.0.0.jar 放入服务器的 plugins/ 目录中。
  2. 启动服务器以生成默认配置文件。
  3. 打开 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 模型
  1. 自定义 plugins/sculk/lore.txt,添加你自己的服务器规则、背景故事和指导原则。
  2. 使用 /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 发送公告。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源