Go to file
Max Bradbury 5b18892bb4 add `bitsy-dedupe` executable 2020-07-01 15:11:43 +01:00
.github/workflows remove rustfmt 2020-04-19 07:37:36 +01:00
src add `bitsy-dedupe` executable 2020-07-01 15:11:43 +01:00
.gitignore move test resources 2020-04-14 00:17:40 +01:00
Cargo.toml implement Clone 2020-05-31 16:12:23 +01:00
LICENSE Create LICENSE 2020-04-05 18:59:30 +01:00
README.md fixed palette IDs 2020-06-28 18:30:33 +01:00

README.md

bitsy-parser

Rust Crates.io

a library for parsing Bitsy game data.

the version number follows Bitsy itself, so version 0.70.* targets Bitsy 7.0.

how to use

a simple example program:

extern crate bitsy_parser;
use bitsy_parser::game::Game;
use std::{env, fs};

fn main() {
    let input_file = env::args()
        .nth(1)
        .expect("No input path specified. Usage: `bitsy-validate filepath`");

    Game::from(fs::read_to_string(input_file).unwrap()).unwrap();

    println!("OK!");
}

some more practical uses would be things like:

  • remove duplicate tiles
  • merge two Bitsy games together
  • programmatically create Bitsy games
  • a Bitsy game editor

todo

  • implement Result return types on ::from functions so that we can handle errors
  • replace Image with Vec or something. seems like a pointless abstraction.
  • replace game avatar with helper functions to get and set the sprite with an ID of A
  • implement PartialEq for tiles etc. for the sake of checking for duplicate tiles?
  • dedupe functions for tiles, sprites, etc.
  • tests for merge function
  • all sprites from the merged game get placed in their respective game's Room 0
  • exits in merged rooms do not work - the on-screen position is correct, but the room ID is wrong
  • add update function (i.e. migrate an old game version to the current one) - would this work?

tidy up

  • refactor the more shonky bits to idiomatic rust