Home

Awesome

boon

boon is a build tool for LÖVE. It makes it easy to package your game for multiple platforms, similar to love-release. It is a single executable with no other dependecies. It can be used across multiple projects and makes automated building a breeze.

Rust

Licensed under the MIT License.

Features

Getting started

Installation

Download prebuilt binaries (recommended)

boon has prebuilt binaries on the GitHub Releases page. Download the zip file, then extract the executable onto your PATH.

If you're a Windows user, download the boon-windows-amd64 file.

If you're a macOS user, download the boon-macos-amd64 file.

If you're a Linux user, download the boon-linux-amd64 file.

Usage

In general, if you need help figuring out how to use a command you can pass the --help option to see possible arguments, options, and subcommands. To get started and see the top-level commands and options, run boon --help.

Initialization

To start using boon with your project, it is recommended to first initialize it. This will create a Boon.toml file that will let you configure the settings for your project.

$ boon init

If you don't initialize boon, you can still build your project normally, but the default configuration will be used to build it instead. You can initialize it later, or create a Boon.toml file yourself.

Downloading LÖVE

In order to build your project, you first need to download the versionof LÖVE that you are using for it.

# Will download LÖVE 11.5 for building
$ boon love download 11.5

Building your project

Finally, to build your project just run boon build followed by where you want to run it. Usually, you just want to run it on the current directory, ..

$ boon build .

Without a target specified, this will build a .love file and put it in the release directory. This is shorthand for boon build <dir> --target love

It is possible to build all targets simultaneously by passing all as the target, for example, boon build . --target all.

Building for Windows

To build a Windows application:

$ boon build . --target windows

Building for macOS

To build a macOS application:

$ boon build . --target macos

Building for a different version of LÖVE

If you would like to build for a LÖVE version other than the default, you can specify it using the --version flag.

$ boon build . --version 0.10.2

Compiling from source

boon is written in Rust, so you will need to install Rust in order to compile it.

To build boon:

git clone git@github.com:camchenry/boon.git
cd boon
cargo build --release
./target/release/boon --version
boon 0.2.0