Skip to content
/ sham Public

A tool with various abilities to help Halo content creation by interfacing with various file formats (JMS, etc).

Notifications You must be signed in to change notification settings

JeBobs/sham

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sham!

Currently working on a major rewrite!

A C# command-line tool with various abilities to help Halo content creation by interfacing with various file formats (JMS, etc). This app is still very early in development. Features and code structure is subject to change.

Usage

Installing & Running

  • Check the releases page for the latest stable version of Sham!
  • Download the executable archive & unzip the package into your H2EK or H3EK directory.
  • Run using your favorite command-line program (cmd, PowerShell, Windows Terminal, Hyper, Bash, etc).

Commands

Implemented:

        help <command> - Either shows the help screen or provides help for a command.
        GenerateH2Shaders [JMS File] - Generates empty Halo 2 compatible shader files for each material slot.
        JMCompress [JMS/JMA Variant File] <output path> - Takes an input JMS/JMA/JMM/JMO/JMI file and removes white-space & comments.

Planned:

        GenerateH3Shaders [JMS File] - Generates empty Halo 3 compatible shader files for each material slot.

Compatibility

Sham! will run on any OS capable of running .NET Framework 4.0, including but not limited to:

  • Windows 2000 (Extended Kernel Required)
  • Windows XP
  • Windows Vista
  • Windows 7
  • Windows 8/8.1
  • Windows 10
  • Windows 11
  • Linux (Through Mono/Wine)

Build Instructions

To build Sham!, you only need .NET 4.0 features installed. Newer versions of .NET all the way up to .NET 7 work, but if you're targeting the compatibility listed above, you will need to target .NET 4.0.

Originally I wanted to reach a very broad set of operating systems with one small executable, but I may decide to bump the minimum version if significant improvements are brought using a newer C# version.

Contributing

If you would like to contribute, feel free to create a pull request with your feature.

About

A tool with various abilities to help Halo content creation by interfacing with various file formats (JMS, etc).

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages