跳到正文

FTB Quests MCP

作者:west3436

一个 FTB Quests MCP 服务器,允许 LLM 代理实时创建和修改 FTB 任务。

收藏

介绍

介绍由机器翻译自 Modrinth 原页面,仅供参考。

FTB Quests Bridge

直接通过 Claude Code,在运行中的 Minecraft 服务器上创作和编辑 FTB Quests 内容。修改通过服务器自身的任务 API 生效,并实时广播给已连接的玩家,因此管理员可以在游戏过程中改写任务书。

这是项目中的服务端模组部分。它会在服务器中运行一个本地回环 HTTP 和 JSON API。配套的 Claude Code 插件(包含 MCP 服务器、技能和斜杠命令)会连接到该 API,并提供 ftbq_* 工具,用于创建、编辑、移动和删除章节、任务、任务目标、奖励及依赖关系。

前置要求

  • Minecraft 1.21.1(NeoForge 或 Fabric)
  • FTB Quests 2101.1.31+、FTB Library 和 Architectury API
  • 运行 Claude Code 的设备上需安装 Node 18 或更新版本

安装模组

  1. 下载适用于你的加载器(Fabric 或 NeoForge)的 jar 文件,并将其与 FTB Quests、FTB Library 和 Architectury API 一起放入服务器的 mods 文件夹。
  2. 启动服务器一次。它会生成 config/ftbquests-bridge/runtime.json,其中包含桥接端口和身份验证令牌;默认绑定到 127.0.0.1。

安装 Claude Code 插件

  1. 添加插件市场:/plugin marketplace add west3436/ftbquests-mcp
  2. 安装插件:/plugin install ftbquests@ftbquests-mcp
  3. 构建 MCP 服务器:在已安装插件的 mcp-server 文件夹中运行 npm install,然后运行 npm run build。
  4. 将插件连接到服务器:将 FTBQUESTS_SERVER_DIR 设置为 Minecraft 实例目录,然后完全重启 Claude Code。
  5. 运行 /ftbq-status 进行验证。结果应显示 questsLoaded: true,并列出你的章节。

完整的设置、配置和故障排除说明:https://github.com/west3436/ftbquests-mcp

常见问题

FTB Quests MCP 支持哪些 Minecraft 版本?

FTB Quests MCP 支持 Minecraft Java 版 1.21.1,可用的加载器:Fabric / NeoForge。下载时注意选择和你游戏版本一致的文件。

FTB Quests MCP 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric / NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。运行环境:仅服务端。

评论

登录后评论和评分

west3436 的其他作品

查看全部 →