A libray of SupyrStruct structures and objects for games built with the Blam engine
Project description
Reclaimer
What is this repository for?
- Reclaimer is a library of supyr_struct structure descriptors and tag definitions for creating and modifying data files for video games utilizing the Blam engine. These descriptors and definitions are currently limited to Halo 1(xbox, custom edition, and the community made "open sauce" variant) with some support for Stubbs the Zombie. There are plans to branch into Halo 2, though for now the "he2k" sub-module is just a placeholder. Some of the tag definitions have an accompanying object class with methods for manipulating the tag(recalculating inertial matrices in physics tags for example).
Installing
First install any version of Python 3(The newest version is recommended).
There are two ways to install reclaimer from this point:
- Open a command prompt and execute
pip install reclaimer
or
- Extract a copy of the repository into a directory titled "reclaimer".
- Move the file "setup.py" into the directory containing "reclaimer".
- Open a command prompt, navigate to the directory containing setup.py, and execute:
python setup.py install
- During install, python should try to download and install supyr_struct. If it fails to, you must install that as well.
Once the install finishes, reclaimer should be ready to use.
There are currently no test cases, but you should be able to directly import any tag definition from the python interpreter, build it, give it a filepath, and serialize it as shown below:
>>> from reclaimer.hek.defs.pphy import pphy_def
>>> asdf = pphy_def.build()
>>> print(asdf)
[ Container, entries:2, pphy
[ Struct, size:64, entries:6, blam_header
[ UEnum32, offset:36, size:4, tag_class, 1886414969
point_physics ]
[ UInt32, offset:40, size:4, base_address, 1299151482 ]
[ UInt32, offset:44, size:4, header_size, 64 ]
[ UInt16, offset:56, size:2, version, 1 ]
[ UInt16, offset:58, size:2, unknown, 255 ]
[ UEnum32, offset:60, size:4, engine_id, 1651269997
halo_1 ]
]
[ Struct, size:64, entries:9, tagdata
[ Bool32, offset:0, size:4, flags, 0
]
[ FlFloat, offset:4, size:4, wind_coefficient, 0.0 ]
[ FlFloat, offset:8, size:4, wind_sine_modifier, 0.0 ]
[ FlFloat, offset:12, size:4, z_translation_rate, 0.0 ]
[ Float, offset:32, size:4, density, 0.0 ]
[ Float, offset:36, size:4, air_friction, 0.0 ]
[ Float, offset:40, size:4, water_friction, 0.0 ]
[ Float, offset:44, size:4, surface_friction, 0.0 ]
[ Float, offset:48, size:4, elasticity, 0.0 ]
]
]
>>> asdf.data.serialize()
bytearray(b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00
\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00pphyMozz\x00\x00\x00@\x00\x00\x00\x00\x00\x00\x00\x00\x00\x01\x00\xffblam
\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00
\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00
\x00\x00\x00\x00\x00\x00\x00\x00')
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
reclaimer-2.11.2.tar.gz
(511.5 kB
view hashes)
Built Distributions
reclaimer-2.11.2-cp39-cp39-win32.whl
(924.0 kB
view hashes)
reclaimer-2.11.2-cp38-cp38-win32.whl
(924.0 kB
view hashes)
reclaimer-2.11.2-cp37-cp37m-win32.whl
(924.0 kB
view hashes)
reclaimer-2.11.2-cp36-cp36m-win32.whl
(924.0 kB
view hashes)
Close
Hashes for reclaimer-2.11.2-cp39-cp39-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e1c209aed4fadd29a8246dc7a44476c045ef156ec075fa65b7dd3ecb9abfa86d |
|
MD5 | 572bd18f0fd3fc7a7184dc21b415e28f |
|
BLAKE2b-256 | 4516ed5a4876602e1c45c7ba1d84347a2a5af08e990f9cf338bf0b275d420c3e |
Close
Hashes for reclaimer-2.11.2-cp39-cp39-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e723d69e51bf611ae24df18dcdaaedfc94438ac0efd6f9ffa52a42921ee89d5a |
|
MD5 | 7e606ef47272a3c2b9f018e84585902e |
|
BLAKE2b-256 | 731705f883458d268b5b06ac5adf110a4eac46078248aaf3acbb2c8c44df806d |
Close
Hashes for reclaimer-2.11.2-cp38-cp38-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cf98b8543a4690320992504d9a2139ce68a4a8d3c1cde684e5cbd1e054d563f4 |
|
MD5 | 287ec99a1a61532a8028a55dc46ed4a8 |
|
BLAKE2b-256 | 75d6b9c0a5056fd67c7bd93cc0a4410b61145db8f679934fbd66bbc2359509b8 |
Close
Hashes for reclaimer-2.11.2-cp38-cp38-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 41ced10653ea22ad2f7d6aeb9ad66fc9fb364f72983f491c71ad739579822226 |
|
MD5 | 311cfe7bc1a35274b6eb2c8fbaa1f522 |
|
BLAKE2b-256 | 99e148c9879a5cac3e118e0cfd3c82278a0fe0b4990c11b419307bc6a41a4533 |
Close
Hashes for reclaimer-2.11.2-cp37-cp37m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c101f8605995e4756f2ee29dd4ce60c1c29e8809828f0d58f713105e13ed46fd |
|
MD5 | 778931f1bc5ced1d403c1a68da9b581b |
|
BLAKE2b-256 | 0e652e20a0a6a57fc6285f84a7da12e8b42d1d31667fb1364f446b985caea227 |
Close
Hashes for reclaimer-2.11.2-cp37-cp37m-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a6858badf794a4956ced3615e483a07217ca8d2adb177659038b7df1bbe3e94d |
|
MD5 | 8d7806645715cfa723788ee19a71cb14 |
|
BLAKE2b-256 | 9409f9e8c90c83809e32afffcba677095e6f2c8d59b94e4ebf170682c97372b5 |
Close
Hashes for reclaimer-2.11.2-cp36-cp36m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ae2cb5326b3589c2215ae6ca98f71bef2530fb77758f849ec755ec0c241f58d6 |
|
MD5 | d2145d734fb94f332a78b6bb8f9e9c6a |
|
BLAKE2b-256 | bf768d2067a69947c5ccd9511d7655ef503c279965c740448b2b001f65ab9554 |
Close
Hashes for reclaimer-2.11.2-cp36-cp36m-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 85188023cfeef5f43010d2a87e7d1cfdfb8220f9b68c7be69cdd4c7331f81c28 |
|
MD5 | f9269c8c2f93f89f1f174ff0e740164a |
|
BLAKE2b-256 | b0bc89f4414ad93b31a09b056af6d5435960a3b4a7c4f92cfbfe2b689791c2cb |