novel-to-game

NovelToGame

把任何小说变成可玩的网页游戏。

NovelToGame 是一套把小说改编成网页游戏的开源技能，适配 Claude Code、Codex 和 Kimi Code。 它先从原著里找出真正能玩的部分，挑一个合适的改编方向，设计出可玩的世界和画面，再把一份 范围明确的构建说明交给编码智能体去实现，最后验证成品能不能跑起来。

English

为什么需要它

直接把小说丢给模型做游戏，出来的多半是换皮的通用玩法。NovelToGame 解决真正难的那一步： 把这本书特有的世界观、地图、势力、任务、物品和情绪变成玩家动作和核心循环，判断它该做成什么游戏，再一路推进到 能玩的原型。

流程

一个总入口串起六个各司其职的环节，把原始文本一路打磨成可验证、可游玩的原型。

flowchart LR
    classDef io fill:#fce4ec,color:#333,stroke:#e57373,stroke-width:1px
    classDef orch fill:#eef2ff,color:#1e1b4b,stroke:#6366f1,stroke-width:1px

    novel["📖 小说"]:::io --> orch["novel-to-game"]:::orch
    orch --> 分析 --> 概念 --> 世界设计 --> 美术 --> 构建 --> 验证 --> game["🎮 可玩游戏"]:::io
    验证 -.->|未通过| 构建

技能

通过 Agent Skills 安装

为你使用的 CLI 安装全部七个技能：

同时安装三端，重复 -a 即可：

npx skills add worldwonderer/novel-to-game -g -y -s '*' \
  -a claude-code -a codex -a kimi-code-cli

克隆仓库后，三端也都能发现项目内的 7 个技能。

原生插件安装

Claude Code：

/plugin marketplace add worldwonderer/novel-to-game
/plugin install novel-to-game@novel-to-game-skills
/novel-to-game:novel-to-game quick

Codex：

codex plugin marketplace add worldwonderer/novel-to-game
codex plugin add novel-to-game@novel-to-game-skills

Kimi Code 0.27 或更高版本：

/plugins install https://github.com/worldwonderer/novel-to-game
/reload
/skill:novel-to-game quick

快速开始

用 novel-to-game quick 把这本小说做成一个 15 分钟可完整游玩的网页游戏。
玩家以原创身份进入世界，不要逐段复演原作剧情。

quick 是默认模式，会自动挑证据最强的方案；想在世界设计之前先从三个方向里做选择， 就用 director 模式。

产出

每次运行都会创建一个紧凑的改编工作区：

game-adaptations/<project>/
  analysis/SOURCE_BIBLE.md
  concepts/CONCEPT.md
  design/GAME_DESIGN.md
  design/ART_DIRECTION.md
  build/BUILD_BRIEF.md
  build/app/
  qa/QA_REPORT.md
  _progress.md

完整示例 —— 《西游记》

《西游记》 示例把整条流程走通：从完整的公版百回本中文 原著，提炼成《三借芭蕉扇》——一款《梦幻西游》《问道》风格的回合制指令 RPG。

多人对阵指令战斗	碧波潭·变化潜入

一段约 45-90 分钟的单人战役，把原著第五十九至六十一回做成九段可玩桥段——从罗刹女一扇吹飞、 灵吉授定风丹，到玉面公主之战、碧波潭变螃蟹偷辟水金睛兽（收为可上阵召唤兽），再到众神围剿、 牛魔王白牛真身、真扇三段息火生风落雨。游戏保留中文玩家一眼就认出的回合制西游玩法——速度 行动顺序、指令菜单、五行相克、携召唤兽出战、阵型、悟空七十二变——外加升级加点、法术熟练、 剧情装备与规则型法宝，全用一套原创的明代木刻套印美术呈现。代码由 Kimi K3 生成、美术由 gpt-image-2 生成，并且自带验证：146 项引擎断言 + 一次 Playwright 全程走查，控制台 0 报错。

examples/journey-to-the-west/
├── source/西游记.txt + SOURCE.md   # 完整公版百回本原著 + 来源出处
├── analysis/SOURCE_BIBLE.md        # 游戏化设定集：规则、动作、空间、角色、名场面
├── concepts/CONCEPT.md             # 三个真正不同的概念，含入选方案与取舍
├── design/GAME_DESIGN.md           # 系统：行动顺序、五行、技能、携宠、阵型、变化、多阶段Boss
├── design/ART_DIRECTION.md         # 木刻视觉风格、战斗舞台、界面、招牌画面
├── build/BUILD_BRIEF.md            # 交给编码智能体的、不挑模型、范围明确的构建说明
└── build/app/                      # 已构建的可玩游戏——运行方式见 build/app/RUN.md

致谢

linux.do