GBA Forge for PS3 1.0.0
=======================

Packs a Game Boy Advance, Game Boy or Game Boy Color game you own into its own PS3 package (.pkg).
Each game installs as its own XMB icon, with its own background, on a PS3 with HEN or custom
firmware, and boots straight into the game (mGBA 0.10.5, with its built-in BIOS).

Getting started
---------------
1. Unzip this folder anywhere and run GBAForgeForPS3.exe. Keep the "launcher" folder next to it.
2. Drop .gba, .gb, .gbc or .mb (GBA multiboot) files on the window, or click "Add games...".
3. Pick a game in the list and check its title on the XMB and its title ID. Under Art, keep the icon
   and background drawn from the title, or use "Choose image..." or "Search online...". Below that,
   set how it plays: Picture, Filter (Sharp, Smooth, LCD grid, CRT), Buttons, Frame blending,
   Where you left off, and for a GBA game its Save type and Clock.
4. Click "Build all" (or "Build this game"). The packages go to the PKG folder, which is next to
   GBAForgeForPS3.exe unless you change it in Settings. "Open PKG folder" opens it.
5. Install them on the PS3, either way:
   - Send to PS3: type your PS3's IP address in Settings (on the PS3: Settings > Network Settings >
     Settings and Connection Status List) and click "Test". With webMAN MOD running on the console,
     "Send to PS3" or "Send all to PS3" installs new games for you, and updates games that are
     already installed in place, keeping their saves.
   - By hand: copy the .pkg to the top of a FAT32 USB stick (or to /dev_hdd0/packages/ over FTP)
     and install it from Game > Package Manager > Install Package Files > Standard.

The "Install guide" tab has the same steps in more detail. The "On your PS3" tab lists the GBA Forge
games on the console, each with Update, Back up and Remove, and backs up or restores every game's
saves.

On the PS3
----------
Cross / Circle      A / B (the other way round if the game's Buttons say so)
L1 / R1             L / R
Start, Select       Start, Select
D-pad, left stick   D-pad
R2                  fast-forward
hold L2             rewind
tap L2, or R3       the pause menu (save states, picture, filter, colours, speed, language)
hold R3 + L1 / R1   quick save / quick load
L3                  show the frame rate
PS button > Quit Game   back to the XMB (the game's save is written first)

Starting a game you left offers "Continue where you left off" (or continues straight away, or
starts from the beginning, as set in Where you left off). Saves live in
/dev_hdd0/game/<title ID>/USRDIR/saves/.

Updating a game
---------------
Use "Send to PS3", or "Update" on the On your PS3 tab: the game is updated in place and its saves
stay. Don't install a new PKG by hand over an installed copy. Delete the old one from the XMB
first, and copy USRDIR/saves off over FTP before you do, because deleting it deletes its saves too.

Your files
----------
settings.json, the title IDs (gbaforge-titles.json) and the "PKG", "Art cache" and "Save backups"
folders are kept next to GBAForgeForPS3.exe. If this folder can't be written to, the two files go
in %LOCALAPPDATA%\GBAForge and the folders in Documents\GBA Forge for PS3. To move to a new
version, copy them into the new folder: the title IDs keep each game's ID the same.

Optional BIOS: mGBA's built-in BIOS is used. If you have a dump of your own GBA's BIOS, copy it
as gba_bios.bin into a game's USRDIR over FTP. It is never put in a package.

App icon: "Game boy advance" icon by Marcus Christensen, Flaticon
(https://www.flaticon.com/free-icons/game-boy-advance), recoloured.

Licences: LICENSES/. No games, BIOS files or box art are included. Art is only downloaded when you
search for it and pick a picture.
