# AI use cases for Awesome Chinese Folk Game (momozi1996/awesome-chinese-folk-game) Repo: [momozi1996/awesome-chinese-folk-game](https://github.com/momozi1996/awesome-chinese-folk-game) | Use cases: 4 | Page: https://dedupedai.com/use-cases/momozi1996-awesome-chinese-folk-game/ An offline, dependency-free Chinese folk-horror detective game with 9 playable cases, played through a forum-style browser interface. This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL. - Play nine folk-horror mystery cases offline: https://dedupedai.com/use-cases/momozi1996-awesome-chinese-folk-game/play-folk-horror-cases-offline/ - Check new case content before opening a pull request: https://dedupedai.com/use-cases/momozi1996-awesome-chinese-folk-game/validate-new-case-content-before-pr/ - Draft a new mystery from the 58 reserve themes: https://dedupedai.com/use-cases/momozi1996-awesome-chinese-folk-game/draft-mystery-from-58-reserve-themes/ - Inspect and test the case engine's inference logic: https://dedupedai.com/use-cases/momozi1996-awesome-chinese-folk-game/inspect-and-test-case-engine-logic/ ## How to play nine folk-horror mystery cases offline with Awesome Chinese Folk Game Repo: [momozi1996/awesome-chinese-folk-game](https://github.com/momozi1996/awesome-chinese-folk-game) | Difficulty: Beginner | Time: 15 minutes | Basis: From the README Run the forum-style Chinese detective game locally with no account, API key, or install beyond Python. **Who it is for:** A mystery fan who wants a playable folk-horror investigation game on their own machine, with no sign-up and no setup beyond a browser or Python. **The problem:** Most mystery games need an account, a download launcher, or a network connection, and the player wants something that runs fully on their own computer. **The outcome:** The player reads forum threads, questions characters by private message, examines scenes, and files a report on a case, starting with 《借灯人》. ### Steps 1. Clone the repository with `git clone https://github.com/momozi1996/awesome-chinese-folk-game.git`. 2. Enter the folder with `cd awesome-chinese-folk-game`. 3. Start the game with `python3 demo/run_demo.py`. 4. Without Python, download the latest zip from the releases page, unzip it with the full src/ folder intact, and open src/forum_system/index.html in a browser. 5. Begin with the case 借灯人 from the forum home page. ### Prompt to paste into your agent ```text Clone momozi1996/awesome-chinese-folk-game into , run python3 demo/run_demo.py from that folder, and report whether the launcher starts without errors. Verify that the forum home page loads in a browser at the address the launcher reports. ``` ### Caveat The README says the game needs no pip install and no account, but the Quick start section in the provided text is truncated, so confirm the launcher command against the full README before relying on it. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/momozi1996-awesome-chinese-folk-game/play-folk-horror-cases-offline/ ## How to check new case content before opening a pull request with Awesome Chinese Folk Game Repo: [momozi1996/awesome-chinese-folk-game](https://github.com/momozi1996/awesome-chinese-folk-game) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Run the content validator and both test suites on a local clone before submitting a new case. **Who it is for:** A contributor writing a new folk mystery case who needs to confirm the content passes validation before sending a pull request. **The problem:** Broken clue reachability, mismatched serial case links, or invalid frontmatter can slip into a case unnoticed and break play. **The outcome:** The contributor knows whether the content check, the Python unit tests, and the JavaScript engine test all pass, and can fix problems before submitting. ### Steps 1. Clone the repository with `git clone https://github.com/momozi1996/awesome-chinese-folk-game.git`. 2. Enter the folder with `cd awesome-chinese-folk-game`. 3. Run the read-only content check with `python3 -m src.folk_parser check`. 4. Run the Python unit tests with `python3 -m unittest discover -s tests`. 5. Run the JavaScript engine test with `node tests/engine.cjs`, then fix any failures before opening a pull request. ### Prompt to paste into your agent ```text In the local clone of momozi1996/awesome-chinese-folk-game at , run python3 -m src.folk_parser check, python3 -m unittest discover -s tests, and node tests/engine.cjs. Report pass or fail for each command, with the first error message for any failure. Verify that the check command makes no file changes by comparing git status before and after. ``` ### Caveat A new playable case must have its own characters, timeline, clues, failure feedback, and full playthrough verification, not just a renamed entry from the reference library, as the README requires. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/momozi1996-awesome-chinese-folk-game/validate-new-case-content-before-pr/ ## How to draft a new mystery from the 58 reserve themes with Awesome Chinese Folk Game Repo: [momozi1996/awesome-chinese-folk-game](https://github.com/momozi1996/awesome-chinese-folk-game) | Difficulty: Advanced | Time: 30 minutes | Basis: From the README Use the Markdown reference library and case format guide to start a new folk-horror mystery. **Who it is for:** A writer or game designer who wants to build a new folk-horror mystery and needs a starting theme and the project's content format. **The problem:** A writer has a story idea but does not know the required case structure, or which of the 58 reserve themes are already covered. **The outcome:** The writer picks a reserve theme, reads the reference entries, and drafts a case that follows the project's format and passes the content check. ### Steps 1. Clone the repository with `git clone https://github.com/momozi1996/awesome-chinese-folk-game.git`. 2. Read docs/case_list.md to see which of the 9 playable cases already exist. 3. Read cases/README.md for the required format, then choose one of the 58 reserve themes. 4. Draft the case as Markdown and JSON in the format described in cases/README.md. (inferred, check the README) 5. Run `python3 -m src.folk_parser check` to validate the draft before opening a pull request. ### Prompt to paste into your agent ```text Read cases/README.md and docs/case_list.md in the momozi1996/awesome-chinese-folk-game repository at , then list the required case format and the playable cases that already exist. Verify that the list matches the case files actually present in cases/playable/. ``` ### Caveat The 58-theme library is a writing reference, not 58 additional playable games, and content under CC BY-NC-SA 4.0 cannot be used commercially. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/momozi1996-awesome-chinese-folk-game/draft-mystery-from-58-reserve-themes/ ## How to inspect and test the case engine's inference logic with Awesome Chinese Folk Game Repo: [momozi1996/awesome-chinese-folk-game](https://github.com/momozi1996/awesome-chinese-folk-game) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Read the pure-function deduction check in engine.js and run the JavaScript engine test in Node. **Who it is for:** A developer who wants to reuse or test the deduction logic of a browser-based mystery game without touching the DOM. **The problem:** The developer needs to understand how a deduction is judged and confirm the engine behaves correctly before reusing or changing it. **The outcome:** The developer can explain how a pair of clues is judged correct and has a passing engine test run. ### Steps 1. Clone the repository with `git clone https://github.com/momozi1996/awesome-chinese-folk-game.git`. 2. Enter the folder with `cd awesome-chinese-folk-game`. 3. Open src/case_engine/engine.js and read the inferenceCorrect function. 4. Run the engine test with `node tests/engine.cjs`. ### Prompt to paste into your agent ```text In the momozi1996/awesome-chinese-folk-game repository at , read src/case_engine/engine.js, explain how inferenceCorrect decides a deduction is correct, and run node tests/engine.cjs. Report the number of tests run and passed. Verify that the engine has no DOM or localStorage calls. ``` ### Caveat The README describes the engine test as 2 JavaScript engine tests, so a different count means the repository has changed since the README was written. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/momozi1996-awesome-chinese-folk-game/inspect-and-test-case-engine-logic/