Addition: Readme / Wiki text

[lunchpacked130]

This is taken from my guide on my KQ6AGI_GBAGI github, but it could be useful here too, so I'm sharing it here.

Feel free to use as-is or make changes.

How do I use GBAGI to convert AGI games to GameBoy Advance rom?

If you'd rather make your own rom, or convert some other AGI games from your collection, just follow this simple guide.
(Images are from a previous version, but the layout is identical.

First you'll need the game files for the AGI game you want to port and GBAGI.
For this guide I'm using KQ6AGI, but any AGI game should potentially work.
The procedure is identical for all AGI games

Important

GBAGI is Windows only (Sorry)

1) downloads and preparations

Download GBAGI from here

OPTIONAL! Download KQ6AGI DeMake from here

Note

KQ6AGI is only needed if you want to play King's Quest VI AGI DeMake.

Tip

I've added a list of Official Sierra AGI engine games section further down with links to GOG.com where you can purchase some of the games.

Tip

I have also provided links to 5 Sierra AGI demo packs in the ** Downloads ** section further down.

Note

You will have to provide any other AGI games yourself.

2) Extracting and getting things ready.

Extract the contents of gbagi-bin-2.××.zip (or the most recent release) to its own folder, then
Extract or copy the AGI games you want to port to GBA to their own subfolders within the folder.

Note

You dont have to do this, but it's a good way to keep things simple, clean and safe, and i prefer working with copies instead of my original files "just in case"

3) Starting the GBAGI porting tool

In the GBAGI folder, start "gbinject.exe"

4) Adding Games

Select [Add Game] (D) and navigate to the root folder of the AGI game you want to add

Caution

Don't touch fields (A) and (B) unless you know what you're doing.
In field (C) you can edit the path and rom filename to your liking.
pressing [Browse...] let's you easily select another location and filename to save the GBA rom file
(Default name and location is "agigames.gba" located in the same folder as gbinject.exe)

5) Settings and Names

GBAGI should detect the settings automatically so you should not have to touch anything here, just press OK

Note

The names from step 5 is used for the menu entry.
You can change the in-ROM game name using the highlighted textbox, but it is only useful if you plan to add more AGI games to the same ROM,

Tip

GBAGI will boot directly into the game if there is only one game in the rom.

Note

If you add more than one game, the rom will boot into a simple menu instead of directly into the game.
The names from step 5 is used for the menu entries.

Tip

My advice is to make 1 romfile per game
it makes it easier to find and avoids any potential savestate issues or similar.

Tip

If you're going to burn the rom onto chips to be used on a real cartridge, then it makes more sense to have multiple games available on one cart.

6) Injecting the AGI game(s) into GBA roms

The game chosen in step 4 should now show up in the Games To Inject field of gbinject.

Important

If you want to add more AGI games to this ROM, stop here, go back and and repeat the process from step 4.

When you are finished adding games, continue below)

When you have added the game(s) you want to port,
Press [Build ROM]

7) Conglaturatons, your winer!

You now have one or more GBA ROMfile(s) with AGI game(s) ready to be played on emulators, fpga and/or real hardware using a flashcart etc.