Tu Chân Giới · docs

Roadmap

Next, the operator settles the open decisions. Then the team fixes the known prototype bugs, builds a small internal slice (M0), and then the public v0.1. You can run the prototype today with Node only.

Roadmap in six steps Steps 1 and 2 are done, step 3 is now, steps 4 to 6 are next. 1 Spec v0.1✓ done 2 CLI prototype✓ done 3 Decisions● now 4 Fix + sweepnext 5 M0 slicenext 6 Public v0.1next Roadmap in six steps Six steps in one column. Steps 1 and 2 are done, step 3 is now, steps 4 to 6 are next. 1 Spec v0.1✓ done 2 CLI prototype✓ done 3 Decisions● now 4 Fix + sweepnext 5 M0 slicenext 6 Public v0.1next
Figure 6. Roadmap. Text version: the list below.
  1. done Spec draft v0.1 (README.md).
  2. done Command-line prototype: world event, bí cảnh, combat and checks; 27 tests.
  3. now Operator decisions (Decisions page), including approval of C1–C9.
  4. next Fix the 4 known combat bugs and apply C1–C9 in one change. Re-run the balance sweep. Turn the C4 win-rate bands into tests that must pass. Update the README.
  5. next Internal M0 slice (proposed): 1 region, 2 sects, about 12 seeds, 1 kính. Test: 1 world event, 1 daily event, and 1 consequence spawned from their saved state.
  6. next Public v0.1 (proposed): 3 regions, 3 sects, about 80 seeds, 3 kính, about 40 images, the full tick pipeline, and a receipt on every change.

Proposed — needs operator decision: the M0 and v0.1 scopes above come from the design debate.

How to run the prototype

You need Node 22.6 or newer (built on 24.12). There are no npm dependencies. --no-warnings only hides Node's "SQLite is experimental" notice.

  1. Check your Node version.
    node --version
  2. Get the code.
    git clone https://github.com/untitled-big-tech-company/tcg
  3. Go into the folder.
    cd tcg
  4. Run the tests. Expect 27 passes.
    node --no-warnings --test poc/*.test.ts
  5. Run the world event (raid, seed 1, 200 bots).
    node --no-warnings poc/run.ts
  6. Run the bí cảnh dungeon.
    node --no-warnings poc/run.ts --scenario=dungeon
  7. Watch one bot fight.
    node --no-warnings poc/run.ts --scenario=combat
  8. Play the fight yourself.
    node --no-warnings poc/run.ts --scenario=combat --interactive
  9. Run a skill check.
    node --no-warnings poc/run.ts --scenario=check
  10. Print the balance sweep.
    node --no-warnings poc/run.ts --scenario=combat --sweep
  11. See the LLM fallback with a broken provider.
    node --no-warnings poc/run.ts --break-llm

Other flags:

FlagWhat it does
--seed=NSets the random seed. The same seed gives the same run.
--players=NSets the number of bot players.
--days=NSets the number of game days to run.
--beast=…Picks the beast in --scenario=combat: hac_lang, doc_xa, si_yem or thiet_hung.
--db=world.dbKeeps the SQLite file. *.db is git-ignored, so do not commit it.
--llm=realUses a real LLM. It needs the LLM_BASE_URL, LLM_API_KEY and LLM_MODEL environment variables.

Never put a key in a file in the repo.