Skip to main content

A map extractor for games built with the Blam engine

Project description

Refinery is a map extractor for games utilizing Bungie's Blam engine.

Here's a list of what Refinery can currently do: * Load and extract tags and data from Halo 1 Xbox, PC, CE, PC Demo, and Yelo maps * Load and extract tags and data from Stubbs the Zombie maps on PC and Xbox * Load and extract tags and data from CE(not PC) resource maps(loc.map, bitmaps.map, and sounds.map) * Load and extract data from Halo 2 Vista maps

* Display all pertinent information contained in the map's header, tag index, 
    scenario bsp headers, and Open sauce header(if it exists).
* Has 3 ways to view the map contents: hierarchy, class, and hybrid
    Hierarchy sorts the tags by folder, like a regular directory structure.
    Class sorts all tags by their class(bitmap, gbxmodel, weapon, etc)
    Hybrid combines the two. It sorts everything by class, then inside
    each class is a directory structure of all tags of that class.

* Extract all Halo 1 tags
* Extract all Open sauce tags
* Extract the cheape.map from Yelo maps
* Extract most Stubbs the Zombie tags(excludes vege, imef, terr, bipd, vehi, and
    obje tag classes)
* Fix mangled class names(aka Zteam protection)

* Decompress and save Xbox maps
* Save any loaded non-resource map(rearranges structures and renames protected
    tags so the map can be opened by other map tools)

* Allows you to rename tags and folders of tags in any loaded non-resource map(tags
    have to at least partially exist in the map to rename them, i.e. they cannot be
    in a resource map.)
* Allowspreviewing any tag in the map as if loaded in Mozzarilla. Changes made
    to the tag will NOT be saved to the map. Exporting works in the window, but rawdata
    will be in little-endian and other meta-specific details will not have been tweaked,
    so don't expect to be able to properly import ANY exported block into a tag.
* Allows extraction by tag class as well as by folder or individual tags.

Here are all the known bugs that I can think of right now(I plan to fix them): * Tag explorers might not be sorted if you edit them(if you rename an entire folder and it disappears from the tree, it will be added to the bottom instead of alphabetically)

So now that you've read all that, here's a few tips on using Refinery: * You can double click an item in the map explorer(or select multiple and hit enter) to either rename it/them, add it/them to the queue, or preview the tag(only if selecting individual tags). * Renaming a folder to one that already exists puts all tags in that folder into the new one. * Renaming is case insensitive, and everything gets converted to lowercase. It's just easier this way. * If you just want stuff from the bitmaps.map, sounds.map, or loc.map just load that map up instead of an actual map. * If you only want one type of tag(all bitmaps) then change the explorer to "class" view, select the tag class(bitm in this case), and add it to the queue. * You can edit the details of something in the queue by double clicking it.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

refinery-2.3.1.tar.gz (237.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

refinery-2.3.1-py3-none-any.whl (264.1 kB view details)

Uploaded Python 3

File details

Details for the file refinery-2.3.1.tar.gz.

File metadata

  • Download URL: refinery-2.3.1.tar.gz
  • Upload date:
  • Size: 237.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.8.0

File hashes

Hashes for refinery-2.3.1.tar.gz
Algorithm Hash digest
SHA256 6a337badd90ae864e0b54a820d3a55a9a40c93d1c311957811690cc94fc0ed76
MD5 4e3928a9e19d62cc4189a0506dccba4f
BLAKE2b-256 d6d48ae5e49d6b0e623cb551a10942b80259569f8a181ad50cd517371e5cb01d

See more details on using hashes here.

File details

Details for the file refinery-2.3.1-py3-none-any.whl.

File metadata

  • Download URL: refinery-2.3.1-py3-none-any.whl
  • Upload date:
  • Size: 264.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.8.0

File hashes

Hashes for refinery-2.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b202cb992a2d6d7ee3194cf496bdad736414c408d70527efd08b2a17b1b200ea
MD5 4083f8168c6eee949c86fb393ff7a7a9
BLAKE2b-256 ffc5cfc2bf776a610211dce804fa7501010a7f0ce3a986b3936551b621addbad

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page