Donut Team is a labor of love, built and maintained by a small group of passionate developers. We invest our own time and resources to offer our tools, mods, and web services completely free of charge.

We don't run ads, and we will never sell your data - period.

If you've enjoyed anything we've created, please consider supporting our work with a one-time or monthly donation via our Ko-fi page . Every contribution helps us continue building great experiences for the community.

Dismiss
Donut TeamForumMod BakeryDocs
Search
Default avatar
  • Modding Tools
  • Lucas' Simpsons Hit & Run Mod Launcher
  • Hacks
  • Developer Hacks

Debug Checks

Available since Version 1.17.

This is a developer hack that can be enabled on the "Developer" page of the Mods List.

This hack adds various checks and error messages that help with debugging mods.

Do not enable this hack during casual playthroughs of the base game, it WILL show warning messages at various points where Radical made non-fatal mistakes in their scripts!

Settings

Missing Detection > Locator

Makes the hack show an error message when a locator is not found.

Defaults to Enabled.

Missing Detection > Composite Drawable

Makes the hack show an error message when a composite drawable is not found.

Defaults to Enabled.

Missing Detection > Frame Controller Animation/Hierarchy

Makes the hack show an error message when a frame controller's animation or hierarchy could not be found.

Defaults to Disabled because each of Radical's levels has about two dozen borked frame controllers.

Use Legacy Names

Makes the hack use older, unofficial chunk names.

Defaults to Disabled.

Combine Zone Tree Node Exceeded Messages

Makes the hack combine multiple tree nodes having their limits exceeded into a single message.

Defaults to Enabled.

Command Line Arguments

This hack is affected by certain Command Line Arguments for the Mod Launcher.

Version History

Version 1.27

  • Added a new check that makes this hack detect and show an error when the game has no handler for a particular file type.
    • This is always enabled because the game will crash after this happens.
  • Added a new Missing Detection > Frame Controller Animation/Hierarchy setting. This detects when a frame controller's animation or hierarchy could not be found.
    • This defaults to Disabled because each of Radical's level has about two dozen borked frame controllers and it can be annoying.

Version 1.26

Fixed an issue where Missing Detection > Composite Drawable incorrectly claimed to be "Experimental" even though it has not been considered experimental since before Version 1.23.9.

Version 1.25

  • Added new messages for crashes within MFK and CON scripts.
    • Example 1
    • Example 2
    • You can press OK to continue executing the script from the next command.
      • The game might be in a corrupt state afterwards though.
  • Added a new message for missing tokens in MFK and CON scripts.
    • Example 1
    • Example 2
    • Without this message, Radical silently aborts executing the script when a token is missing.
      • This still happens if you press OK on this message.

Version 1.23.11

Fixed a false positive in the new vehicle sound checks added in the previous version.

This happened when a mission (such as a street race) forced you into your own car (not a forced car), you cancelled the mission and then got out of your car.

Version 1.23.10

  • Added new checks for when certain types of vehicle sounds (engine sounds and overlays) fail to play.
    • For example, clips will fail to play when the daSoundResourceData name they use does not exist.

Version 1.23.9

Removed the Experimental title from the Missing Detection > Composite Drawable setting.

Version 1.23.6

  • Added a null-check of the car to the get position and get move speed functions of vehicle positional sound players with a new assert.
    • In other words, this assert can appear after the game tries and fails to play vehicle sounds.
    • Also added the -novehiclepositionalsoundplayercarnullcheckasserts command line argument to suppress the assert and allow the game to try to continue.

Version 1.23.4

Made the Missing Locator Detection show human readable text for locators that are missing for Additional Script Functionality commands.

Version 1.23.3

Fixed a null pointer dereference when using the MUTE command line argument (enabled by the included No Audio mod) that could cause a crash in some cases (observed on Windows XP).

Version 1.22.4

Locator Missing Detection is no longer referred to as experimental.

Version 1.22.3

Fixed a bug where disabling Combine Zone Tree Node Exceeded Messages didn't do anything.

Version 1.22

  • Added Experimental Missing Detection > Composite Drawable to detect when a composite drawable is missing in cases where that matters.
  • Moved Experimental Missing Locator Detection to the new Experimental Missing Detection group and renamed it accordingly.
  • Made exceeding tree node entity limits get detected immediately instead of the next frame (when the game may have already crashed) and made the limit get increased on the fly instead of corrupting the game.
    • If multiple limits are exceeded during a set of zones being loaded (such as when hitting a load zone or selecting/restarting a mission), a single message is shown by default though this can be disabled by unticking Combine Zone Tree Node Exceeded Messages.

Version 1.18

  • Moved this hack to the new Developer page.
  • Made the hack use Radical's official chunk names.
    • You can revert to the old names by using the new Use Legacy Names setting in the hack's settings.
  • Made Experimental Missing Locator Detection work outside the Release English version of the game.

Version 1.17.2

Changed the name of the Missing Locator Detection setting to Experimental Missing Locator Detection.

Version 1.17.1

Updated this hack to not be enabled by default and not be hidden by default.

Edit on GitHub · Authored by Loren
Log inCreate an account
Discord server