novel-rpg

Novel RPG is an AI-assisted interactive fiction engine that turns novels into playable role-playing scenarios. It ships with two built-in books: Wuthering Heights by Emily Brontë (30 scenes, characters including Heathcliff, Catherine, Nelly, and Edgar) and Journey to the West by 吴承恩 (27 scenes, characters including 孙悟空, 唐僧, 猪八戒, and 沙僧). To play, users select a book and a character. The AI narrates scenes from that character's point of view and presents 2-4 choices per scene. Choices affect four stats (Wisdom, Combat, Loyalty, Reputation), relationships, and a 0-100 divergence score from the original plot. The engine supports persistent saves across sessions, replaying the same story as different characters, and achievements for canon or alternate paths. Users can import their own novels in PDF format through scripts/pdf_import.py. The importer detects chapters using patterns such as "Chapter X" for English and "第X回/章" for Chinese, extracts character candidates, and generates a playable scene graph. Built-in novels use structured metadata rather than full text, relying on the LLM's training knowledge; imported PDFs store text chunks. Optional PDF import requires PyMuPDF. Installation is available via npx novel-rpg-skill, a curl one-line install script, or git clone into ~/.openclaw/skills/novel-rpg with a Python command to initialize built-ins. CLI commands cover book management, game saves/scenes, and PDF import status. The README documents compatibility with Claude Code, OpenClaw, ChatGPT (by using SKILL.md as custom instructions and running scripts manually), and any LLM.