ascii-royale
Peer-to-peer battle royale in the terminal
TLDR
SYNOPSIS
ascii-royale command [options]
DESCRIPTION
ascii-royale is a battle royale game played entirely in the terminal. Up to 16 combatants fight on a procedurally generated ASCII island, with a shrinking storm that forces players together until one is left standing. Bots fill any empty slots, so solo play works without other people.Matches are peer-to-peer over the iroh networking library, with no central game server and no accounts: the whole game is a single binary. Players can drop into the public arena, browse and join open games, host their own match, or run a headless arena server. The same game is also playable in a browser.
PARAMETERS
--bots N
Number of bot players to add.--http-port PORT
Serve the web interface on the given port.--ticket-file PATH
Write the join ticket to a file.--stats-file PATH
Persist leaderboard data to a file.
PREVIEW
~~~~~~~~~~~~~ ~ . @ . o . ~ ~ . ### . . ~ ~ x . . . o ~ ~~~ storm ~~~
COMMANDS
play
Drop straight into the public arena.browse
List open games and select one to join.join ticket
Join a specific match using its ticket.host
Host a match. Accepts --bots N and --name NAME.solo --bots N
Play offline against the given number of AI opponents.serve
Run a headless arena server.
CONTROLS
w a s d / arrows
Move and set aim direction.f / space
Fire weapon (auto-aims at lined-up enemies).e / g
Pick up items.h / m
Use a medkit.t
Throw a grenade.M
Mute or unmute sound.q / Esc
Quit.
CAVEATS
Networking is peer-to-peer over iroh, so matches depend on direct connectivity between players. The project is built in Rust and is installed from source with a recent toolchain.
HISTORY
ascii-royale is written in Rust and distributed under the MIT license. It models the battle-royale genre in pure text, using iroh for serverless peer-to-peer play and 8-bit synthesized sound effects.
SEE ALSO
ninvaders(1), hunt(1), nethack-console(1)
