KatieLib is a utility mod for YipLoader which provides compatiblity with and continues the legacy of KnShim, a library that can be added to Smash Hit which provides more advanced features for mods. Notably, this includes a custom registry and database as well as cheats which are helpful while developing your mod.
Made by knot126
1. Replace all files in the lib folder with the contents of the KatieLib release zip.
2. Replace lib_name field in AndroidManifest.xml with YipLoader.
The registry provides a way of storing values between scripts, and works very similarly to mgGet and mgSet. Unlike them, it supports custom properties, which provides a lot of flexibility to your mod:
knRegSet("playerName", "mule")
knRegSet("points", 0) -- Note: Numbers will be converted to strings
-- ... later on ...
mgSetText(nameText, "Hello, " .. knRegGet("playerName") .. "!")
mgSetText(pointsText, "You have " .. knRegGet("points") .. " points.")
The database is essentially the same as the registry, except that values are saved between restarts of Smash Hit, making it more useful for storing things like player high scores.
KatieLib makes it easier to add debug cheats to your mod. You can use knSetNoclip to disable losing balls when crashing, and use knSetBalls and knSetStreak to add more balls or force the player's death.
knSetNoclip(true) -- enables noclip
knSetBalls(69) -- set the number of balls the player has
knSetStreak(37) -- set to four-ball multiball and 3 crystals away from five-ball multiball
The full documentation for KatieLib can be accessed here:
Uploaded: July 18, 2026 (Latest)