https://github.com/annsanns/shoprunner_gbahb_rs

https://github.com/annsanns/shoprunner_gbahb_rs

Last synced: 9 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/annsanns/shoprunner_gbahb_rs
• Owner: AnnsAnns
• Created: 2023-08-20T20:36:46.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-08-22T20:26:15.000Z (about 1 year ago)
• Last Synced: 2023-10-09T00:24:14.825Z (about 1 year ago)
• Language: Rust
• Size: 25.4 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# AGBRS template

## A basic template example for agb projects

This makes getting started with a new project for the Game Boy Advance in rust really simple, by providing

all the boiler plate files for you.

## Building

### Prerequisites

You will need the following installed in order to build and run this project:

* A recent version of `rustup`. See the [rust website](https://www.rust-lang.org/tools/install) for instructions for your operating system

You will also want to install an emulator. The best support in agb is with [mgba](https://mgba.io), with

`println!` support via `agb::println!` but any emulator should work. You'll get the best experience if

`mgba-qt` is in your `PATH`.

If you want to run your game on real hardware, you will also need to install `agb-gbafix` which you can do after installing

rust with the following: `cargo install agb-gbafix`. This is not required if you are only running your game in an emulator.

### Running in an emulator

Once you have the prerequisites installed, you should be able to build using

```sh

cargo build

```

or in release mode (recommended for the final version to ship to players)

```sh

cargo build --release

```

The resulting file will be in `target/thumbv4t-none-eabi/debug/` or `target/thumbv4t-none-eabi/release/` depending on

whether you did a release or debug build.

If you have `mgba-qt` in your path, you will be able to run your game with

```sh

cargo run

```

or in release mode

```sh

cargo run --release

```

## Starting development

You can find the documentation for agb [here](https://docs.rs/agb/latest/agb/).

You may also want to change the package name and version in `Cargo.toml` before you start.

## Shipping a .gba file for real hardware

To make a game run on real hardware, you will need to convert the built file into a file suitable for

running on the real thing.

First build the binary in release mode using the instructions above, then do the following:

```sh

agb-gbafix target/thumbv4t-none-eabi/release/ -o .gba

```