andyhuo520/tang-changan — explained in plain English
Analysis updated 2026-05-18
Explore a recreated Tang Dynasty city with day-night, season, and weather cycles.
Play an RPG mode as one of four character classes with its own economy and shops.
Try mini-games like riddles, poetry matching, and couplet games with NPCs.
Walk through first-person gallery exhibits inside five recreated palace halls.
| andyhuo520/tang-changan | emirsametguzel/escape-from-mz | joeseesun/qiaomu-suno-master | |
|---|---|---|---|
| Stars | 27 | 27 | 27 |
| Language | JavaScript | JavaScript | JavaScript |
| Setup difficulty | easy | easy | moderate |
| Complexity | 2/5 | 2/5 | 2/5 |
| Audience | general | general | vibe coder |
Figures from each repo's GitHub metadata at analysis time.
Requires a local Python web server since the project uses ES modules and cannot be opened as a file directly.
Tang Chang'an is an interactive historical simulation of the Tang Dynasty capital city, built as a pure browser web app using Three.js and plain JavaScript with no build step required. The README is written in Chinese and covers version 11 of the project. The simulation models a 120x160 unit map of the city including the three grand palace halls of Daming Palace, the seven-story Wild Goose Pagoda, the Qujiang lake area, the east and west markets, farms with water irrigation, and the southern Zhuque gate. The scene runs a live day and night cycle, a four-season cycle, and a curfew system. Weather changes between rain, sandstorm, and fog, with lightning and thunder during rain. Over 200 NPCs populate the streets and speak market gossip tied to their roles (soldiers, merchants, scholars, monks, farmers, foreign traders). A historical events timeline is also woven into the experience. Players can enter the scene in an RPG mode, choosing one of four character classes: scholar, merchant, court lady, or soldier. Each class starts with a different set of currency and items. The game includes an economy with four currency types (copper coins, silk, gold ingots, and a fame score) and five types of shops where you can buy food, calligraphy supplies, clothing, collectibles, and travel passes. A stamina and charm system responds to eating and drinking. Four mini-games are available: rock-paper-scissors with NPCs, Tang Dynasty riddles, a poetry word game (picking lines that contain a given character), and couplet matching. Winning earns items from prize pools, losing gives comic consolation responses. Five palace halls can be entered in first-person view, where you walk through gallery-style exhibitions of Tang court life with captioned artwork panels. Pressing V switches between third-person and first-person camera at any time. To run the project locally, you start a simple Python web server in the project folder and open the local address in a browser. Direct file opening does not work because the project uses ES modules.
Tang Chang'an is a browser-based historical simulation of the Tang Dynasty capital, letting players explore a recreated city, chat with NPCs, and play mini-games.
Mainly JavaScript. The stack also includes JavaScript, Three.js.
The README does not state a license, so usage rights are unclear.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.