https://github.com/KoffeinFlummi/armake
A C implementation of Arma modding tools (PAA conversion, binarization/rapification, PBO packing). (WIP)
https://github.com/KoffeinFlummi/armake
arma arma3
Last synced: about 1 year ago
JSON representation
A C implementation of Arma modding tools (PAA conversion, binarization/rapification, PBO packing). (WIP)
- Host: GitHub
- URL: https://github.com/KoffeinFlummi/armake
- Owner: KoffeinFlummi
- License: gpl-2.0
- Created: 2015-10-19T09:41:46.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2021-12-29T22:18:33.000Z (over 4 years ago)
- Last Synced: 2024-12-06T21:41:25.108Z (over 1 year ago)
- Topics: arma, arma3
- Language: C
- Homepage:
- Size: 26.8 MB
- Stars: 97
- Watchers: 30
- Forks: 34
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-arma - Armake - A C implementation of Arma modding tools (PAA conversion, binarization/rapification, PBO packing). [![Open-Source Software][OSS Icon]](https://github.com/KoffeinFlummi/armake) (Applications / Build Tools)
README
armake
======
[](https://travis-ci.org/KoffeinFlummi/armake)
[](https://github.com/KoffeinFlummi/armake/blob/master/LICENSE)
[](https://github.com/KoffeinFlummi/armake/releases)
[](https://aur.archlinux.org/packages/armake)
[](https://launchpad.net/~koffeinflummi/+archive/ubuntu/armake)
A cross-platform, open-source C implementation of Arma modding tools (PAA conversion, binarization & rapification, PBO packing, key generation and signing). It aims to provide a complete reimplementation of the entire process, but is able to use the official BI tools on Windows for building P3Ds if it can find them, as P3D conversion is still incomplete (and most likely will never be fully complete). Terrains and RTMs are not supported at the moment (I recommend binarizing RTMs once and then using the binarized version in your repo for now).
### Features
#### Designed for Automation
armake is designed to be used in conjunction with tools like make to build larger projects. It deliberately does not provide a mechanism for building entire projects - composed of multiple PBO files - in one call. armake itself also does not do any threading. However, it is safe to run multiple armake instances at the same time, so you can use make to run, say, 4 armake instances simultaneously with `make -j4`. For examples of Makefiles that use armake, check out [ACE3](https://github.com/acemod/ACE3/blob/armake/Makefile) and [ACRE2](https://github.com/IDI-Systems/acre2/blob/armake/Makefile).
#### Decent Errors & Warnings
armake aims to provide developers with expressive and useful error messages, without trying to be smarter than them. It allows disabling most warnings and tries to only error out if a complete build is impossible or impractical.
#### No P-drive
To enable armake to run on non-Windows systems without hacky workarounds, and because it's a terrible idea in general, armake does not make use of the P-drive for finding include files. Instead - like with other compilers - you provide the folders to search for includes in the armake call.
#### Determinism
Unlike other Arma modding tools, armake includes no timestamp information in the built files. This means that - given two identical source folders - armake will produce the exact same output, bit for bit. This means that your team doesn't have to distribute a single build to make sure you're each testing the same PBOs, you can simply build it in multiple places and compare file hashes. This doesn't include cryptographic operations of course.
Note that there can be newline differences in different instances of the same git repo, depending on your settings. While they don't matter for config rapification, files with weird newlines copied into the PBO directly might ruin your PBO's hash comparison.
#### Speed
(Tests ran on a 2 core Windows VM using PboProject v2.24.6.43 and armake commit 54079138)
### Setup
#### From Source
```
$ make
$ sudo make install
```
**Dependencies:**
- GCC
- OpenSSL development libraries (`libssl-dev` on Ubuntu)
#### Arch Linux
[PKGBUILD](https://aur.archlinux.org/packages/armake/) or [PKGBUILD (development)](https://aur.archlinux.org/packages/armake-git/)
```
$ pacaur -S armake # or use yaourt or whatever AUR helper you use
$ pacaur -S armake-git
```
#### Ubuntu & Other Debian Derivatives
[PPA](https://launchpad.net/~koffeinflummi/+archive/ubuntu/armake)
```
$ sudo add-apt-repository ppa:koffeinflummi/armake
$ sudo apt-get update
$ sudo apt-get install armake
```
### Usage
```
armake
Usage:
armake binarize [-f] [-w ] [-i ] []
armake build [-f] [-p] [-w ] [-i ] [-x ] [-k ] [-s ] [-e ]
armake inspect
armake unpack [-f] [-i ] [-x ]
armake cat
armake derapify [-f] [-d ] [ []]
armake keygen [-f]
armake sign [-f] [-s ]
armake paa2img [-f]
armake img2paa [-f] [-z] [-t ]
armake (-h | --help)
armake (-v | --version)
```
See `armake --help` for more.
### Thanks
- [Mikero](https://dev.withsix.com/projects/mikero-pbodll) for his great documentation of the various file formats used.
- [T_D](https://github.com/Braini01) for great documentation, lots of pointers and even some code contributions.
- [jonpas](https://github.com/jonpas) for all kinds of help with development and testing.
- [kju](https://forums.bistudio.com/user/768005-kju/) for some pointers and "PR work".
- [Glowbal](https://github.com/Glowbal) for the name.
- [4d4a5852](https://github.com/4d4a5852) for his work with [a3lib](https://github.com/4d4a5852/a3lib.py).
### Used Libraries
- [MiniLZO](http://www.oberhumer.com/opensource/lzo/)
- [STB's image libraries](https://github.com/nothings/stb)
- [Paul E. Jones's SHA-1 implementation](https://www.packetizer.com/security/sha1/)
### Disclaimer
This isn't official BI software. As such, it may not compile certain addons correctly or lag behind BI when new file format versions are introduced. As stated in the GPL, this software is provided without any warranty, so use at your own risk.
---
BTC 18bKjgqZ6E6sQFPNQL4SnCFNB9pLN2PJRk