山河旅人 · 千年輿圖記
A pixel-art history RPG that runs in the browser. Walk from the Qin to the Qing on real historical maps, meet a companion in every era, and collect classical poems along the way. Traditional or Simplified Chinese, with an optional pinyin mode for young readers.
- JavaScript
- Canvas
- WebAudio
- pixel art
- RPG
- CCTS
- CBDB
- OpenCC
- pypinyin
- Claude
Lin Yao, a nineteen-year-old who restores old maps at a museum in Xi’an, is pulled into a bronze map-disc’s maps in the winter of 2026, where a “blank ink” is quietly erasing history. He travels from the Qin (210 BCE) to the Qing (1757), across ten chapters, to paint each era back as it really was. Along the way he meets ten companions: a Mohist engineer, a Loulan guide, a recluse strategist, a Jin zither player, a canal boatwoman, a Tang sword dancer, a Song astronomer, a Quanzhou merchant’s daughter, a Ming star-navigator and a Qing court painter. The heroes are witnesses: history happens as it did.
- Real maps, real years. The world map is public-domain terrain, coastlines and rivers. On top of it sit the borders and roads of each chapter’s year: the Great Wall, the Silk Road, the Grand Canal, the Tea Horse Road and Zheng He’s route. With formal permission from Academia Sinica’s CCTS, its dynasty maps are layered over it, and the game stays free. Landmarks only appear once they were built: the Big Wild Goose Pagoda from the Tang, Leifeng Pagoda after 975.
- Towns to live in. Every house can be entered, with residents of the era and furniture to search for herbs, coins or rare period treasures. There is fishing, and a scenic view with a poem in each of the 31 towns.
- Poems and people. There are 39 poem scrolls hidden in the chapters, plus scenic and journey poems. Sixteen side quests follow historical figures stop by stop, among them 李白, 杜甫, 蘇軾, 李清照 and 玄奘. The 驛丞 in each town also offers the routes of 591 Tang–Qing poets, from 詩酷 and CBDB.
- Bonds and endings. Companions grow closer through battles, inn night-talks and gifts, unlocking five scenes each, plus an illustrated moment with each companion. There are three endings and an epilogue back in present-day Xi’an.
- Made for children too. Traditional Chinese (Taiwan) is the default, and Simplified is one click away. An optional pinyin mode puts a tone-marked pinyin line above every line of text, reading polyphones by word, so 長安 is cháng and 長大 is zhǎng. Tablets work with touch alone, and game controllers are supported.
Everything is drawn and composed in code: portraits, sprites, 57 monsters, the towns, and pentatonic music in a different mode for each era, synthesized live with WebAudio. It is plain JavaScript and Canvas, with no build step. It is a personal hobby project, made with Claude and shared with friends and family.
Updates
16 November 2026
- Game controllers. Play with a Stadia controller in Bluetooth mode, or an Xbox, PlayStation, Switch Pro or 8BitDo pad: D-pad to walk, A to confirm, B to go back, hold X to run, Y for the menu.
- Faster start. The first visit downloads far less before the title screen appears, and return visits open almost at once.
9 November 2026
- Poetry contests. A host in every town asks three questions: the next line, a missing character (銅雀春深鎖_喬: 一, 二, 三 or 四?), who wrote it, or where it was written (晴川歷歷漢陽樹 is Wuhan). Only poems from before that chapter’s year come up. Right answers earn coins; a perfect round earns a gift.
- Maps used with permission. Academia Sinica’s CCTS formally licensed its historical maps for the game. The source is credited on the title screen, on the world map and in the end credits, and the game will stay free.
8 November 2026
-
Music for every chapter and every companion. Each era has its own signature melody, and the finale has a theme of its own. Each companion has her own song, which plays during her moments and bond scenes.
-
Throwing in battle. A new command: throw a handful of coins, a poison bag, caltrops, a stunning talisman, a thunderclap bomb, or a pearl that blinds everyone with light.
-
Every skill animates differently. All 48 skills have their own effects, and each companion’s ultimate first paints its name across the screen in brush strokes.
-
An ending movie. After the ending: the ten eras on their maps, the moments you unlocked, everyone walking together, and the credits. It can be replayed from the title screen.
-
Moments with each companion. Eleven new illustrated scenes, one per companion: reading by one lamp, fixing a wooden kite, counting stars, patching a sail, a sword lesson at the lantern festival, painting each other in the snow. Some end in laughter, some in tears. They appear once a bond reaches its second heart: a pink heart on the world map, or a glowing one inside a city. Each can be watched again from the collection.
-
How the romance is written. With the adult companions, feelings stop at a shy first crush: a blush, a view shared, a small gift, a sentence left unfinished. Nothing goes further. The younger companions and the map-disc spirit have friendship stories, and some companions are simply good friends.
-
Poems match their years. Every poem in the game was written before the year of its chapter, so no Tang poem turns up in the Han. Poem scrolls and scenic views show each poem’s dynasty. Five poems whose author or date is uncertain carry a * and a one-line note, such as 《招魂》 (宋玉 or 屈原?) and 《憶秦娥》 (traditionally 李白, widely doubted).
-
Years on the map. Under the big dynasty name on the world map is the rough year the map shows, such as “Qin · about 210 BCE”. It changes when borders shift within a chapter.
-
Easier journeys. Every one of the sixteen historical journeys can be started and finished. Givers outside towns now offer their journey, an arrow at the screen edge points to the next stop, and a stop that sits on a city is visited before entering the city.
-
The hero is now a boy. Lin Yao has a new portrait and sprite, and the story calls him 他 and 林遙哥. With the adult companions it stays a shy first crush; with the younger ones and the map-disc spirit, he is like a big brother.
-
Smaller things. Menus remember their place, so after using an item or viewing a scene you return to the same entry.
7 November 2026 — first release: ten chapters, prologue and finale, towns, fishing, scenic views, bonds, sixteen journeys, pinyin mode and touch controls.
Posts: game intro, full walkthrough and treasure guide, why I made it.
山河旅人 · 千年輿圖記:從秦走到清的像素歷史 RPG
西安博物館的古地圖修復師林遙,一個十九歲的男生,在 2026 年冬天被一件青銅「渾天輿圖盤」帶進地圖裡。那裡有一種「蝕墨」正悄悄抹去歷史,他要從秦(前 210)一路走到清(1757),十個篇章,把每個時代原原本本畫回來。一路上會遇見十位夥伴:墨家機關師、樓蘭嚮導、隱居女軍師、東晉琴師、運河船娘、劍器舞者、司天監天文生、泉州海商之女、寶船牽星官、如意館女畫師。主角只是見證者,歷史照原樣發生。
- 真實的地圖與年代:世界地圖以公有領域的地形、海岸與河流為底,疊上每一章劇情年份的疆域與古道:長城、絲綢之路、大運河、茶馬古道、鄭和航線。並經中研院 CCTS 正式授權,疊上它的歷代地圖;遊戲也因此一直免費。地標按年代出現:大雁塔要到唐代才有,雷峰塔在 975 年以後。
- 可以生活的城鎮:每間房子都能走進去,有那個時代的居民可以聊天,家具可以搜索,找草藥、銅錢或稀有的時代珍寶。還能釣魚;31 座城鎮各有一處勝景與一句古詩。
- 詩與人:章節裡藏著 39 張詩箋,另有勝景與行跡的詩。16 條支線跟著歷史人物的人生一站一站走,有李白、杜甫、蘇軾、李清照、玄奘等人;各城的驛丞還提供 591 位唐至清詩人的行跡簿,資料來自詩酷與 CBDB。
- 羈絆與結局:與夥伴一起戰鬥、在客棧夜談、送禮,都會加深羈絆,每人解鎖五段心事,還有一段帶插畫的「回憶」。共有三種結局,以及回到現代西安的尾聲。
- 也為孩子設計:預設繁體中文(台灣),一鍵可切換簡體。可開啟拼音模式,在每一行字上方標注帶聲調的拼音,多音字按詞判斷:長安讀 cháng,長大讀 zhǎng。平板只用觸控就能玩,也支援遊戲手把。
所有東西都用程式畫出來、寫出來:立繪、角色、57 種怪物、城鎮,以及每個時代調式不同、以 WebAudio 即時合成的五聲音階配樂。純 JavaScript 與 Canvas,不需要建置。這是一個與 Claude 一起完成的個人業餘作品,分享給朋友與家人。
更新紀錄
2026 年 11 月 16 日
- 遊戲手把:Stadia 手把(藍牙模式)、Xbox、PlayStation、Switch Pro、8BitDo 都能玩:十字鍵走路、A 確認、B 返回、按住 X 奔跑、Y 開選單。
- 開得更快:第一次打開要下載的東西少了很多,再次打開幾乎馬上就能玩。
2026 年 11 月 9 日
- 詩會:每座城鎮都有一位出題的先生,三道題:接下一句、填空(銅雀春深鎖_喬:一、二、三、四?)、猜作者、猜「這首詩寫的是哪裡」(晴川歷歷漢陽樹——武漢)。只考那個時代以前寫成的詩;答對賞錢,全對送禮。
- 地圖正式授權:中研院 CCTS 正式授權本遊戲使用歷史地圖。標題畫面、世界地圖與片尾都註明出處,遊戲也會一直免費。
2026 年 11 月 8 日
-
每一章、每位夥伴都有自己的音樂:每個時代有自己的主旋律,終章也有專屬的配樂;每位夥伴有一首自己的曲子,在她的回憶與心事裡響起。
-
戰鬥可以「投擲」:撒一把銅錢、丟毒藥包、鐵蒺藜、定身符、霹靂彈,或是一顆讓全場目眩的夜明珠。
-
每個技能都有自己的動畫:48 個技能各有特效,夥伴的絕招會先用毛筆字寫出招式名。
-
片尾影片:結局之後,走過十個時代的地圖、看過的回憶、全員同行與演職員表;標題畫面可以重看。
-
和夥伴的「回憶」:新增 11 段插畫場景,每位夥伴一段:書肆裡一起讀書、一起修木鳶、坐在渭水邊數星星、補船帆、上元夜學劍舞、在雪裡互相畫像。有的大笑,有的落淚。羈絆到第二顆心後,地圖上會出現粉色的 ♥,或在城裡出現發光的 ♥;看過的回憶可以在「收藏」裡重看。
-
感情線的分寸:和成年夥伴的心動,只停在青澀的好感:臉紅、並肩看風景、送一份小禮物、一句沒說完的話,不會再往前。年紀小的夥伴與輿圖盤的器靈是友情的故事,有些夥伴就只是很好的朋友。
-
詩對得上年代:遊戲裡的每一首詩,都寫成於那一章故事的年份之前,漢朝不會出現唐詩;詩箋與勝景都會標出朝代。作者或年代有疑義的五首詩加上「*」與一行說明,例如《招魂》(宋玉還是屈原?)、《憶秦娥》(舊題李白,後人多有懷疑)。
-
地圖上的年份:世界地圖上大大的朝代名下方,標著這張圖大約是哪一年,例如「秦 · 約前 210 年」;同一章裡疆域有變化時,年份也跟著變。
-
行跡更好走:16 條歷史人物的行跡都能接下並走完。委託人不在城裡的,走到那裡就會詢問;下一站在畫面外時,邊緣有箭頭指路;行跡站和城池在同一處時,先探訪行跡,再進城。
-
主角改為男生:林遙換上新的立繪與行走圖,故事裡稱「他」、「林遙哥」。和成年夥伴之間仍只是青澀的好感;和年紀小的夥伴與器靈璇璣,像哥哥一樣。
-
小地方:選單會記得位置,用完道具、看完場景,會回到原本那一項。
2026 年 11 月 7 日:首次上線,十個篇章加序章與終章,城鎮、釣魚、勝景、羈絆、16 條行跡、拼音模式與觸控操作。
相關文章:遊戲介紹、完整攻略與寶物圖鑑、為什麼要做《山河旅人》。
Comments