Tu Chân Giới — design and prototype docs

These pages explain the game design, the prototype and the open decisions. Each page starts with a short summary. The details come after it.

Tu Chân Giới (修真界, "the cultivation world") is a text-based MMO for the web, in Vietnamese. Players react to shared events, and the server turns all their choices into lasting changes in one world. Status: pre-alpha prototype. A written spec and a command-line proof of concept exist. There is no playable game yet.

All pages

Search page titles and headings (accents optional):

2. Core loop

An event opens, players choose, a tick resolves all choices, and the engine saves the result.

3. World & lore

Two universes, three civilisations and the realm ladder. v0.1 uses cấp 1–2 on one continent.

4. Event system

World, daily and personal events. How choices become a success chance p and a tier.

5. Bí cảnh dungeon

A three-floor raid that runs as one world event, with attrition and loot.

6. Combat

One d20 rule for fights and checks. The prototype rules and the proposed spec C1–C9.

7. LLM as narrator

The LLM writes the story but never decides numbers. Templates take over on failure.

8. Prior art

Four open projects close to this idea, and the patterns we take from them.

9. Decisions

Five confirmed decisions and the open ones, with recommended defaults.

10. Roadmap & how to run the prototype

The next steps up to the public v0.1, and how to run the prototype.

The one selling point

Player actions change the shared, persistent world. Persistent means the change stays and every player sees it. For example, 600 players defend Lạc Hà Trấn (a town) and 80 join the raiders. Then the town's danger level, its market prices, the surviving NPCs and next week's events change for everyone.

The spec authors found no live MMO in which an LLM (large language model, an AI text writer) resolves all players' choices into persistent shared-world change. The Prior art page lists the closest projects.

Figure 1. The shared-world cycle. Text version: players choose → the engine rolls → the world changes → new events appear → players choose again.

What exists today

Spec draft v0.1
README.md. Product and technical design. Appendix A holds the operator's lore, word for word.

Prototype (PoC) 27 tests pass
poc/. Node scripts, no web UI. It proves a world event, a raid dungeon, combat and skill checks.

Decision records pending approval
Design debate rounds 3–4, a prior-art study and a 4-round combat council. They produced the combat spec C1–C9.

Key terms

The pages explain each term at its first use. This list collects the most common ones.

Engine: The server code that owns all numbers and rolls all dice.
Tick: The moment a choice window closes and the engine resolves the event.
Seed: An event template: options, rules and allowed effects.
Tier: One of five outcomes: đại thắng (decisive win), thắng (win), giằng co (stalemate), bại (loss), thảm bại (disaster).
Cảnh giới, cấp: Realm (a level of cultivation) and its number.
Tu sĩ, tông môn: Cultivator (the player's kind) and sect (a player faction).