MythxEngine

MythxEngine — 基于 MCP 的桌面角色扮演游戏引擎

一套完整的桌面角色扮演游戏引擎，可由 AI 运行：确定性骰子、五档结果、 FitD 风格的压力机制、战斗追踪、情境时钟、调查、NPC 关系、世界生成——通过 模型上下文协议提供 134 种工具，内置四个完整的 入门世界。

Claude（或任何 MCP 客户端）将成为你的游戏主持人。引擎确保规则严谨：相同种子 + 相同行动 = 相同结果。

安装

Claude Code — 插件（技能 + 工具，推荐）

/plugin marketplace add protoLabsAI/mythx-mcp
/plugin install rpg@mythx-plugins

一次安装即可获得 MCP 服务和游戏技能（/rpg:play、 /rpg:combat-mode、/rpg:world-building-mode，等等）。

Claude Code — 仅工具

claude mcp add rpg -- npx -y @mythxengine/mcp-server

需要 Node >= 22.13。

Claude Desktop

从最新发行版下载 mythxengine-<version>.mcpb，然后将其拖入设置 → 扩展。无需其他设置——Claude Desktop 自带 Node 运行时。

五分钟快速体验

以下内容是在安装后与 Claude 进行的一段对话。首次运行时会导入四个世界——港口米里亚姆（港口黑色电影风格）、艾瑟尔加德（神话边疆）、深渊门槛（诡异深海）和树屋选集。

1. 选择一个世界，创建角色。

在港口米里亚姆开启一场游戏。我想扮演一个码头掮客，欠了不该欠的人的钱。

游戏主持人会调用 create_session、load_world_summary 和 create_character—— 你的掮客将获得生命值、压力、装备，并在世界的派系关系网中占有一席之地。

**2. 掷骰，承担真实风险。**每次检定都会明确位置（失败会有多糟？）和效果（成功能带来多少收益？）：

我想溜过港口巡逻队，去找走私者的小艇。

roll_test → risky position / standard effect → 11 vs 13: partial
"Yes, but..." — you reach the skiff, and a lantern swings your way.
GM move suggested: put_someone_in_spot

结果分为五档——大成功、成功、部分成功、失败、大失败——掷出糟糕结果时，你可以使用 push_roll（花费 2 点压力换取 +1d6），或使用 resist_consequence 降低后果的严重程度。压力是一种真正的货币； 溢出会导致创伤。

3. 打一回合战斗。

两名码头工人挡住了舷梯。我拔出钩刀。

start_combat → roll_initiative → attack——先攻顺序、护甲、 状态和伤害都会被追踪；每次攻击都会返回相同的五档结果，并在未命中时建议游戏主持人采取的行动。

**4. 看着时钟走动。**你刚躲过的巡逻队呢？游戏主持人启动了一个 harbor-alert 时钟。只要失败后继续推进足够多次（接入后，部分成功/失败时会自动触发 tick_clock），码头的灯就会亮起——后果会按时到来，而不是凭空发生。

循环就是这样：输入故事，输出机制，后果由时钟掌控。

包含内容

部件	提供内容
packages/mcp-server	MCP 服务 — 134 个工具，以 @mythxengine/mcp-server 发布
packages/engine	纯净、可设定种子的游戏机制（骰子、结果、战斗）
packages/types / worlds / rulebook	每种实体都经过 Zod 验证的架构，以及规则查询
packages/storage	SQLite 持久化（node:sqlite，零原生依赖）
packages/tools / prompts	与传输方式无关的工具实现 + 运行时 GM 技能
world-builder/	rpg Claude Code 插件（技能、Agent、钩子）
agent-kit/	适用于任何 Agent 的通用 GM 系统提示词 + 操作手册
docs/	规则手册 + 引擎工作原理
4 个内置世界	约 13 MB 的 NPC、派系、地点、情境、故事线 — 演示内容

规则与文档

• docs/RULEBOOK.md — 完整规则，共 12 章 （结果、位置与效果、检定、压力、战斗、状态、装备、时间与时钟、GM 行动）。 由 packages/rulebook 生成，lookup_rule 和 generate_rulebook 工具也使用同一 来源，因此内容始终与引擎保持一致。
• docs/engine.md — 引擎的工作原理：五级结果系统、位置与效果、 压力、确定性 RNG，以及各软件包如何协同运作。
• agent-kit/ — 通用 GM 系统提示词与操作手册，可配合任何 Agent 运行游戏。

想体验完整功能？

这个仓库是引擎。MythxEngine Desktop 才是游戏：可视化的基于画面的游戏界面、 场景图像、生成的世界书，以及精致的打磨。请前往 mythxengine.com 关注进展，并在发布时收到通知。

开发

pnpm install
pnpm build && pnpm test && pnpm lint && pnpm typecheck

请参阅 CONTRIBUTING.md — 这个仓库是私有单体仓库的下游镜像；通过 issue 提交是最快的修复方式。

许可证

MIT © protoLabs Studio