Skip to content

SamDamDing/Halo-Asset-Blender-Development-Toolset

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Halo-Asset-Blender-Development-Toolset

Toolset Description

The Halo Asset Blender Development Toolset is a Blender addon developed in python to aid with creating assets for multiple Halo titles. This addon requires that you have Blender 3.1.0 or above on your system to function.

Supported Titles and Features

The following games are or will be supported by this script:

  • Halo Custom Edition
  • Halo 2 Vista
  • Halo Combat Evolved Anniversary MCC - Classic
  • Halo 2 Anniversary MCC - Classic
  • Halo 3 MCC
  • Halo 3 ODST MCC

Script supports the following features:

Feature Halo Custom Edition/Halo Combat Evolved Anniversary MCC - Classic Halo 2 Vista/Halo 2 Anniversary MCC - Classic Halo 3 MCC/ Halo 3 ODST MCC
Levels (JMS) Full Support Full Support N/A
Levels (ASS) N/A Full Support Partial Support1
Levels (GR2) N/A N/A N/A
GBXmodel (JMS) Full Support N/A N/A
Render Model (JMS) Full Support Full Support Full Support
Render Model (GR2) N/A N/A N/A
Collision Geometry (JMS) Full Support Full Support Full Support
Collision Geometry (GR2) N/A N/A N/A
Physics Models (JMS) Full Support Partial Support2 Partial Support2
Physics Models (GR2) N/A N/A N/A
Animations (JMA) Full Support Full Support Full Support
Animations(GR2) N/A N/A N/A
Cinematics(QUA) N/A N/A Partial Support (WIP)
JMI Exporting Full Support Full Support Full Support
WRL Importing Full Support Full Support Full Support
JMS Importing Partial Support3 Partial Support23 Partial Support23
JMA Importing Full Support Full Support Full Support
ASS Importing N/A Partial Support3 Partial Support31
QUA Importing N/A N/A No Support (WIP)
GR2 Importing N/A N/A N/A
Structure_BSP Tag Importing Partial Support4 Partial Support 45 No Support (WIP)
GBXModel Tag Importing Full Support No Support(WIP) No Support (WIP)
Model Tag Importing Full Support No Support (WIP) No Support (WIP)
Collision Tag Importing Full Support No Support (WIP) No Support (WIP)
Animation Tag Importing Partial Support6 No Support (WIP) No Support (WIP)
Camera Track Tag Importing Full Support No Support (WIP) No Support (WIP)

Documentation

See the following links for information on exporting or importing assets from these tools:

C20 Docs

H2Codez Docs

Credits

  • Cyboryxmen

    • For making the original JMS script known as WaltzStreet that was used as a reference.
    • WaltzStreet
  • Discord user Aerial Dave#2236

    • For making the original ASS script known as blend2halo2 that was used as a reference.
    • Blend2Halo2
  • Discord user con#4702

    • For testing, suggestions, a bug fix, and the WRL import code that is being used for this project.
    • WRL to OBJ
  • Discord user MercyMoon#3864

    • For developing the Halo materials tool Helper scripts in the toolset.
  • Discord user Fulsy#1228

    • For some modifications done to the WaltzStreet version the script was based on.
  • Discord user MosesofEgypt#2751

    • For some modifications done to the WaltzStreet version the script was based.
  • Discord user num0005#8646

    • For help with code reviews and several features.
  • 343 Industries/Discord user kornman00#4155

    • Thanks to Kornman for aiding the development of the toolset by answering questions and 343 Industries/Microsoft for allowing this to happen in the first place.
  • The Sigmmma crew

    • For some tips on importing assets and for MEK defs along with some math used in the Halo 1 tag importing code.
    • Sigmmma
  • Discord user General_101#9814

    • Getting the ball rolling I guess?

Footnotes

  1. Toolset is currently missing support for importing or exporting certain Halo 3 JMS/ASS features such as the W coordinate in UVW. 2

  2. Car wheel and prismatic constraints are not exported or imported properly. WIP 2 3 4

  3. JMS/ASS files imported into Blender do not have their triangles connected properly. This means that imported models are improper due to the exporter using vertex normals instead of loop normals. 2 3 4 5

  4. Weather polyhedras is currently not exported. 2

  5. Halo 2 level imports currently only do the level collision. It does not import any of the other geometry in the level.

  6. Imported animations tags currently do not have fixed overlay animations. Compressed animations are also currently not supported.

About

CE/H2/H3/ODST JMS/JMA/ASS exporter for Blender

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%