Tea 中文

Playing games

Play from the game page: choosing emulators and cores, button layouts, multi-disc games, BIOS, PS Vita, PC games, the floating button and play time.

Start a game

Play and the emulator on the game page
Play and the emulator on the game page

  1. Pick a game in the Library to open its game page.
  2. Play is already selected; press A to start.
  3. When you're done, quit the emulator normally to return to Tea.

Want A in the Library to start the game straight away, skipping the game page? Turn on Quick launch game under Settings → Interface: from then on A / a tap plays the game and LT + A shows details; a long press on a game always opens details.

The Play button shows the current emulator. It may instead read:

Tip: for games with save sync on, Tea gets the latest save ready in the background as soon as you open the game page, so Play starts right away. See Save sync.

Choose an emulator and core

Open Choose emulator from the Emulator row on the game page (or press Y):

What a choice applies to:

Action Effect
Pick one directly This game only
Apply to all Every game for this console (FC and NES, SFC and SNES count as the same console)
Apply to this tab Only for games opened from a custom tab: every game in that tab uses it; the main tabs aren't affected

Between a single game's choice and Apply to all, whichever you set last wins.

Install in Utility appears in the window only when none of the usable emulators is installed.

RetroArch cores

Emulators for common consoles

The table follows the order in the choose window; the first is recommended. Entries marked "(core)" are RetroArch cores.

Console Emulators
GB / GBC Gambatte, SameBoy, Gearboy, mGBA (core)
GBA mGBA, VBA-M, gpSP (core), My Boy! (if installed)
FC / NES FCEUmm, Nestopia UE, Mesen (core)
SFC / SNES Snes9x, Snes9x 2010, bsnes (core)
MD / Mega CD Genesis Plus GX, PicoDrive (core)
Game Gear Genesis Plus GX, Gearsystem (core)
PC Engine / PCE CD Beetle PCE FAST, Beetle PCE (core)
Saturn YabaSanshiro, Beetle Saturn (core), Yaba Sanshiro 2 (if installed)
Arcade (Neo Geo, CPS1–3, FBNeo) FinalBurn Neo, FinalBurn Neo Plus, MAME 2003-Plus, MAME (Arcade), MAME, MAME 2003 (core), MAME4droid
NAOMI Flycast (core), Flycast
DC Flycast, Flycast (core)
N64 M64Plus FZ, Mupen64Plus-Next, ParaLLEl N64 (core), M64Plus FZ Pro (if installed)
PS1 PCSX ReARMed (core), DuckStation, SwanStation, Beetle PSX HW (core)
PS2 ARMSX2, NetherSX2
PS3 ARMSX3
PSP PPSSPP, PPSSPP (core)
PS Vita Vita3K, Vita3K+, Vita3K (core)
NDS melonDS, WatermelonDS, DraStic, melonDS DS (core)
3DS AzaharPlus, Citra-MMJ, Citra (天马包, Pegasus pack), Lime3DS (if installed)
GameCube / Wii Dolphin, Dolphin MMJR2-VBI
Wii U Cemu, Cemu (core)
Switch Eden, Lemon, Eden Nightly, STORM SWITCH (if installed)
PC GameNative, GameHub Lite, WinNative, DroidDeck

Emulators marked "(if installed)" can't be downloaded in Utility; they show up in the list only if you've installed them yourself.

Tip: for PS1, PCSX ReARMed is recommended: it runs smoothly even on low-end handhelds and needs no BIOS. To use DuckStation instead, pick it once on the game page.

Custom launch

At the bottom of the choose window is Custom launch: any app on the device can launch games, and you can also give a supported emulator a different launch method (except RetroArch and RetroArch G).

  1. Tap Custom launch and pick an app from the list (press Y to search).
  2. Enter a command in the Command window. If you know ES-DE or 大鸡手 (Daijishou), you can paste their launch arguments as they are. Not sure what to write? Tap ✦ Generate and let the AI write it (an AI feature, see AI features).
  3. Tap Try, and when you're back in Tea answer Did the game start?: choose yes to save it; if it didn't start, edit the command, or tap Generate again for another way.
  4. Some apps don't accept games from outside: choose Open app only, then pick the game inside the app.

Commands are saved per app and console, and with sync on they follow you to your other devices. Tap Remove when you no longer need one.

Games started with a custom launch still record play time, but get no save sync, cheats or floating button.

Button layout

RetroArch treats the right-hand button as A by default. For Nintendo consoles you can make the button printed A on your controller be A in the game:

  1. Open the game page of an FC, SFC, GB, GBC, GBA, NDS, 3DS, Switch or Wii U game and pick a RetroArch core.
  2. A button layout row appears under Emulator; tap it to cycle: Default layout → Nintendo layout → Xbox layout.
  3. It takes effect the next time you start the game.

Multi-disc games

Disc games
Disc games

Playing in RetroArch (PS1, Mega CD, Saturn, DC, PCE CD)

Tea creates a playlist (.m3u) in the game folder automatically and starts from it, so all discs share one memory card.

Note: only swap discs when the game asks you to. Swapping at any other time freezes the game.

Playing in other emulators

BIOS

You don't need to worry about most BIOS files: missing ones are downloaded automatically when you open the game page or tap Play. For PS1, Saturn and Mega CD, the Japanese, US and European versions are all fetched at once, so Japanese games and fan translations won't fail to start because of a region mismatch.

RetroArch cores (put in place automatically)

Console Cores that need a BIOS
PS1 SwanStation, Beetle PSX HW (PCSX ReARMed can do without, but it's provided too)
Saturn Beetle Saturn
Mega CD Genesis Plus GX, PicoDrive
3DO Opera
PCE CD Beetle PCE FAST, Beetle PCE
Lynx Handy, Beetle Lynx
FC Disk System (.fds) FC cores
GBA, NDS, DC Not required, but the same files are provided so quick saves load across devices
PSP Fonts for the PPSSPP core; without them games show no text
PS Vita System firmware for the Vita3K core
PGM arcade pgm.zip next to the game

Everything goes into RetroArch's system folder with nothing for you to do. If a download fails, the game page tells you which file is missing and where it goes.

Standalone emulators (import once)

Tea can't put files into these emulators' BIOS folders, so their BIOS is downloaded into bios/<console>/ in the Freedeck folder:

Emulator Folder How to use it
DuckStation bios/ps1 Import it in the emulator's BIOS settings (once)
ARMSX2, NetherSX2 bios/ps2 Same as above; US, Japanese and European versions are all there
melonDS, WatermelonDS bios/nds Pick these files in the BIOS options of the emulator's settings
Vita3K, Vita3K+ bios/psv In the emulator, install firmware with PSVUPDAT.PUP, then install the font package PSP2UPDAT.PUP
MAME4droid bios/mame On first launch choose external storage, then this folder

In Utility, these emulators' cards have a BIOS row that says where the files are. The game page tells you too; once you've read it, tap Got it at the end and it won't show again (it stays on the card).

Note: Switch, 3DS and Wii U keys and the PS3 firmware aren't downloaded automatically. Get them yourself and import them as the emulator's instructions say.

PS Vita

PS Vita games can use Vita3K, Vita3K+ (an experimental fork) or RetroArch's Vita3K core.

With Vita3K / Vita3K+

Vita3K only accepts games already installed in its storage folder. Recommended steps:

  1. In Vita3K's settings, change its storage folder to a folder on the SD card or internal storage (such as Vita3K). Tea usually finds it by itself; if not, tap Choose under Utility → Vita3K card → Vita3K's storage folder.
  2. Install the firmware in Vita3K (see the BIOS table above).
  3. Back in Tea, tap Play: the first start moves the game into Vita3K, and later starts open it directly. A .psvita file is left next to the game so other front ends can use it too.

With RetroArch's Vita3K core

It reads the game files where they are, with nothing moved. Firmware is downloaded automatically. Quick saves aren't supported.

3DS .cia install packages

AzaharPlus, Citra-MMJ and similar emulators can't run a .cia directly. For these games the button reads Open emulator name: install it once in the emulator via Menu → Install CIA, then run it from the emulator's game list. Formats like .3ds and .cci start directly.

Folder access hints

Some emulators (for example DuckStation with .cue discs, NetherSX2 and newer DraStic) can only open a game if you've added its folder in the emulator. When that's missing, the game page tells you in yellow that the emulator needs the folder added as a game folder in its settings; just add that folder in the emulator.

PC games

PC games run in GameNative, GameHub Lite, WinNative or DroidDeck, and must be added in those apps first. Set where PC games are stored under Settings → PC games.

App How to get one-tap Play
GameNative Add the game's folder in GameNative once, then Play starts the game directly. Its custom games, and Steam / Epic / GOG / Amazon games exported with its Frontend Sync (exporting to gamenative in the ROM folder is recommended), are listed in the Library automatically
GameHub Lite Tap Allow once on the GameHub Lite card in Utility (or on the game page), then tap Use this folder on the page that opens. From then on, games you add in it show up in the Library and Play goes straight into the game
DroidDeck Likewise, tap Allow once on the DroidDeck card or game page. Games added in DroidDeck start directly
WinNative Only opens the app; pick the game inside it

Android games

Turn on Android games under Settings → Interface and the Library gets an Android tab. Press Start or tap Choose apps to add native games from your device, and start them alongside your emulator games.

Floating button

The floating button is the small translucent cup in the bottom-right corner while you play a RetroArch game. Tap it to quick save, change bezels and shaders, or save and quit, without memorising RetroArch's hotkeys.

Turn it on

  1. Turn on Floating button next to Emulator on the game page (you can also add a Floating button tile to the pull-down Quick Settings).
  2. When asked, allow Tea to display over other apps.
  3. It needs the universal RetroArch (nightly), which is the version Utility installs. The stable RetroArch, the Play Store version and RetroArch G don't show the floating button.

The cup appears only when RetroArch can respond. It fades after a few seconds so it's less in the way; you can drag it around, and a long press hides it until the next game.

Note: with it on, RetroArch takes commands while a game runs; on a shared Wi-Fi, devices on the same network can send commands too. Take care on public networks.

What's in the menu

On the left are this console's bezels and shaders; tap one to switch. Shaders change at once; changing the bezel reloads the game automatically, keeping your progress where possible.

Buttons on the right:

Button What it does
Hide Close the menu
Save Quick save to the current slot
Save+quit Quick save, then quit RetroArch normally and return to Tea
Swap disc Multi-disc games only: lists every disc, tap one to switch to it
RA menu Open RetroArch's own menu
Quit Quit normally without a quick save (in-game saves are kept as usual)

With a few cores (such as YabaSanshiro for Saturn), quick saves crash RetroArch, so Save and Save+quit aren't available with those cores.

Quitting properly

To keep your progress and let saves sync, quit with Save+quit, Quit, or Close Content in RetroArch's menu. Leaving with Home or swiping RetroArch away in recent apps doesn't count as a normal quit.

Load the quick save at start

Settings → Emulator games → Load the quick save at start: with it on, RetroArch games load the latest quick save when they start, so you continue where you left off. Saves from Save+quit, Save and from other devices via sync all count. Standalone PPSSPP also loads slot 1.

Tip: when RetroArch's Run-Ahead is on for GBA to cut latency, Tea adjusts the settings automatically so in-game saves aren't lost.

Play time

Games started from Tea are timed automatically; game tiles, lists and the game page show something like "Played 3h 12m". Games you've played appear in Recently played. With sync on, play time follows you to your other devices.

What's different on the Steam Deck

The Steam Deck edition uses ES-DE's emulator settings (found automatically if EmuDeck is installed). In a game, press L4 + R4 to open the quick menu instead of the floating button; without EmuDeck, hold Select + Start to quit a game. See Steam Deck.