把卡帶和光碟，重新擺回架上。

復古貓是一款本機優先的 Android 復古遊戲前端。選一個 ROM 資料夾就能開始，用控制器瀏覽每台遊戲機原本的包裝和媒介，再用外掛程式、主題和機種包擴充成你想要的樣子。

下載復古貓閱讀 Wiki

Android 8.0 以上 · 3DS 存檔同步程式另行提供

網頁重現的 App 介面，不是實機截圖。包裝盒是 App 的同款模型，可以拖曳檢視。這裡的遊戲都是虛構的示範內容，封面由 AI 繪製。

35個機種的包裝與媒介模型

4種內建語言，可自動比對

3種介面風格，主題可擴充

0個帳號，不設定網盤也能用

每台機器，都有它自己的盒子

紙盒、塑膠盒、珠寶盒、卡帶和光碟分別建模，預設採用日版造型。內建 35 個機種，封面會貼到實物比例的 3D 模型上。

任天堂: Famicom · Famicom Disk System · Super Famicom · Game Boy · Game Boy Color · Game Boy Advance · Nintendo 64 · GameCube · Wii · Wii U · Nintendo DS · Nintendo 3DS · Nintendo Switch
世嘉: Master System · Mega Drive · Mega CD · SEGA 32X · Game Gear · SEGA Saturn · Dreamcast
索尼: PlayStation · PlayStation 2 · PlayStation 3 · PSP · PS Vita
SNK: NEO GEO · NEO GEO CD · NEO GEO Pocket · NEO GEO Pocket Color
NEC: PC Engine · PC Engine CD
萬代: WonderSwan · WonderSwan Color
微軟: Xbox · Xbox 360

選一次資料夾，其他交給它

選擇 ROM 總資料夾
依資料夾名稱、索引和明確的副檔名找出機種，無法判斷的資料夾才詢問你。
自動比對媒體
同名圖片和影片自動歸位，也能讀取 ES-DE、Pegasus、LaunchBox 的既有索引。
按下 A 開始遊戲
透過模擬器的公開入口啟動：RetroArch、PPSSPP、Dolphin、DuckStation、Azahar 等。

存檔跟著你走，版本由你決定

透過 WebDAV 或百度網盤同步 ROM、媒體和存檔。存檔由你主動同步，出現分岔時由你選擇；每個版本都保存在你自己的網盤裡，可以隨時還原。

區域網路一鍵設定，新裝置不用重新填寫帳號。

了解存檔同步

控制器優先，也適配各種螢幕

方向鍵只在封面間移動，肩鍵切機種，扳機鍵切頁面，按鍵可以重新對應，A/B 確認方向也能互換。介面以 16:9 設計，同時適配 4:3、1:1 和雙螢幕掌機。

外掛程式系統

不只是前端，也是一個平台

外掛程式是真正能執行的程式：一段背景指令碼加幾個網頁，透過公開的 SDK 呼叫復古貓的能力。不用改主程式，也不用重新打包 APK。

能做真正的功能
讀寫遊戲資料、收藏和最近紀錄，管理媒體關聯，把欄位隨索引同步，呼叫網路，讀寫網盤裡的 JSON，為 ROM 同步增加資源，自訂啟動入口。
有自己的介面
用 HTML、CSS 和 JavaScript 寫頁面，框架隨你選。頁面在復古貓的導覽裡開啟，配色跟隨主題，控制器方向鍵可以移動焦點。
權限由玩家決定
外掛程式要先宣告能力，玩家同意後才能啟用。更新時新增能力，外掛程式會保持停用，直到玩家再次同意。連網必須宣告主機。
不拖慢遊戲
啟動遊戲不等待外掛程式。背景指令碼在隔離的引擎中按需執行，任務結束後釋放，關閉頁面也不會中斷任務。
發布不用等我
每個人都能用自己的 GitHub 倉庫發布。玩家加入倉庫位址後，就能在商店看到更新、版本和作者。

plugin.json

{
  "id": "example.hello",
  "version": "1.0.0",
  "entryPoint": "main.js",
  "capabilities": ["LIBRARY_READ"],
  "pages": [{ "id": "main", "path": "index.html" }],
  "actions": [{ "id": "count" }]
}

main.js

retromao.define({ actions: {
  async count() {
    const page = await retromao.library.records({ limit: 200 });
    await retromao.tasks.progress(page.games.length);
    return { total: page.games.length };
  }
} });

安裝「收藏同步」？這個外掛程式需要以下能力：

讀取和修改遊戲庫
使用你允許的網盤連線

同意並啟用

外掛程式系統開發外掛程式 RetroMao-Community

現在就能在商店安裝

這些外掛程式都用同一套公開 SDK 開發，也是可參考的範例。

收藏同步透過已設定的網盤同步收藏，不傳輸 ROM、媒體或存檔。
最近遊戲紀錄同步同步最近遊玩時間、次數和時長。
拼音首字母搜尋用拼音首字母搜尋遊戲和應用程式，例如 jsq 搜尋計算器。
Vita3K ROM 同步同步 Vita3K 的遊戲本體、更新、DLC 與授權。
自訂啟動入口選擇機種並自訂模擬器啟動參數。

四種擴充方式

擴充都放在公開的 GitHub 倉庫裡，開發時不需要主程式原始碼。

準備好把遊戲擺上架了嗎？

下載復古貓

復古貓不附帶任何遊戲 ROM、BIOS 或模擬器。

把卡帶和光碟，重新擺回架上。

每台機器，都有它自己的盒子

選一次資料夾，其他交給它

選擇 ROM 總資料夾

自動比對媒體

按下 A 開始遊戲

存檔跟著你走，版本由你決定

控制器優先，也適配各種螢幕

不只是前端，也是一個平台

能做真正的功能

有自己的介面

權限由玩家決定

不拖慢遊戲

發布不用等我

現在就能在商店安裝

四種擴充方式

準備好把遊戲擺上架了嗎？