Amethyst Patcher is a collection of patches for Smash Hit.
New and exciting patches guaranteed!
For Smash Hit v1.4.3 arm64-v8a ONLY!
Made by KD
Amethyst Patcher is a collection of patches for Smash Hit.
New and exciting patches guaranteed!
For Smash Hit v1.4.3 arm64-v8a ONLY!
Made by KD
The guide will also be found at the start of the amethystPatcher.lua file.
Amethyst Patcher will NOT work on devices using armeabi-v7a libraries. Sorry! Requires KatieMod by knot126 (r19 or later).
1. Put amethystPatcher.lua in the assets/ directory (or somewhere else if you're feeling fancy)
2. Edit menu/main.lua:
At the very start:
knInclude("amethystPatcher.lua") (or a different path if you're moving it somewhere else)
At the start of init():
apnIitPatches()
apDefaultPatches()
3. Edit hud/main.lua:
At the very start:
knInclude("amethystPatcher.lua") (or a different path if you're moving it somewhere else)
At the start of init():
apInitPatches()
4. You may now call apPatch to patch something at any time!
Syntax: apPatch(patchName, arguments)
Example: apPatch("enablePremium"); executePatch("setScoreColor", 1.0, 0.5, 0.7)
5. Additionally, in the applyPatches function you can put patches that will be applied at the start of the game.
All patches will be listed at the start of the amethystPatcher.lua file. Make sure to check them all out!
Here are a few of the more interesting patches:
setPowerupTimer - Changes the default powerup duration
sprites8x32 - Changes the size of sprites.png to 8x32, effectively quadrupling the number of slots
uniquePowerupSprites - Sets the powerup sprite IDs to be 63 + powerup ID
setGameXmlName - Sets the path to game.xml
setLaserColor - Set the laser decal colors
Uploaded: July 8th, 2026 (Latest)
4a July 8th, 2026
New patches: setRoomTime, setThrowSpeed, disableMenuSegmentCulling, adjustCrashToCamera, adjustShootingToCamera, adjustMenuSmoke8x16, adjustMenuSmoke8x32
Removed patches: sprites8x24
Fixes:
showAllMenuSegments now works correctly
Menu smoke particle textures may now be corrected with adjustMenuSmoke patches
General changes:
Amethyst Patcher now requires KatieMod (r19 or later)
3a July 6th, 2026
New patches: disableLogging, showAllMenuSegments, setCameraPos, setCameraRot, doors2x4, doors2x8
General changes:
Patch arguments are no longer passed as a table, with the exception of patches called in apDefaultPatches()
Commands were merged with patches; commands and parameters are now called through apPatch()
Powerup timer patches now affect mgGetPowerupFraction()
Renaming:
[patch] powerupTimerInit -> initPowerupTimer
[patch] setPowerupID -> setCommandParameter
[command -> patch] ap.powerup -> activatePowerup
[command -> patch] ap.pushPowerup -> pushPowerup
[command -> patch] ap.popPowerup -> popPowerup
[function] applyPatches() -> apDefaultPatches()
[function] initPatches() -> apInitPatches()
[function] executePatch() -> apPatch()
2b July 2nd, 2026
Fixes:
Fixed a missing comma
2a July 2nd, 2026
New patches: enableAdditionalCommands, setPowerupID
New commands: ap.powerup, ap.pushPowerup, ap.popPowerup
Fixes:
Fixed strings sometimes not being handled correctly
1a June 30, 2026
Initial Release