3.1 KiB
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.
Licensed under the MIT License.
Features
- Package your game for multiple platforms. Supported platforms:
- Native (.love)
- Windows (.exe)
- macOS (.app)
- Linux (coming soon)
- Package your game for multiple versions of LÖVE. Supported versions:
- 11.x
- 0.10.2
- No external dependencies
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.3 for building
$ boon love download 11.3
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