https://github.com/fatfingers23/untitled-gba

GBA Gamejam 2024
https://github.com/fatfingers23/untitled-gba

Last synced: 10 days ago
JSON representation

GBA Gamejam 2024

• Host: GitHub
• URL: https://github.com/fatfingers23/untitled-gba
• Owner: fatfingers23
• Created: 2024-02-06T13:33:03.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-02-11T05:39:57.000Z (9 months ago)
• Last Synced: 2024-05-02T02:43:42.991Z (7 months ago)
• Language: Rust
• Size: 202 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Untitled GBA Game for GBA Jam Week 2024

Just a simple side scrolling game for the GBA to learn more about agbrs and lower level game development. 

## 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/untitled-gba-game` or `target/thumbv4t-none-eabi/release/untitled-gba-game` 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/untitled-gba-game -o untitled-gba-game.gba

```