Wiki · TJA 與模擬器
YataiDON:Windows、Mac、Linux、手機都能玩的開源太鼓模擬器
YataiDON 是用 C++ 和 raylib 寫的開源太鼓模擬器(GPL-3.0),支援 Windows、macOS、Linux、Android、iOS。說明安裝方式、Songs 資料夾與 config.toml 的 tja_path、box.def 分類、延遲設定,以及 TaikoForge 譜面的注意事項。
YataiDON 是 Yonokid 開發的開源太鼓模擬器(GPL-3.0),用 C++ 和 raylib 寫成,走街機風格。它和 TJAPlayer3 系列不同,是另外從頭寫的,最大的特色是跨平台:同一套程式可以在 Windows、macOS、Linux、Android、iOS 上玩。
以下是 2026 年 11 月依官方 GitHub 的 README 和 TJADB 社群指南整理的內容。
支援平台
| 平台 | 需求與安裝 |
|---|---|
| Windows | Windows 10 以上。先安裝 Microsoft 的 Visual C++ 可轉散發套件,再執行 YataiDON.exe |
| macOS | 有自動建置的版本,但官方註明大致未經測試 |
| Linux | Ubuntu 24.04 以上(需要 glibc 2.39+),執行 YataiDON.bin |
| Android | Android 10 以上,安裝 YataiDON-Android.apk(需允許安裝未知來源的應用程式) |
| iOS | iOS 16.3 以上,透過 TestFlight 安裝測試版 |
| PS5、Switch | 實驗性的自製軟體版本 |
電腦版從 GitHub 的 Releases 下載。
主要功能
- 譜面格式:TJA,也能讀 osu! 的 .osu/.osz
- 譜面分歧(普通、玄人、達人)、段位道場、練習模式(可以自由拖動進度練習)
- 1 人或 2 人遊玩、支援控制器
- 背景影片、歌曲搜尋與我的最愛、多語言介面
- 內建多種造型,可在遊戲設定或 config.toml 切換
- 線上成績:開啟後會在 config.toml 拿到存取碼,用來登入 yataidon.tjadataba.se。目前只記錄社群特定曲包裡的歌,自己的譜面不會上傳成績
加入譜面
- 打開 YataiDON 資料夾裡的 Songs 資料夾
- 把歌曲資料夾(.tja 和音檔)放進去
- 在選歌畫面按 F5 重新整理
想放在別的地方,可以在 config.toml 改歌曲路徑,也能指定好幾個:
tja_path = ['路徑1', '路徑2']
想分類的話,和 TJAPlayer3 系列一樣用 box.def。
常用按鍵
- F1:遊戲中快速重來
- Esc:回上一個畫面
- 空白鍵:在選歌畫面加入我的最愛
- 左右 Ctrl:在選歌畫面一次跳 7 首
- F5:在選歌畫面重新整理歌曲清單
聲音延遲太大
Windows 上覺得延遲大,到遊戲設定把 device_type 改成 WDM-KS、WASAPI 或 ASIO(看電腦支援哪一種)。這是官方 FAQ 的建議。延遲改善後如果音符還是整體偏早或偏晚,再調 OFFSET,見調整 OFFSET 與 BPM。
TaikoForge 譜面的注意事項
- 直接放進 Songs:下載的 zip 解壓後,把資料夾放進 Songs 就好。所有難度都在同一個 .tja 裡。
- 分歧譜面:進階工具做的「主譜面名_branch.tja」也能直接玩,YataiDON 支援普通、玄人、達人三種分歧。
- 很多首一起放:付費方案的「模擬器歌曲包」會把多首歌打包成帶 box.def 的資料夾,解壓到 Songs 就會分好類。
- 音檔和編碼:官方說明沒有寫支援哪些音檔格式和文字編碼。最保險的做法是上傳 OGG;如果日文曲名變亂碼,把 .tja 另存成 UTF-8(含 BOM)試試,見 TJA 格式說明。
- 先在瀏覽器確認:放進手機之前,先用瀏覽器試玩確認譜面和音樂對得上,比較好找問題。
其他模擬器
想比較各模擬器,見模擬器比較。