Zero Mission Hacking Toolkit (ZMHT)

[FelixWright]

ZMHT 0.3a

Latest version is on GitHub

ZMHT is a modular base for future zero mission ROMhacks. Every ASM is easily toggleable on and off via commenting them out in the main file, zmht.asm.

Howto:
◘ Put a vanilla MZM (U) rom in the extracted folder and rename it to [zm.gba]. 
◘ Drag [zmht.asm] over armips.exe and armips should spit out a file named [output.gba].
◘ To disable an ASM patch, open zmht.asm in a text editor and add a semicolon (;) in front of lines of patches you do not want to have applied. Then, re-run armips. It will overwrite the previous output.gba file.

[spoiler=To-Do]
◘ Possibly modify all the ASM to take up end-of-rom freespace so that crocomire is usable with this tool in the future
[/spoiler]

[spoiler=Credits]
biospark -- author of MAGE, provided lots of help putting this together. These were his contributions:
      Customizable 4th minimap color
      Enable Unknown Items (+ GFX / Text)
      Enable use of Power Bombs before Bombs
      Fusion style R-shotting
      Item percentage scaling
      Metroid Prime-style tractor beam (Suck in drops with charge beam)
      Mid-air ballsparking
      Removal of chozo statue hint system
      Remove intro closeup of Samus' face
      SM-style ability toggling in the status screen
      Adjustable Starting Room
      Two-Line Text Boxes

Captain Glitch -- Aside from general help with this project, his contributions include:
      Adjustable escape timers
      Better Morphball Rolling
      SM style controls
      SM style item grabbing
      Toggle missile select with R
      gravity suit taking heat damage
      shinespark steering
      speedbooster in morphball
      unlocking of Kraid's doors
      
Cosmic -- bullied biospark and glitch to make this a thing. Also added:
      Modified Capt. Glitch's faster item grabbing ASM to have a faster jingle (still needs work)
      Modified biospark's unknown items ASM so that any suit can have the fully powered gfx
      
JumZhu.Diwa -- Made the walljumping with space jump tweak

Passar -- author of the patch that makes borders on tiles less noticeable

Metroid_Prime_Stratton, Cosmic, Capt Glitch, raygun -- Decompiled version of Capt Glitch's Charge beam concentration ASM.

Metroid Advance Game Construction (MAGConst) -- The metconst subcommunity dedicated to hacking the GBATroids. Consider joining the MAGConst Discord server!

Metroid Construction -- The #1 source for all things hacking metroid! Official MetConst discord

Metroid: Zero Mission speedrunners -- provided lots of input on what to change in this hack. MZM Speedrunning Discord server
[/spoiler]

[spoiler=Version History]
ZMHT v0.2 -- 03/29/2020

Lots of ASM ported to end of ROM freespace.

New ASM:
- raygun's chargeHeal
- raygun's plasmaNerf
- Captain Glitch's new physics
- replaced Capt Glitch's SM Controls with raygun's
- raygun's SM Projectiles
- rewritten version of Capt Glitch's SM item grabbing
- Raygun's Fix for minimap graphics that have transparency

Customization:

Labels.asm
- Choose what determines suit GFX in the unknown items asm

Tweaks.asm
- Gravity heat vulnerability ASM replaced with a tweak
- No sounds after ship lands in intro
- Raygun's more detailed beam damage settings
- Enemies do not experience stun on hardmode
- Walljump with spacejump
- Speedball jumping
- Pseudo Screw Attack damage values
- Faster room transitions

ZMHT v0.1 -- 02/02/2020
◘ Split from Project ZM. Initial release.
[/spoiler]

[PHOSPHOTiDYL]

Now I know how gba asm works. Thankz!!

[FelixWright]

no problem! typically asm that replaces code and uses freespace goes all into one file but I broke them apart like this to make them compatible with each other. I will be releasing an update for this soon which should have every asm compatible, as well as add some new ones, and even port some to end of rom freespace which can be adjusted.

[FelixWright]

ZMHT v0.2 -- 03/29/2020

New ASM:
- raygun's chargeHeal
- raygun's plasmaNerf
- Captain Glitch's new physics
- replaced Capt Glitch's SM Controls with raygun's
- raygun's SM Projectiles
- rewritten version of Capt Glitch's SM item grabbing
- Raygun's Fix for minimap graphics that have transparency

Customization:

Labels.asm
- Choose what determines suit GFX in the unknown items asm

Tweaks.asm
- Gravity heat vulnerability ASM replaced with a tweak
- No sounds after ship lands in intro
- Raygun's more detailed beam damage settings
- Enemies do not experience stun on hardmode
- Walljump with spacejump
- Speedball jumping
- Pseudo Screw Attack damage values
- Faster room transitions

[FelixWright]

I will update this again someday, I swear!

For now, I've made a discord server for Project ZM, ZMHT, and maybe more in the future: https://discord.gg/AeXUeRw

[FelixWright]

I figure it's been far too long since I have updated this. While it's not an official release yet, this is a lot easier to use than 0.2 so here ya go. Some ASM are still going to be incompatible with each other, but most of them play nice. Happy hacking!

ZMHT v0.3 -- Work in Progress -- ??/??/2021
=============
Changes:
- Main ASM has been CLEANED UP! Only requiring one comment to toggle ASM on and off.
- Settings.asm, for easier access to labels meant to be changed (i.e. MaxPercent and BigSuit)
- smControls and smProjectiles had a few issues that are now squashed
- raygun's SM Controls and SM Projectile patches have had a minor change in case to match the other ASM: smControls and smProjectiles
- Captain Glitch's physics patch has been renamed to newPhysics, from glitchPhysX.

New ASM:
- raygun's better wall jumping: Samus normally needs to be touching something with the bottom of her hitbox to walljump off if it. This changes walljumping to use the middle of her hitbox. This can be adjusted to your liking.

[FelixWright]

ZMHT v0.3 -- 07/14/2022
Download from OP
=============
Changes:
- Main ASM has been CLEANED UP! Only requiring one comment in the main ASM to toggle stuff on and off.
- Captain Glitch's physics patch has been renamed to newPhysics, from glitchPhysX.
- Biospark's tractor beam ASM has been further improved by Captain Glitch, Quote, and Raygun.
- New physics have been made less slippery.
- Settings.asm, for easier access to labels meant to be changed (i.e. MaxPercent and BigSuit)
- further fixes to raygun's sm controls

New ASM:
- raygun's better wall jumping
- raygun's beam flare damage
- somerando(cauuyjdp)'s 5x3 minimap
- somerando(cauuyjdp)'s speedy doors (can be opened with shinespark)
- 3 block tall doors by yohann, somerando(cauuyjdp) and Cosmic
- jumzhu's walljump on frozen enemies
- raygun's per-weapon HUD digits
- raygun's low energy digits
- kiliwily's no bomb jumping when down is held
- kiliwily's bomb jump with power bombs
- yohann's faster save stations

New Tweaks:
- A lot man just go take a look lol i made sure to describe what they do
- Adjustable frame timers for running, spinjumping
- Showing charge beam muzzle flare during a spin jump
- Ballspark having the same delay before and after as shinespark
- Chozodian stations == Refill stations

[FelixWright]

My dumb ass forgot to test before shipping it. Short doors should work now. I also did some rearranging i.e. putting the GFX\ folder in the root directory, and freespace.asm in the options folder. available here or on main site.

[FelixWright]

ZMHT is now on github. https://github.com/Ckosmick/ZMHT/