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.4.1.tar.gz (251.4 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.4.1-py3-none-any.whl (276.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for refinery-2.4.1.tar.gz
Algorithm Hash digest
SHA256 17d08d8423efa5b3b4095d71b39ba704c6af61bd9f1f573ab55398c8841619a6
MD5 959833a7f7ac50ae0f2ebbf356755d09
BLAKE2b-256 70c2e8034041814e4b8d9dcb17d9585639cebe662b2aabf19cfd19a1204c4858

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for refinery-2.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7b2f1e62f922d7111d35a63812cd6363004a4bb0ce613ce002790a48485403c0
MD5 694613894410c72238103d4d336bc314
BLAKE2b-256 a0d3965bd4d3fd13b8dcf8eac56138dbedef74099f393bbfed55eae05068d185

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