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。目前只記錄社群特定曲包裡的歌,自己的譜面不會上傳成績

加入譜面

  1. 打開 YataiDON 資料夾裡的 Songs 資料夾
  2. 把歌曲資料夾(.tja 和音檔)放進去
  3. 在選歌畫面按 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 格式說明。
  • 先在瀏覽器確認:放進手機之前,先用瀏覽器試玩確認譜面和音樂對得上,比較好找問題。

其他模擬器

想比較各模擬器,見模擬器比較。