andyhuo520

andyhuo520 / tang-changan

Public

大唐长安 · 智机府 — Tang Changan web game

81
18
89% credibility
Found Jun 02, 2026 at 81 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

A highly sophisticated 3D web application that recreates Tang Dynasty Chang'an (capital of the Tang Dynasty, 7th-10th century China) as a fully interactive miniature sandbox. Users can explore the entire city from above, walk through streets as RPG characters, have voice conversations with AI versions of Tang Dynasty poets and scholars, play four traditional mini-games, create Tang-style artwork with AI, and visit gallery exhibitions of famous historical paintings. The experience includes realistic day/night cycles, four seasons, weather changes, 217 animated NPCs, and multiple historical eras from the Zhenguan period through the An Lushan Rebellion. Built entirely with web technologies (Three.js) that run directly in the browser without any installation.

How It Works

1
🏛️ You discover a living map of ancient Chang'an

A stunning 3D recreation of Tang Dynasty's capital city appears in your browser, complete with towering palaces, bustling markets, and the famous Giant Wild Goose Pagoda.

2
👁️ You explore the city from above

From your bird's eye view, you see the grand palace complex, winding rivers, city walls, and the famous Zhuque Gate stretching across the map. You drag to rotate and zoom to any spot that interests you.

3
🕐 You change time and weather with a click

A slider lets you travel through a full day and night, watching lanterns glow at curfew. You switch between seasons and summon rain, sandstorms, or fog with a button.

4
You choose your adventure style
🧙
Explore freely

Stay in bird's eye view and click any building or character to learn about Tang Dynasty history, hear poetry, and read about daily life in the capital.

🧑
Become a character

Enter RPG mode, pick a role like scholar, merchant, lady, or warrior, and walk through the streets as your own avatar, talking to merchants, playing games, and earning coins.

5
💬 You talk to historical figures

Press Q to summon Tang Dynasty poets like Li Bai or Du Fu for a voice conversation, or visit the gallery where an AI art scholar explains famous paintings from the era.

6
🎨 You create your own Tang Dynasty art

In the Art Studio, you upload your own images or describe what you want to paint, and the AI generates Tang-style paintings that appear on the gallery walls.

✨ You've traveled through a thousand years of Tang history

You explored towering palaces, played ancient games, talked to poets, and created your own artwork—all from your browser, feeling the warmth of a civilization that shaped East Asia forever.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 81 to 81 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is tang-changan?

Tang Chang'an is a browser-based 3D diorama game that recreates the Tang Dynasty capital in miniature form. Built with JavaScript and Three.js, it runs entirely in the browser without any build step. Players can explore a 120x160 unit map featuring the Daming Palace complex, the Giant Wild Goose Pagoda, the East and West Markets, Qujiang Pond, and over 200 NPCs scattered throughout the city. The game offers multiple modes: a god-view diorama for casual exploration, an RPG mode with character selection and quests, and a first-person FPS mode for immersive wandering. Weather systems, day/night cycles, and seasonal changes shift the visual atmosphere, while mini-games like poetry challenges, archery, and cuju provide interactive breaks.

Why is it gaining traction?

The project stands out as a living historical sandbox that combines education with entertainment. Instead of dry textbook descriptions, developers and history enthusiasts can walk the streets of Chang'an, interact with period-appropriate NPCs, and experience Tang Dynasty culture through gameplay. The poetry system is particularly unique, featuring flying flower challenges and couplet matching with real Tang verse. The voice interaction layer adds a modern twist, letting players summon AI-powered companions for dialogue. The sheer scope of the recreation, from the three-hall axis of Daming Palace to胡姬 dance performances, creates genuine discovery value.

Who should use this?

Frontend developers curious about Three.js and interactive 3D in the browser will find a substantial reference implementation. History enthusiasts who want an engaging way to explore Tang Dynasty urban life. Educators building cultural heritage experiences. Game developers prototyping RPG mechanics, dialogue systems, or economy models. The project is less suited for teams needing production-ready code with comprehensive testing.

Verdict

With 81 stars, this is an ambitious personal project rather than a mature library. The 0.8999999761581421% credibility score reflects its experimental nature. That said, the breadth of features and the passionate execution make it worth exploring for inspiration or contribution. Run it locally, try the RPG mode, and see if the Tang Dynasty setting sparks your interest.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.