Playable Gameboy

About

Adds a playable Gameboy. You can find options at Spawnmenu (Q) -> Options (On the right) -> Gameboy Options. Please, read entities descriptions in the spawn menu (hover the cursor above the entity icon) before using them.

Warning

The addon may negatively affect a performance If you experience problems with this addon write a comment.

Setup

Before playing a gameboy you need roms to load. They should be placed in the server's data/gb/roms directory within gmod root directory (On Windows the full path might look like this: C:\Program Files (x86)\Steam\steamapps\common\GarrysMod\garrysmod\data\gb\roms). This folder is created automatically upon addon launching . Roms must be uncompressed, such as game.gb. There are special names for roms that makes them treated differently from other:

• default.gb is a rom that is set as cartridge's (i.e. being contented by cartridge) on its creation.
• bootrom.bin is a rom run first during gameboy's startup. It is optional. Without it a console will launch with no startup screen and will jump directly to a game.

Loading Game

Spawn a cartridge. Open context menu (on C). Right click a cartridge and press Edit. In the opened window select rom file. Drop a cartridge into a gameboy. Turn on a gameboy

Cartridges and Saves

Other actions can be done by right clicking a cartridge in the context menu. In order to make a gameboy save game progress a cartridge must be registered. This creates a register, representing the cartridge, that contains cartridge properties and is connected to a dedicated game save file. Later, all cartridge properties and the save can be restored by linking the cartridge to the register. Or vice versa, it's possible to unload them by unlinking the register. In simple terms, a register is a save of cartridge data, registering is saving, linking to a register is loading the save.

Credits

Models by Saladin Insane