Skip to content

phrohdoh/easage

Repository files navigation

easage

Build Status Build Status GitHub (pre-)release Chat on IRC

A library that provides programmatic manipulation of BIG archives.


What is a BIG archive?

BIG files are an archive format used in many games published by Electronic Arts. The supported features vary between games, with some using compression or encryption, but for SAGE, the files are trivially concatenated together and wrapped with a header containing a series of index entries that located a given file within the archive.

Note: The above was lifted directly from https://github.com/TheAssemblyArmada/Thyme/wiki/BIG-File-Format

Notable games built on the SAGE engine are:

  • Battle For Middle-Earth (1, 2, RotWK)
  • Command & Conquer Generals (and the expansion Zero Hour)

Building

You must have the Rust toolchain installed (which includes cargo):

cargo build --release

Testing

To run the included unit tests execute the following command in the root of the project:

cargo test

We do require that all tests pass before a PR is merged.

If you need help getting a test to pass (existing or one you have written) do not hesitate to reach out to us (either via GitHub issues or on IRC).

Running

Included in this source tree is a command-line application named easage that uses the easage library.

See the src/bin/ directory for more details.


See contrib for more usage suggestions.

Getting help

I am often present in the #orcaware channel on irc.freenode.net.

Note that this channel has many topics of discussion so you may see conversation about other projects there too.

If IRC is not your thing or you don't get a good response I am happy to respond to GitHub issues as well.

License

MIT

Contributing

Any contribution you intentionally submit for inclusion in the work, as defined in the LICENSE.md file, shall be licensed as above, and are subject to the project's CLA.

About

A library that provides programmatic manipulation of BIG archives.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published