Lucas' Simpsons Hit & Run Mod Launcher

This book documents all of the features, hacks and included mods that the Mod Launcher comes with.

Introduction

What is the Mod Launcher?

Lucas' Simpsons Hit & Run Mod Launcher is the tool at the heart of the Hit & Run modding scene. It ships with a large array of powerful hacks that mods can leverage to achieve all sorts of things, all without ever modifying a single file in your game install.

Download

This tool is available from the Donut Team downloads page.

Included Hacks

See Included Hacks.

Included Mods

See Included Mods.

Settings

See Mod Launcher Settings.

Command Line Arguments

See Command Line Arguments.

Donut Team Account Integration

See Donut Team Account Integration.

Version History

Version History

Version History

This is a list of every version of the Mod Launcher that has been released on the Donut Team website since the initial release in late 2013.

Version Release Date Download Changelog Trailer
1.22.3 April 11th, 2019 Download Changelog  
1.22.2 March 31st, 2019 Download Changelog  
1.22.1 March 7th, 2019 Download Changelog  
1.22 March 7th, 2019 Download Changelog  
1.21 January 20th, 2019 Download Changelog  
1.20.2 December 31st, 2018 Download Changelog  
1.20.1 December 31st, 2018 Download Changelog  
1.20 December 22nd, 2018 Download Changelog  
1.19 October 2nd, 2018 Download Changelog  
1.18.3 July 12th, 2018 Download Changelog  
1.18.2 July 8th, 2018 Download Changelog  
1.18.1 July 5th, 2018 Download Changelog  
1.18 July 2nd, 2018 Download Changelog Trailer
1.17.2 May 11th, 2018 Download Forum Thread  
1.17.1 April 14th, 2018 Download Forum Thread  

1.17

April 13th, 2018 Download Forum Thread  
1.16.3 December 21st, 2017 Download Forum Thread  
1.16.2 October 29th, 2017* Download    
1.16.1 October 28th, 2017* Download    
1.16 September 15th, 2017* Download    
1.15.3  April 10th, 2017 Download Forum Thread  
1.15.2 February 17th, 2017 Download Forum Thread  
1.15.1 January 24th, 2017 Download Forum Thread  
1.15 September 20th, 2016 Download Forum Thread  
1.14 June 27th, 2016 Download Forum Thread  
1.13.2 June 6th, 2016 Download Forum Thread  
1.13.1 January 7th, 2016 Download Forum Thread  
1.13 January 7th, 2016 Download Forum Thread  
1.12.1 November 7th, 2015 Download Forum Thread  
1.12 October 30th, 2015  Download Forum Thread  
1.11 July 11th, 2015 Download    
1.10.2 May 30th, 2015* Download    
1.10.1 January 18th, 2015* Download    
1.10 January 10th, 2015* Download    
1.9 November 7th, 2014* Download    
1.8.1 March 1st, 2014* Download    
1.8 February 16th, 2014* Download    
1.7 January 19th, 2014* Download    
1.6.3 December 2nd, 2013* Download    
1.6.2 December 2nd, 2013* Download    
1.6.1 December 1st, 2013* Download    
1.6 November 30th, 2013* Download    
1.5.2 November 20th, 2013* Download    
1.5.1 November 19th, 2013* Download    
1.5 November 17th, 2013* Download    
1.4.2 November 7th, 2013* Download    
1.4.1 November 6th, 2013* Download    
1.4 November 6th, 2013* Download    
1.3.1 October 14th, 2013* Download    
1.3 October 14th, 2013* Download    
1.2 October 9th, 2013* Download    

* Release date inferred from the modified date of the archived Launcher executable.

Version History

1.22.3

This update was released on April 11th, 2019.

General

  • Added a "-noasyncwebrequests" command line argument to make it so all web requests are not asynchronous.
  • Fixed a crash on startup when using Wine (and not using "-noappid").
  • Made compiling an encrypted mod not require loading all the data of the mod to memory.
  • Made it so the URL specified for the "-apiurl" command line argument gets changed from "https://" to "http://" when SSL isn't available from the usage of "-nossl" (or "-nocurl" on Windows XP) even if it's specified after it.
    • In previous versions, "-nossl" or "-nocurl" had to be specified first.
  • Made it so certain types of crash (access violation, breakpoint and invalid instruction) show the type in the crash message.
    • Access violations also show if it was attempting to read or write as well as the address attempting to be read or written to.

Account Window

  • Added a "-account" command line argument to launch the Mod Launcher directly into the account window.
  • Made it possible to close the account window while authenticating to cancel the authentication.
  • Made it so your token gets reset after showing the "Your account's token has changed. You will need to re-enter the new one or login using your account details." message.
  • Removed the prompt before showing the account window on first launch and made the account window say "Skip" instead of "Close" when shown on first launch.

Localization

This version introduces one new language string that language packs will need to be updated to include. This is the new "Skip" button that now appears on the Account Window on first launch.

A new template language (Template_1.22.3.xml) was published on this page including this new language string at the end of the file.

Hacks

Fixed an issue with the new virtual filesystem where all files that were on a non-NTFS formatted drive (which is common with removable drives which often use FAT32 or exFAT) would fail to load causing a file not found error.

If you were using "-legacyfilesystem" to work around this issue, you should be able to safely remove it now for improved performance.

Hack: Additional Script Functionality

Made triggers disabled with "DisableTrigger" in two or more subsequent stages stay disabled between the stages.

Hack: Debug Checks

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

Version History

1.22.2

This update was released on March 31st, 2019.

General

  • Added a new web requests system that supports asynchronous requests and using the system proxy (when using libcurl).
    • Also updated user interfaces that use web requests to be asynchronous.
    • Also added a "-noproxy" command line argument to bypass the system proxy.
  • Added support for encrypting mods when compiling them.
    • This is enabled by default for mods that require this version or newer but it can also be opted into manually (which will also implicity make the mod require this version or newer).
    • This only encrypts text based files (.ini, .xml, .lua, .con, .mfk, .cho, .spt) by default.
      • Various new properties were added to the "[Compile]" section of mods to configure what gets encrypted.
    • Also added a "-forceencryption" command line argument so the Mod Launcher will always encrypt mods regardless of their RequiredLauncher or other criteria.
  • Made the Mod Launcher show mod/hack load errors sooner in certain cases.
    • Before compiling mods when using the "-compile" command line argument.
      • This means the Mod Launcher will no longer crash before telling you the load error in the event a mod fails to load while using this command line argument.
    • Before showing the Launcher Settings window when using the "-launchersettings" command line argument.
  • Made the Mod Launcher's unhandled exception message have an "OK" and a "Cancel" button instead of just an "OK" button and made it try to continue when clicking "OK" instead of just terminating the program.

Mod Settings

Fixed an issue where Text mod settings with Options specified had a custom context menu.

Hack: Custom Trigger Actions

  • Added a "Not" property on conditions that makes them return true when they are not met.
  • Made the "BonusMission" property on "Mission" type "[Condition]" sections work as originally documented.
    • This value was documented as being a number from 1 to 5.
    • All previous versions were checking for 21 to 25 instead of 1 to 5.
    • For backwards compatibility reasons, it now checks for either set of numbers.
Version History

1.22.1

This update was released on March 7th, 2019.

General

  • Fixed a crash when failing to read/write a pinned shortcut.
  • Fixed a crash when failing to reload mods when doing a full reload as a result of one or more mods being unable to be individually reloaded when a Meta.ini changed before launching the game or compiling mods.
  • Made it so loading a hack with "-hack" or "-hacks" will make the hack take precedence over the default hacks.

Hack: Hack Support

  • Added a "-noresourcemeta" command line argument. This disables this hack reading information out of the Meta files for Mods and Hacks.
  • Increased the maximum length of property values in INI files from 511 characters to 32767 characters.

Hack: Custom Text

Removed this hack's length limit on strings, instead using the general limit (now 32767).

Version History

1.22

This update was released on March 7th, 2019.

Highlights

New Launcher Features

  • Duplicating and exporting/importing configurations.
  • Jump Lists on Windows 7 or newer.
  • Various internal efficiency improvements.

New Hacks

  • Custom Traffic Support: Adds a ton of traffic related features.
  • Dynamic Tree Node Entity Limits: Makes it much less tedious to modify existing maps.
  • Mirror Mode: Lets you experience the game but mirrored!

New Hack Features

  • Additional Script Functionality: Two new script commands.
  • Bug Fixes: Several new fixes.
  • Custom Trigger Actions: Two new Action Types.
  • Debug Checks: Huge improvements to various existing checks.

General

  • Added support for Jump Lists on Windows 7 or newer.
    • The Jump List contains an item to Launch the game with the last configuration as well as any configurations you've enabled "Jump List" on via the Manage Configurations window. It also has an item for the Launcher's Settings.
    • Also added a "-noupdatejumplist" command line argument to prevent the Mod Launcher from updating the Jump List.
    • Also added a "-nojumplist" command line argument to clear the Jump List on startup.
  • Added a "-noconfiguration" command line argument to make the Mod Launcher start on the Main configuration.
  • Added a "Check for Updates" option to the "Open..." menu when using the "-testing" command line argument.
  • Added a "-nounreleased" command line argument. This fully disables the Unreleased page and makes Unreleased mods appear on the other pages.
  • Added a "-noedition" command line argument. This fully disables the Edition feature of mods.
  • Fixed an issue where the "-nodeleteold" command line argument did not work since 1.21.
  • Fixed an issue where the Mod Launcher was using the wrong number internally when deciding if "Mod compiled successfully." should be pluralised and when deciding how to format the message about a single Mod's Meta.ini having changed when launching the game or compiling a mod.
    • It was incorrectly using the amount of mods that were added with the "-mod" command line argument in both cases which is an irrelevant number.
  • Made it so the Mod Launcher has an App ID.
    • Also added an "-appid" command line argument to use a custom App ID. This also disables updating Jump Lists.
    • Also added a "-gameappid" to make the game use the same ID as the Mod Launcher which makes them share a taskbar button.
    • Also added a "-noappid" to make it so it doesn't have one. This also disables updating Jump Lists.
    • Also added a "-updatejumplist" command line argument to opt back into updating Jump Lists when using "-appid" or "-noappid".
  • Made it so the Mod Launcher goes through pinned shortcuts for the running instance (with the same arguments) on the taskbar and start menu/screen on startup and add its App ID to any that don't have one already.
    • This only applies when the Mod Launcher has an App ID.
    • Also added a "Force Update Pinned Shortcuts" option to the "Open..." menu when using the "-testing" command line argument.
    • Also added a "-forceupdatepinnedshortcuts" command line argument that makes the Mod Launcher always update pinned shortcuts even if they already have an App ID as well as when the running instance does not.
    • Also added a "-nofixpinnedshortcuts" command line argument to disable this.
  • Made it so restarting the Mod Launcher with Ctrl+Shift+R or changing certain settings will retain command line arguments.
  • Made it so the Main mod's icon or the Edition's icon will be used on the game window if one is enabled.
    • Also added a "-nogamemodicon" command line argument to disable this.
  • Made it so Main mods that specify an Edition do not have their title before the game's name in the window title.
  • Made the update checker show a hyperlink on the main window instead of a message box when an update is available.
    • Also added a "-updatemessage" command line argument. This restores the old update message box.
    • Also Added a "-noupdatelink" command line argument. This removes this new update hyperlink.
  • Made the update checker get re-enabled if it was disabled in a previous version due to the fact it's now less obnoxious.
  • Made the "-settings" command line argument include the configuration in the Settings window title when not using "-notitleconfiguration".
  • Made it so the "Hacks" category is available on the "Settings" and "Developer" pages when using the "-testing" command line argument.

Mods List

  • Added a "-watermarkopacity" command line argument. This lets you set the opacity of the watermark in the Mods List, 0 for 0% and 1 for 100%.
  • Made it so being on the Unreleased tab will not save when you close the program, instead placing you back on the General tab or the last tab you were on.
    • Also added the "-saveunreleased" command line argument to disable this.

Mod Information

  • Fixed an issue where author Websites couldn't be clicked on the Credits page.
  • Fixed an issue where authors on the Credits page that were not in any groups appeared bold on Windows 7 and possibly other operating systems but seemingly not Windows 10.
  • Fixed an issue where if you selected multiple mods in the same file (multiple Mod Hacks inside Hacks.dll), the size of that file was counted once for each selected mod.
  • Made it so if you select one or more mods in the same file (multiple Mod Hacks inside Hacks.dll) and no mods not in that file, the name of the file they're in is shown in brackets after the size to make it more clear that it includes the entire file.

Mod Settings

  • Increased the length limit of text setting values from 63 to 127.
  • Made the label of mod settings that have values set appear in bold.
    • Also added a "-noboldsettings" command line argument. This makes it so mod settings are never displayed in bold.
    • Also added a "-ignoredefaultmodsettings" command line argument. This makes it so mod settings that were manually set to their default will no longer be bold despite being set.
  • Added a "-resetdefaultmodsettings" command line argument. This makes mod settings get unset when you manually put them back to their default value instead of remaining bold.
  • Made it so you can right click on individual settings, groups and pages to reset them to their default value(s).
    • You can right click on the control itself and its label unless it's a textbox where you have to right click the label.
    • If you right click a setting that is disabled because of a condition then you will right click the page or group it's in and not the setting.
  • Made the "Reset" button disabled if no settings have a value set.

Launcher Settings

  • Fixed an issue introduced in 1.18 where Increased Video Resolution Support and Custom Shop Support were each listed twice on the Non-mod Hacks page.
  • Made it so using "-ignoremods" prevents a reload when changing Additional Mods settings.

Account Window

  • Added a "-commsoptoutdeauthenticate" command line argument. This makes the "Deauthenticate" button fully remove your account from both the main Mod Launcher and SHAR MP.
  • Changed "login" to "log in" in the window text on the old message that appears when using "-accountwindowtoken" to restore the token field.
    • This doesn't break existing language packs through the power of workarounds though the fact that this message is different as a result of the token field does.
  • Fixed an issue where the window was incorrectly resized to accommodate the "Connection is not secure." text when the font was scaled (via a different DPI or the "-fontscale" command line argument).
  • Fixed an issue where the window could be resized too small when showing the "Connection is not secure." text.
  • Fixed an issue where the window was incorrectly centered on the main window when showing the "Connection is not secure." text.
  • Made this window show the currently authenticated user's display name in brackets after their username in the "Username" field.
  • Removed the Token field.
    • Also added a "-accountwindowtoken" command line argument to restore this field.

Configurations

  • Added the ability to duplicate configurations.
  • Added the ability to export and import configurations.
  • Added the ability to add configurations to the Jump List.
  • Made configurations have the icon of the Main mod enabled in them or the icon of the Edition enabled in them.
    • These are shown in place of the Mod Launcher's icon on the window, on the configurations list and in the Jump List.
  • Made the "Main" configuration listed on the "Manage Configurations..." window. It is not deletable or renamable.

Localization

This version introduces several new language strings that language packs will need to be updated to include. These pertain to the new update hyperlink and the new features of the Manage Configurations window.

A new template language (Template_1.22.xml) was published on this page including this new language strings at the end of the file.

Mod Functionality

  • Added new "Description" sections that allow mods to split up their description into multiple headers on their About page.
  • Added a "Testing" property to "Setting" sections that disables them and any conditions relating to them when not using the "-testing" command line argument.


Learn how to use the new Description section here.

Learn how to use the new Testing property here.

Included Mods

This version adds a couple new included mods:

  • Added Never Busted.
  • Added No License Screen Delay.

Hacks

  • Added various new asserts when using the "-testing" command line argument.
  • Completely re-wrote the underlying file system that powers all of the hacks to be considerably more efficient.
    • Also added a "-nofilesystem" command line argument. This fully disables the Mod Launcher's virtual filesystem making it basically unusable as far as launching the game goes.
    • Also added a "-legacyfilesystem" command line argument. This makes the Mod Launcher use its old virtual filesystem instead of this new one.
  • Fixed a crash when returning to the main menu from demo gameplay (accessible with various hacks such as Debug Test or Skip Main Menu).
    • It will still crash if you exit the game during the demo.
  • Made debug class names used by Debug Text and various other hacks cleaner. For example ".?AVVehicle@@" will now show up as "class Vehicle".

Hack: Additional Script Functionality

General

  • Fixed an issue introduced in 1.21 where there would be an assert when entering the bonus game.
  • Made characters added to cars with ASF commands get removed from and re-added to the world when the car does instead of just when it explodes and is repaired.
    • Characters also now only get added immediately if the car is already in the world.
    • This resolves an issue where characters could remain floating in the air after the game removed a car.
  • Made "g_CustomMissionData.empty()" only assert when using the "-testing" command line argument.


Script Commands

  • Added "AddParkedCar". This allows you to add a car to the level's parked cars list without needing it to be also added to a traffic group with AddTrafficModel.
  • Added "UseTrafficGroup". This sets the current traffic group index when getting to the mission via mission select or restarting it. This does not work unless the DynamicTraffic feature of CustomTrafficSupport is set to "Models" or "Slots".


Learn more about these new script commands here and here.

Hack: Bug Fixes

  • Added "Vehicles > No Air Vent Audio".
    • Also added a "NoAirVentAudio" property to the "[Vehicles]" section of BugFixes.ini.
  • Added "Crashes > Car Deleted While Loading CON File" when using "-testing".
    • Also added a "FixCarDeletedWhileLoadingCONFileCrash" to the "[Crashes]" section of BugFixes.ini since mods are intended to opt into this.
  • Added "Crashes > Zone Load on Exit" when using "-testing".
    • Also added a "FixZoneLoadOnExitCrash" to the "[Crashes]" section of BugFixes.ini since mods are intended to opt into this.


Learn more about these new bug fixes and how to use them in mods here.

Hack: Console

Made the title of the console window "Lucas' Simpsons Hit & Run Mod Launcher Console" instead of the path to the game.

Hack: Cheat Keys

Made F4 (or Shift+F4 if you already have a car like you're always supposed to unless you're playing SHAR MP) show the phone booth.

Hack: Custom Audio Support

Added support for a "Number" attributes on "<Level>" and "<Mission>" elements.

Hack: Custom Car Support

General
Fixed an issue preventing Car Camera Data index remapping from working for cars loaded from a Mod's Resources folder (and possibly other locations).

Command Line Arguments
Added "-nocarindexmapping". This disables the hack re-mapping car indices.

Hack: Custom Files

General

  • Made this hack only handle requesting a file when necessary.
  • Made this hack generate a list of mods that have AdditionalFiles folders on startup and only check those mods when a file is requested instead of every mod.

Lua Functions

  • Added "GetModTitle". This returns the current mod's title (or the title of the specified mod if one is specified).
  • Added "GetModVersion". This returns the current mod's version (or the version of the specified mod if one is specified).

Learn more about these new Lua functions here.

Command Line Arguments

  • Added "-noadditionalfiles". This disables the AdditionalFiles functionality of this hack which will break mods that rely on it.
  • Added "-slowgameload". This allows you to artificially increase load times.

Hack: Custom Limits

  • Added "CarLimit" and "ActionButtonLimit" to the "[Miscellaneous]" section.
  • Added a "[CollisionIndices]" section that lets you increase the limit on various types of collision indices.
  • Added a "[Sound]" section that lets you increase "PlayingClipPlayerLimit" and "PlayingStreamPlayerLimit".
  • Made this hack assert if the "Limit" in the "[Regions]" section was set to more than 127.


Learn more about these newly increasable limits here.

Hack: Custom Road Behaviour

Added support for a "Number" attribute on "<Level>" elements.

Hack: Custom Traffic Support

Added this new hack that allows you to have dynamic traffic groups, more than 5 traffic cars, custom traffic colors and more.

Learn more about this new hack here.

Hack: Custom Trigger Actions

  • Added a "ChangeTrafficGroup" action. This allows you to set the current traffic group with any trigger. This does effectively nothing unless DynamicTraffic is enabled in CustomTrafficSupport.
  • Added a "TriggerMusicEvent" action. This allows you to trigger any music event in the current music RMS file with any trigger.
    • Due to various ways the game handles music, this might not be very practical but it's there!

Learn more about these new action types here.

Hack: Custom Shop Support

Added support for a "SkinShop" element in this hack's configuration file that works similarly to the existing "PhoneBooth" element.

Learn more about this new section here.

Hack: Debug Checks

  • 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".

Hack: Debug Test

General

  • Made it only check if the "H" key is down once each frame instead of once for every possible collision.
  • Made it only check if the "H" key is down when the game window is focused.
  • Made the vehicle controller used when possessing vehicles with the 8 key only get the key states once each frame.
    • Did you know about this feature? We didn't.
  • Made possessing vehicles with the 8 key still use their old controller when not accelerating or steering, not switch them to in-car physics until accelerating or steering and take traffic cars off rails when not accelerating or steering.
    • No seriously, Lucas found out he did this recently. I wonder what other secrets there are...
    • Loren should really document Debug Test sometime.

Graphics Page

  • Added "Software Vertex Processing".
  • Added "Flip > X", "Flip > Y", "Flip > Z" and "Flip > Cull Mode" to flip the viewport in wacky ways.

Vehicles Page

  • Added "Air Vent Force". Now your car can soar like a candy wrapper in an updraft.
    • This suppresses the new "Vehicles > No Air Vent Audio" feature of Bug Fixes if the force is not 0.
  • Added "Override Maximum Traffic".
  • Added "No Load Properties" to disable the game loading CON files.
    • Also added "Set Up Vehicle Handling" and "Create Driver" to make the game do some initialization stuff it would've done if it loaded the CON file.
  • Removed the limit of 5 on "Vehicles > Road Nodes > Maximum Cars".

Miscellaneous Page

  • Added "Gravity" settings. Far out!
    • Screen might go blue if you set some of these numbers the wrong way. No warranty included.
  • Added "Heaps > No Temp Heap".
  • Moved "Use Tracking Heaps" into the new "Heaps" group.

Hack: Debug Text

General

  • Added a "-debugtextmode" command line argument. This can be used to launch the game with a specific debug mode enabled.
  • Added a "-noscaledebugtext" command line argument. This disables the debug text being scaled according to the size of the window.
  • Made the debug text scale down to fit the screen.
    • Also added a "-nofitdebugtext" command line argument to disable this.
  • Made it so pages that are not built in are grouped by what Mod/Hack added them.
    • Grouped pages can be cycled by holding Shift+T/Shift+R.
    • Also added a "-nodebugtextgroups" command line argument to disable this.
  • Made the "traffic" and "road segments" pages show intersections as blue spheres in the world as well as their names.
  • Removed the "root tree node and animated icons" page and moved its contents to the "tree" and "miscellaneous" pages respectively.

"miscellaneous" Page

  • Added "Action buttons" to show the amount of action buttons that exist out of the maximum.
  • Added "Playing sound clip players" and "Playing sound stream players" which show the current amounts out of the maximums.

"cars" Page

  • Added "Parked car count" to show how many parked cars currently exist.
  • Moved the listed traffic cars to the "traffic" page.

"mission" Page

  • Now shows "Time" in stages with a timer. This is shown in milliseconds.
  • Now shows the current time and duration on "timer" objectives in milliseconds.

"traffic" Page

  • Added "Count" to show the amount of traffic cars currently in existence out of the maximum.
  • Added "In-car limit" to show what the in-car limit is currently set to.
  • Added "Group" to show what traffic group is currently in use.
  • Added a list of all models in the current traffic group with the current amount of each one out of their maximum.
  • Added a list of all current traffic cars and whether or not they're active (in the world).

"music" Page
Fixed a crash when viewing this page when the current region had multiple layers in it.

"paths" Page

  • Made this page only show the models of the current ped group and not show an "x" after each count.
  • Made this page show characters and which ones are in use.

Hack: Discord Rich Presence

  • Added "RapidJSON" license.
  • Made this hack output "DISCORD RICH PRESENCE: Initialising..." when initialising Discord RPC.
  • Made this hack wait until the main menu to initialise Discord RPC.
    • This seems to make the hack work far more reliably than before.

Hack: Dynamic Tree Node Entity Limits

Added this new hack. This makes tree node entity limits get adjusted dynamically if any get exceeded which removes the need to manually increase them.

Hack: Frame Limiter

Made the loading screen used when returning to the main menu or going to the Bonus Game menu from the main menu uncapped when "Limit > While on Loading Screens" is disabled but not when "Limit > While on Menus" is disabled.

Hack: Hack Support

  • Added a new "mods" page when Debug Text is enabled. This page lists all mods and mod hacks that are enabled.
  • Added a "-nounrequesthackevents" command line argument. This makes it so hacks do not unrequest hack events they're not using after the first time they're told about them resulting in reduced efficency.
  • Added a "-nohookd3d" command line argument. This disables the Mod Launcher hooking D3D and breaks functionality of numerous hacks. Fun!
  • Added new "hacks", "shared hacks" and "hack events" pages that show up in Debug Text when using the "-testing" command line argument.
  • Made the "-suspend" command line argument show its message earlier.
  • Made the "-testing" command line argument show an assert if the game gets terminated because it took more than 1 second to exit.
  • Made it so this hack only installs shared patches when they are necessary.
    • Also added "-installallsharedhacks". This makes all shared patches get installed regardless of whether or not they're actually in use.
  • Made this hack show an assert if it tries to patch the game, call game code or read/write variables if there is no address for the current game version.
    • In the case of patches, the patch is also not applied. Otherwise, the game will probably crash after the assert.
    • This should never happen, probably.
    • Anyways, you can use "-ignoremissingaddresses" to disable this assert.

Hack: Increased Reward Limits

Added support for an INI file that allows you to increase the limit of Car and Skin previews to custom amounts. Now Multi-Meme can have more cars!

Learn how to use this new configuration here.

Hack: No Time Limits

Added settings to this hack for whether or not it affects Mission Timers and Timer Objectives instead of just affecting Mission Timers always.

Hack: Mirror Mode

Added this new hack that flips the viewport of the world.

Hack: NVIDIA Highlights

Added a new "Air Vent" type of highlight. This is disabled by default because your air vent trick shots are not cool.

Hack: Screenshots

Made it so holding the F12 key will no longer rapidly take screenshots. Also added a "-continuousscreenshots" command line argument to undo this.

Hack: Skip Main Menu

  • Added "Bonus Game" to load directly into the awesome Bonus Game.
    • If you have no bonus game levels unlocked, the bonus game will become fully unlocked until you return to the main menu.
  • Added "Demo" to load directly into the selected Level's demo when using "-testing".
  • Made changing the "Level" away from "1" not set a value for "Mission".
  • Made the newspaper sound attempt to play.
Version History

1.21

This update was released on January 20th, 2019.

Highlights

  • Anti-Aliasing Hack: A new stand-alone hack for anti-aliasing.
  • Configurations: Save and load sets of enabled mods and mod settings to make it easier to switch between them.
  • Mod Search: Easily search the Mods List with Ctrl+F.

General

  • Fixed the .NET 3.5 check added in 1.18 that was broken in 1.19.
  • Fixed a crash when launching the game with a negative value in an integer setting.
  • Made loading resources out of hacks more efficient.
  • Made the launcher delete the Hacks folder next to it if it's empty after deleting old hacks.
  • Made the launcher check that you're running Windows XP or later so it can show a special message if you try running it on Windows 98 or Windows 2000 with .NET 2.0 installed.
  • Made the launcher show a more clear message when trying to load a mod that doesn't exist.
  • Made it so if the text of the tray icon exceeds 63 characters, it gets shortened.
  • Made showing stuff in Explorer still open the containing folder and select the stuff that does exist even if some of it doesn't.

Mods List

  • Added Configurations, manage and switch between them from the right click menu of the Mods List.
    • The title of the currently enabled one will be added to the title of the main window.
    • The Donut Team account used to sign into the Mod Launcher is shared across all configurations.
  • Added Mod Search, accessible via the right click menu of the Mods List and with Ctrl+F or F3 on the main window. It can be closed with the escape key while the text box is focused.
  • Added a "Default" category that shows mods that are enabled by default.
  • Added a Ctrl+P shortcut to toggle pages.
  • Added "Show License" to the right click menu of mod hacks on the main window that have licenses.
  • Changed the way the Mod Launcher detects if a Meta.ini was changed.
    • Previously, it detected this by checking if the modified date was newer than when the mod was loaded.
    • Now, it detects this by checking if the modified date is different than what it was when the mod was loaded.
    • This resolves an issue where extracting files from a ZIP/RAR made in a timezone that's "in the future" would cause the launcher to think the file changed every time it went to check it.
  • Fixed an issue where reloading individual mods caused the Mod Launcher to try and load all the hacks again.
  • Fixed an issue where you could trick the Mod Launcher into reloading frameworks by changing their Meta.ini and compiling them.
  • Fixed an issue where the separator line under "Pages" in the right click menu of the Mods List was hidden on the "Settings" page.
  • Made launching show a prompt to reload mods if their Meta.ini file changed since they were loaded.

Launcher Settings

  • Added "Show License" to the right click menu of mods on the "Non-mod Hacks" tab that have licenses.
  • Made the "Executable Path" text box support dragging a folder or executable onto it to set the game executable/directory.
  • Made the "Additional Mods > Mods Folders" list support dragging folders onto it to add them to the list.
  • Made the "Additional Mods > Mods Folders" list support removing folders with the delete key.
  • Made the "Additional Mods > Individual Mods" list support dragging folders or LMLM files onto it to add them to the list.
  • Updated the Lua license.
  • Updated the libpng license.
  • Updated the zlib license.
  • Renamed the "Discord" license to "Discord RPC".
  • Renamed the "NVIDIA" license to "GeForce Experience SDK".
  • Renamed the "OpenSSL" license to "LibreSSL".

Command Line Arguments

  • Added "-configuration" to launch the Mod Launcher with a specific configuration enabled.
    • This can be used in conjunction with "-launch" to launch directly into a configuration you've set up.
    • This does not change the configuration you have set.
  • Added "-notitleconfiguration" to make it so the current configurations title will not be added to the window title.
  • Added "-disablehack" to prevent a specific hack from being loaded by its name.
  • Added "-font" to allow the use of custom fonts.
  • Added "-fontscale" back which was inexplicably removed in 1.19.
  • Added "-ignorerequiredsystem" which allows hacks that do not support the host operating system to be loaded and enabled.
  • Added "-nocheckmodchanges" to make it so the Mod Launcher doesn't keep track of Meta.ini files changing.
  • Added "-nocloselaunchertickbox" to hide the "Close Launcher" tickbox.
  • Added "-spoofdotnetcheck".
  • Made "-allowignoremodconflicts" allow ignoring required mods.

Learn more about these on the documentation site.

Hacks

Combined all hacks into a single DLL, Hacks.dll, that is now located in the DLLs folder.

Hacks are still individually active (meaning they patch game code and communicate with other hacks) when enabled via the same logic as before (required by mods, enabled in the Mods List, etc).

Hack: Anti-aliasing

Added this new setting hack that allows you to use anti-aliasing if it's supported by your graphics card. If any are supported, it defaults to the highest one but if none are supported, this hack will not show up in the mods list.

You can use "-nomsaa" to have the launcher skip checking what MSAA modes your graphics card supports and disable the hack and hide it from the mods list.

You can also use "-forcemsaa" to have the launcher skip checking what MSAA modes your graphics card supports and force the hack to be in the mods list with all of the possible MSAA modes listed.

Hack: Aspect Ratio Support

Changed the default "FOV > Mode" from "Fit" to "Average".

Hack: Additional Script Functionality

Removed "!m_bStart" asserts (previously on lines 3292 and 3336) related to using the SetPedsEnabled and SetParkedCarsEnabled commands respectively.

Hack: Bug Fixes

Renamed "Fix Late Focus Freeze" to "Late Focus Freeze".

Hack: Custom Main Menu Items

Added this new advanced hack to centralize code related to main menu modifications made by Debug Test, Multiplayer and No Saved Games.

Mods cannot currently configure this hack.

Hack: Custom Trigger Actions

  • Fixed an oversight where this hack was marked as Advanced.
  • Fixed an oversight where this hack was still marked as Unreleased.

Hack: Debug Test

Graphics Page
Removed "Anti-aliasing".

Vehicles Page
Fixed an issue where "Target Player > Traffic" did not work in the Best Sellers Series version of the game.

Miscellaneous Page
Fixed a mistake where "Delta Time" was mislabeled to as "Substeps" (a different concept).

Hack: Debug Text

Added a "gags" Page. This new page lists all the current gags (the outside ones or the ones for the current interior) and whether or not they're loading/loaded. It also shows their joint positions in the world.

Hack: Discord Rich Presence

  • Fixed an issue where the hack was listed on Windows XP.
  • Updated to a newer version of Discord RPC.

Hack: Frame Limiter

Added a new "Method" setting for controlling how the frame limiting is done.

  • Waitable Timer: The original method that's consistent but slightly inaccurate. This is still the default setting.
  • Sleep: A different method that may work better but also may cause stuttering on some computers.
  • Busy Wait: An extremely intensive but effective method.
  • Sleep and Busy Wait: A combination of the previous 2 that sleeps for most of a frame and then busy waits for the rest.

Hack: Free Roam

Added this new hack that disables all missions and unlocks everything.

Hack: Letterbox

Fixed an issue where movies could display incorrectly if the Movies setting in Aspect Ratio Support was disabled or Aspect Ratio Support itself was disabled.

Hack: Modern Computer Support

Fixed an issue where the frame delta time could be 0 if the FPS went over 1000. This could cause things (like the player's position) to become NaN.

This fix can be disabled with the -allowzerodeltatime command line argument.

Hack: No Neither Road Arrow Processing

Added this new hack. 

This fixes an issue where the game tries to process road arrows during a "neither" stage which can cause crashes in certain cases.

You probably shouldn't require this unless that comes up but it probably won't in Radical's maps.

Hack: No Saved Games

Added this new hack that entirely disables the loading and use of saved games.

Version History

1.20.2

This update was released on December 31st, 2018.

General

Updated the Mod Launcher's copyright year to 2019.

Hack: Override Shader Parameters

Fixed an issue where "2SID" was being disabled on certain shaders the game dynamically created causing certain things to appear invisible such as smoke from damaged vehicles and the coin sparkle.

Version History

1.20.1

This update was released on December 31st, 2018.

General

  • Added an "Alpha" property to "Colour" settings in a mod's Meta.ini.
  • Made the Mod Launcher check if your mod's Meta.ini was updated since it was loaded when compiling.

Localization

This version adds 4 new language strings that language packs will need to be updated to include.

	<String>
		<Original>This mod's '<Substitute Index="0" />' has changed since it was loaded. Would you like to reload the mod?</Original>
		<!--<Translation>TODO</Translation>-->
	</String>
	<String>
		<Original>The '<Substitute Index="0" />' of the mod, <Substitute Index="1" />, has changed since it was loaded. Would you like to reload the mod?</Original>
		<!--<Translation>TODO</Translation>-->
	</String>
	<String>
		<Original>The following mods' '<Substitute Index="0" />' files have changed since they were loaded:</Original>
		<!--<Translation>TODO</Translation>-->
	</String>
	<String>
		<Original>Would you like to reload the mods?</Original>
		<!--<Translation>TODO</Translation>-->
	</String>


These strings are used when compiling a mod whose Meta.ini was modified since it was loaded.

A new template language (Template_1.20.1.xml) was published on this page including these new strings at the end of the file.

Hack: Aspect Ratio Support

Fixed an issue where the "Movie Letterbox Colour" setting let you pick an alpha.

Hack: Letterbox

Fixed an issue where the "Colour" setting let you pick an alpha.

Hack: Override Shader Parameters

Added this new hack. This allows you to override any parameter in a shader from an XML file including ones that are normally forced on such as "2SID" (2-sided).

Learn more about this new hack here.

Version History

1.20

This update was released on December 22nd, 2018.

Highlights

  • New Custom Trigger Actions hack for binding custom actions to triggers.
  • New mission commands in ASF for toggling pedestrians and parked cars for missions.
  • Several new setting hacks including a fancy Letterbox hack.

General

  • Fixed an issue where ampersands were incorrectly escaped for the tray icon hover text.
  • Made "Close Launcher" default to being unticked (based on the results of this poll).
  • Made launching the game detect types of conflicts that previously were only detected when ticking mods.

Command Line Arguments

  • Added -nocommandlinefile.
  • Added -nodeleteold.
  • Added -ignorelaunchmodconflicts.
  • Added -nowatermark.
  • Made -allowignoremodconflicts also allow the user to ignore conflicts detected when launching the game.

Learn more about these command line arguments here.

Localization

This version introduces a new language string that language packs will need to be updated to include.

<String>
	<Original>The mod '<Substitute Index="0" />' does not support the mod '<Substitute Index="1" />'. Would you like to disable '<Substitute Index="2" />'?</Original>
	<!--<Translation>TODO</Translation>-->
</String>

This string is used when a conflict is detected upon when launching the game with -allowignoremodconflicts enabled.

A new template language (Template_1.20.xml) was published on this page including this new language string at the end of the file.

Hack: Additional Script Functionality

This update introduces a couple new script commands for missions.

  • Added SetParkedCarsEnabled. This allows you to enable or disable parked cars for a mission.
  • Added SetPedsEnabled. This allows you to enable or disable pedestrians for a mission.

Learn more about these new commands here and here.

Hack: Aspect Ratio Support

Added the "Movie Letterbox Colour" setting.

Hack: Custom Trigger Actions

Added this new hack. This allows you to bind various custom actions to specific triggers or events with optional conditions.

Learn more about it here.

Hack: Debug Test

General

Renamed the "Sky" page to "World Spheres".

Menus Page

Removed "No Camera Animations" in the "Main Menu" section.

World Spheres Page

Added "Activate Dynamic World Spheres" as a setting instead of forcing it when this hack was enabled.

Miscellaneous Page
  • Removed "Allow Cancel Initial Walk".
  • Removed "No Go To Objective Camera Focus".

Hack: Debug Text

General

Added a "world spheres" Page that shows information about any currently loaded World Spheres and their respective Lens Flares (if applicable).

"cars" Page

Added "Parked cars enabled" to show if parked cars are currently enabled.

"paths" Page
  • Added "Enabled" to show if pedestrians are currently enabled.
  • Added "Group" to show the currently selected ped group.
  • Added information about all the ped groups that exist.

Hack: Lens Flare

  • Made Lens Flares not get enqueued if their World Sphere is deactivated.
    • Added -deactivatedworldspherelensflares to suppress this behaviour.
    • This fixes an issue where deactivating a world sphere would not deactivate its lens flare.

Other New Hacks

This version introduces several new Setting hacks.

  • Cancellable Initial Walk
    • Allows you to interrupt the character walking at the start of a level.
  • Letterbox
    • Allows you to force the game into a specific aspect ratio regardless of the game window's dimensions.
    • This may prove helpful for speedrunners who want to maximize their game window or play in full screen while forcing the game into 4:3.
  • No Go To Objective Camera Focus
    • Disables the game taking control of the camera when you step near the target on foot in a "goto" stage.
  • No Main Menu Camera Animations
    • Disables the camera animations on the main menu.
    • This hack is requirable as well if a mod calls for it.
  • No Wrenches
    • Fully disables wrenches.
  • One Tap Player Car Death
    • Makes the player's car get destroyed in one hit.
    • This hack has various options for what types of thing annihilate the player's car.
Version History

1.19

LucasModLauncher_1.19_ReleaseBanner

This update was released on October 2nd, 2018.

Highlights

  • Additional Script Functionality: Vehicle Character Commands
  • Language Localization Support for the Mod Launcher's Interface
    • The Mod Launcher still only comes in English.
  • Lens Flare Hack
  • Video Texture Support Hack

General

  • Added support for Language Localization.
  • Added "Limit to Single Core" to the "Game" tab of the Launcher's settings.
  • Added "dbghelp.dll" to the DLLs folder. This is used to save crash dumps.
  • Made the main window start on the screen the loading window was last on.
  • Made the error message shown when failing to load mods show after the main window.
  • Made the game only start in the correct width and height when starting windowed.
  • Made the loading window appear on the screen the main window was on when reloading.
  • Made the main window re-centre to the screen the loading window was moved to if it was moved to another screen while reloading.
  • Made the Mod Launcher restart if the shift key is held down when reloading all mods.
  • Made the unhandled exception message have an error icon instead of no icon.
  • Made "Size" on the Advanced tab of the Mod information panel available when using -noscanmodfiles for hacks and compiled mods.
  • Removed limitations on how many mods, hacks and mod settings could be injected into the game.
    • You don't want to know.

Command Line Arguments

  • Added -debugloadhacks.
  • Added -debugscreenshots.
  • Added -debugvisibilitytest.
  • Added -loadhackspause.
  • Added -noalpharendertarget.
  • Fixed an issue where the icon of the Mod Settings window when using "-settings" where the default .NET icon instead of the Mod Launcher's Icon.
  • Fixed a crash when using "-launch" with "Start in Correct Resolution" enabled (as is the default).

Hack: Additional Script Functionality

This update brings about the ability to add characters to the player's car or stage vehicles.

You can use this exciting new functionality to have passengers accompany the player in missions and just have characters present in a car.

CON Commands
  • Added the "AddVehicleCharacter" command.
  • Added the "SetVehicleCharacterAnimation" command.
  • Added the "SetVehicleCharacterJumpOut" command.
  • Added the "SetVehicleCharacterScale" command.
  • Added the "SetVehicleCharacterSuppressionCharacter" command.
  • Added the "SetVehicleCharacterVisible" command.

MFK Commands
  • Added the "AddStageVehicleCharacter" command.
  • Added the "RemoveStageVehicleCharacter" command.
  • Added the "SetStageVehicleCharacterAnimation" command.
  • Added the "SetStageVehicleCharacterJumpOut" command.
  • Added the "SetStageVehicleCharacterScale" command.
  • Added the "SetStageVehicleCharacterVisible" command.
  • Added the "SetStageVehicleAllowSeatSlide" command.
  • Updated "SetStageCharacterModel" to default the second argument to the player's current animation set instead of requiring the argument.

Hack: Bug Fixes

  • Added "Actors" > "Restore Wasp Collision".
    • This fixes an issue where destroying a certain number of wasps disables their collision until the level is fully reloaded.
  • Changed the tooltip for "Character Rotations" to be more specific about what it does. The hack's description was also updated to reflect this change.
  • Made "Fix Steering Animations" also fix the steering/swaying animation cancelling immediately/starting again repeatedly.

Hack: Custom Audio Format Support

Added support for Lua Path Handler Redirections on RSD files to FLAC and Ogg files.

Hack: Custom Files

General
  • Made CustomFiles.lua execute after all hacks that are supposed to be loaded are loaded.
  • Made this hack only mount "CustomFiles" folders that exist.
    • This change can dramatically improve performance if you have lots of mods enabled but only a few have CustomFiles folders (like Mod Hacks for instance).
Lua Scripting
  • Added "GetLauncherVersion". This returns the current version of the Mod Launcher.
  • Added "GetMainMod". This returns the InternalName of the current main mod (if there is one).
  • Added "GetSettings". This returns the settings of the current mod (or the specified mod) in a Lua table.
  • Added "IsTesting". This checks if the user is has the Mod Launcher's testing mode enabled.
  • Added "UseCallbacks". This is an advanced function for handling files with Lua that may or may not have a use case.
  • Fixed an issue where "ComparePaths" was always case sensitive and always slash sensitive.

Hack: Debug Text

General
  • Added an "actors" Page.
  • Added a "characters" Page.
  • Added a "loaded characters" Page.
  • Made Ctrl+C copy the current page text to clipboard.
    • Added "Allow Copying with Ctrl+C" to the "Advanced" tab of the hacks settings to disable that.

"cams" Page

Made this page exclude null cameras.

"intersects" Page

Made this page not say "Y: " before the Y and "Z: " before the Z of "Intersect triangle pos 3".

"missions" Page

Made this page exclude null missions.

"mission" Page

Made this page show "null" for null objectives instead of crashing.
This is helpful for debugging in the event the stage's objective is not getting added.

"traffic" Page

Made this page render the segments of the road the car is currently on (and the previous roads segments if the car is on an intersection).

"triggers" Page
  • Made this page include the type number of locators in brackets after the type name.
  • Made sphere triggers render as spheres now instead of boxes.

Hack: Debug Test

General

Removed the F9 dialog to list all entered triggers.

Menus Page

Made "Main Menu" > "No Glow Hide" work in the demo version of the game even though this version skips the Main Menu entirely.

Graphics Page
  • Added "No Texture/Alpha Operations/Arguments".
  • Added "PDDI Windowed".
  • Added "No Force Back-faces".
  • Removed "Lens Flare".
Speedometer Page

Made "Use Miles Per Hour" and "Show Units" work in the demo version of the game.

Vehicles Page
  • Added "Lisa Y Offset".
  • Made "Target Player" work in game versions other than Release English.
Sky Page

Made "Scale" and "Position" work in game versions other than Release English.

Miscellaneous Page
  • Made "Cursor" > "Show Windows Cursor" work in game versions other than Release English.
  • Made "No Splash Screen Loading" work in the demo version.

Hack: Interprocess Communication

Fixed an issue where the Pure3D Editor would hang when selecting locators or right clicking on 3D views in some cases with the following changes:

  • Made this hack still respond if the game is in a blocking modal loop or minimized while in fullscreen mode..
  • Made this hack uninitialise if the game crashes.

Hack: Modern Computer Support

Fixed an issue in the game where the border was not removed when in fullscreen (particularly noticable on Windows 10).

Hack: Lens Flare

Added this new hack. This makes Lens Flares work just like the console releases of the game.

Hack: Resizable Window

  • Fixed issues when switching from a resizable window to fullscreen.
  • Made the game not change its resolution when loading its settings if the window size is changed before then.
  • Made the game maintain its center when changing resolution instead of re-recentering on the screen.
  • Made the game continue processing and rendering when a Windows context menu (like you'd get when right clicking the caption of the window) is open.

Hack: Video Texture Support

Added this new hack.

Version History

1.18.3

This update was released on July 12th, 2018.

Launcher Window

  • Added a sprinkle of unspeakable evil to mitigate the game hanging on exit in certain cases..
  • Fixed an issue where the Mod Launcher update dialog could appear over Mod Settings windows.
  • Fixed an issue where "3DPhoneBoothPreviewSupport.ini" wasn't included when compiling mods.
  • Made the game start at the resolution selected by the user.
    • This behaviour can be disabled with the new "Start in Correct Resolution" setting in the Game tab of the Launcher Settings.

Hack: Debug Test

Graphics Page

Removed "Default Resolution". This is now done automatically as mentioned above.

Hack: Debug Text

General

Made the in-world text of the "triggers", "character joints", "car joints", "dyna phys", "static phys", "road segments" and "car matrix" pages render under the frontend.

"fences" Page

Added this page. This page renders Fence collision in the world.

"intersect" Page
  • Added "Tree node min" and "Tree node max".
  • Added "Tree node parent offset".
  • Changed "Intersect normal" to "Intersect triangle normal".
  • Now renders the current intersect on top of the world.
  • Now shows the memory location of the current Intersect.
  • Now shows the vertex positions of the current Intersect triangle.
"paths" Page

Added this page. This page renders pedestrian Paths on top of the world.

"tree" Page

Now renders the bounding box of the tree node and renders all of the intersects inside it.

Hack: Modern Computer Support

Now outputs the detected OS version to the Console on startup.

Version History

1.18.2

This update was released on July 8th, 2018.

Launcher Window

  • Fixed an issue where the Mod Launcher update dialog could appear while loading mods.
  • Fixed an issue where the Mod Launcher update dialog could appear over the account window.
  • Fixed an issue where cancelling the Launcher Settings dialog would prevent the Mod Launcher update dialog from appearing.

Hack: 3D Phone Booth Preview Support

Made the game assert when loading if Phonebooth.pag in art\frontend\scrooby\ingame.p3d is missing the PreviewWindowRewardFG or RewardBG frontend elements required for the hack to work.

Hack: Bug Fixes

Fixed an issue where "BugFixes.ini" wasn't required and wasn't included when compiling mods that require the hack.

Hack: Custom Interior Support

Fixed a crash on startup that occurred with certain game executables.

Hack: Custom Shop Support

Fixed a crash on startup that occurred with certain game executables in certain circumstances:

  • If the mod used the "Locator" attribute on a "Selector" element inside a "PhoneBooth" element.
  • If the mod used a "Car" element inside a "FreeItems" element inside a "PhoneBooth element.

Hack: Debug Text

"states and actions" Page
  • Added " (no wait)" after actions that their set does not wait for.
  • Added "Walker locomotion action time", "Walker locomotive action next idle animation time" and "Walker locomotive action can play idle animation"
"lights" page

Removed "enabled" for lights and made disabled lights instead show " (disabled)" after them.

Hack: Debug Test

Miscellaneous Page

Added "No First Stage Repeat".

Version History

1.18.1

This update was released on July 5th, 2018.

Launcher Window

Mods List

Made the mods list remember which page it was on when exiting the Launcher and re-opening it.

Hack: 3D Phone Booth Preview Support

  • Fixed an issue when not using "DarkenLockedCars" where all cars in the phone booth would appear dark after closing and opening it.
  • Fixed interference between the lights in the phone booth and the lights in the car shop.

Hack: Additional Script Functionality

New Features
  • Added a new "none" display mode for SetCondDisplay. This mode is usable on all ASF conditions.
  • Added a new "hitandrunlost" condition. This will fail the player if they lose the Hit & Run they have during the stage.
  • Added a new "SetStageVehicleNoDestroyedJumpOut" command. This prevents a driver from jumping out of a car should it explode.
  • Added a new "SetStageAllowMissionCancel" command. This prevents the player from restarting or cancelling the mission on the stage.
  • Made ASF commands that take a boolean as an argument accept "true" or "false" as well as 0 or 1 instead of accepting any integer and treating it as true if it's not 0.
Bug Fixes
  • Fixed an issue where calling SetStageCharacterModel on a stage that calls RESET_TO_HERE that is preceded by another stage that calls SetStageCharacterModel (with the same model and animation set) didn't work.
  • Fixed an issue where pressing enter to continue after restarting from a failed delayed condition in a reset-in-car mission with "Action/Get Out" bound to enter would cause you to exit your vehicle after the mission restarted.
  • Fixed an issue where "hitandrunlost" stages that also call SetStageHitAndRun(100); to trigger a hit and run would automatically complete if you entered the stage without already having a Hit & Run.

Hack: Debug Test

Miscellaneous Page
  • Added "No Go To Objective Camera Focus" .
  • Added "Allow Cancel Initial Walk".

Hack: Debug Text

Added a "lights" page.

Hack: Force Mission Select Level Reload

Moved from the Settings page to the Developer page.

Other Additions & Changes

Made it so hacks in the "Hacks" folder whose versions do not match that of the Launcher get sent to the Recycle Bin instead of showing an error message.

Version History

1.18

This update was released on July 2nd, 2018.

Launcher Window

General
  • Added a "-launchersettings" command line argument that will launch the launcher directly into Launcher Settings.
  • Added an unhandled exception handler so the Launcher will provide helpful information instead of crashing.
  • Added "Game Install Virtual Store" to the "Open..." menu.
  • Changed how the account window is displayed when launching the Mod Launcher for the first time.
  • Changed the order that pressing the tab key cycles through the controls on various windows to be more appropriate.
  • Changed the progress bar when loading mods to no longer ease instead of waiting half a second for it to catch up.
  • Fixed a crash on Wine when selecting mods.
  • Fixed a random crash when communicating with the Donut Team website for Donut Team Account Integration.
  • Fixed an issue where adding an individual LMLM file in Launcher Settings caused it's Title (if there's no Title) and InternalName (if there's no InternalName) to include the LMLM file extension.
    • If you have mods affected by this issue, you will need to remove and re-add them.
  • Fixed the main window not being focused sometimes after loading mods.
  • Improved some error messages to be more specific.
  • Made changing the selected mod(s) smoother.
  • Made "Saved Games" in the "Open..." menu show "Mod Launcher" in brackets if "Always Keep Saved Games Seperate" is enabled.
  • Made "Saved Games" and "Screenshots" options in the "Open..." menu show the current Main mod's name in brackets (if one is enabled).
  • Made mods compiled with no properties in their Miscellaneous section of their Meta.ini able to load.
  • Made scanning mod files only include stuff that would be included when compiling (including custom rules in a mod's Compile section).
  • Made the entire launcher properly support different DPIs.
  • Made the loading window have the Mod Launcher icon in it's caption.
  • Made the mod launcher support reading command line arguments out of the "CommandLine.txt" placed next to it (if one exists).
    • Command line arguments specified in this file should be separated by new lines.
  • When compiling one or more mods, there will now be a window with a cancel button instead of freezing the main window.

Mods List

This part of the launcher sees a significant change in this update.

Introducing Pages! This divides mods and hacks into the "General", "Setting" and "Developer" tabs.

LucasModLauncher_MainWindow_1.18.png

There's also an "Unreleased" tab which only shows up if there are mods in it. You can use this tab to hide a top secret mod from prying eyes by adding this line to your the Miscellaneous section of a mod:

Unreleased=1

If you're not a fan, this can be disabled by right-clicking the mods list and unticking "Pages" to use the old mods list.

There were also these changes to the Mods list:

  • Added a setting to show enabled mods first in the right-click menu of the Mods list.
  • Added an "Enabled Non-favourites" category.
  • Added the ability to reload individual mod(s) by right clicking them.
    • Not supported on Frameworks at this time.
  • Made it so the "Output Path Only" and "Decompilable Only" right-click options are not remembered when restarting the Mod Launcher.
  • Made the mods list update before the mod load error message is shown.
  • Made the watermark work on Windows XP.
  • Made ticking and unticking multiple mods smoother.
Mod Information
  • Made file sizes of mods show 2 decimal places instead of 3 significant figures with the potential of exponents.
  • Made mod information not show a "Miscellaneous" category if no categories are defined.
  • Made mod information show "No information provided." if the mod provides none.
Launcher Settings

Launcher settings got a complete redesign in this version. There were also the following additions and changes:

  • Added "Show Message on Crash" to the Game tab.
  • Added "Donut Team Account Integration Support" to the Launcher tab.
    • If you're opted in, this setting can be used to temporarily opt out without removing your credentials.
    • This fully disables this functionality including the button on the main window.
  • Added "Close to Tray" to the Launcher tab.
  • Added "DPI Aware" to the Launcher tab. This makes the Launcher DPI Aware on Windows 7 or newer.
  • Made "Terminate on Crash" not work if a debugger is attached to the game.
  • Made clicking "OK" on the Launcher Settings window only reload mods if any settings that affect mods were changed.
  • Made it so licenses are listed in alphabetical order.

Mod Configuration (Meta.ini)

  • Added the "LegacyResource" section which allows mods to supersede other mods.
  • Added support for multiple internal names.
  • Added support for "Colour" settings. These aren't very useful for mods at this time.
  • Made the "Default" property on "Text" settings optional instead of crashing if it's missing.

Hack: 3D Phone Booth Preview Support

Added this new hack. This hack adds support for 3D Car Previews in the Phone Booth (similar to those found in Car Shops).

Learn more on the Documentation Website.

Hack: Additional Script Functionality

Added this new hack. This hack adds several new mission objectives, mission conditions, script commands and other new script functionality.

Learn more on the Documentation Website.

Hack: Aspect Ratio Support

  • Added a new FOV mode called "Average".
  • Fixed an issue that caused the aspect ratio to start off corrupt if the Resizable Window hack's "Start Maximised" setting was enabled.

Hack: Bug Fixes

  • Added a fix for a crash related to the options menu and the Unlock All Cameras cheat.
  • Added a fix for the crash that happens if the game is not focused fast enough on the license screen.
  • Moved the Main Menu Cheat Code Enter crash fix to the new Crashes group.

Hack: Custom Audio Support

Added this new hack. This allows you to control some audio related features of the game such as starting ambiance for story missions.

Learn more on the Documentation Website.

Hack: Custom Car Support

Added the "PreviewScale" property. This allows you to set a custom scale for the car when it's in a car shop.

Hack: Custom Car Shop Support

Removed this hack. See the Custom Shop Support section below.

Hack: Custom Files

Added a third argument to the "DirectoryGetEntries" function called "EndToStart" which returns the list of files and folders in reverse order.

Hack: Custom Shop Support

Added this new hack. This hack allows you to specify custom NPCs for car shops and allows you to blacklist or whitelist sars and skins at specific phone booths and skin shops respectively.

Learn more on the Documentation Website.

Hack: Debug Checks

  • 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.

Hack: Debug Test

Menus Page
  • Removed "Force Mission Select Level Reload".
  • Removed "No Cursor Until Mouse Move".

Graphics Page

Added "Default Resolution". This allows you to configure the default resolution of the game window before the game loads your settings.

Debug Page
  • Removed "Ignore Suppressed Drivers".
  • Removed "Starting Coins".
Vehicles Page

Added "No Destroyed Car Jump Out".

Audio Page

Added this page.

  • Added "Force Level RMS". This setting allows you to force a specific level's RMS file to always be loaded/used.
  • Added "No Pause Audio Fade".
Miscellaneous Page
  • Added "Disable Window Ghosting".
  • Added "No Handle File Not Found".
  • Added "Use Camera Position".
  • Added "No Animated Camera Letterbox".
  • Added "Use Tracking Heaps".
  • Removed "No Suppressed Drivers" (yes, there were two of these settings).
Other
  • Made the K Key reload the music RMS file and trigger an event named "Test" if it exists.
  • Made Shift+F10 fail the first condition of the active stage (if the stage has any conditions).

Hack: Debug Text Hack

  • Added settings that allow you to configure the look and feel of the hack and which pages are visible.
  • Added a "car matrix" page.
  • Added a "memory" page with information on a few different heaps.
  • Added a "music" page with various information about the currently loaded RMS files.
  • Added a "road segements" page that draws road segments in the world with names.
  • Fixed a crash when going to the "root tree node and animated icons" page when not ingame.
  • Fixed a crash with the "root tree node and animated icons" page while loading.
  • Fixed lag on the "dyna phys" and "static phys" pages while loading.
  • Made the hack work during movies.
  • Made the hack use Radical's official chunk names.
    • You can revert to the old names by using the new "Use Legacy Names" setting on the Advanced tab of the hack's settings.
  • Made the "car joints" and "character joints" pages show the joints in the world instead of listing them.
  • Made the "regions" page also show the current and loaded interior.
  • Made the "triggers" page list triggers the player is in and show triggers as boxes with names in the world.
  • Made "Animated icons" on the "root tree node and animated icons" page work outside the Release English version of the game.
  • Made "Contact car traffic locomotion AI segment" on the "traffic" page now include the road segment name in brackets.
  • Made the hack check for a font called "DebugText" and use that if it exists.

Hack: FLAC Support

Added this new hack.

This hack adds support for using FLAC files in place of RSD files.

Learn more on the Documentation Website.

Hack: Increased Reward Limits

  • Made it so the game won't get corrupt when trying to add more than 60 car health values to the save file. It now shows an assert message when trying to add more than 60 (except for when the mod is being used in Multiplayer).
  • Removed the assert when trying to add more than 60 reward cars.
  • Removed the limit of 64 reward cars.
    • NOTE: There is still a limit of 64 cars in one phonebooth but you can use CustomShopSupport to spread the cars across multiple phonebooths.

Hack: Increased Video Resolution Support

This hack now removes memory restrictions when playing RMV files.

Hack: Modern Computer Support

Made non-english versions of the game use 200,000hz as the maximum sample rate like the Release English version instead of 100,000hz.

Hack: NVIDIA Highlights

Added this new hack.

This hack adds support for NVIDIA Highlights.

Information on what this feature is can be found here.

Hack: Ogg Vorbis Support

Added this new hack.

This hack adds support for using Ogg files in place of RSD files.

Learn more on the Documentation Website.

Hack: Screenshots

  • Fixed an issue where the default screenshot sound did not work on Windows XP.
  • Fixed this hack failing to take screenshots on Wine or Oracle VM VirtualBox Guest Additions.

Other Additions & Changes

The following hacks were moved to the new Settings page:

  • Aspect Ratio Support
  • Borderless
  • Bug Fixes
  • Discord Rich Presence
  • Flippable Cars
  • Frame Limiter
  • HUD Map Ignore Player Height
  • Interior Jumping
  • Interior Kicking
  • Interior Sprinting
  • Multiple Instance Support (no longer hidden by default)
  • No Automatic Saved Game Load
  • No Cheats (no longer hidden by default)
  • No Fast Car Reset
  • No Inactive Dynamic Object Collisions
  • No Introduction Movies
  • No Jump Limit
  • No Mission Start Cameras
  • No Time Limits
  • Replayable Bonus Missions
  • Resizable Window
  • Screenshots
  • Unlock All Missions


The following mods were moved to the new Settings page:

  • No HUD
  • No Traffic
  • Repair Car On Reset
  • Speedometer
  • Text Names
  • Unlock All Rewards

The following hacks were moved to the new Developer page:

  • Console
  • Debug Checkes
  • Debug Hashes
  • Debug Test (no longer hidden by default)
  • Debug Text

The following new hacks were added to the Settings page:

  • Force Mission Select Level Reload
  • No Cursor Until Mouse Move
  • No Mute on Defocus
  • No Pause on Defocus
  • Skip Main Menu
  • Skippable Start Cameras
  • Starting Coins

Version History (SHAR MP)

Version History (SHAR MP)

MP Version 24

This update was released on April 11th, 2019.

General

Now based on Lucas' Simpsons Hit & Run Mod Launcher 1.22.3.

Version History (SHAR MP)

MP Version 23

This update was released on March 31st, 2019.

General

  • Now based on Lucas' Simpsons Hit & Run Mod Launcher 1.22.2.
  • Made it so loading a hack with "-hack" or "-hacks" will make the hack take precedence over the default hacks (like in Mod Launcher 1.22.1).
  • Made the Account Window show up when launching with no token set (only when "Play Offline" is unticked).
    • Also added "-nolaunchaccountprompt" to suppress this.
  • Made everything on the window disabled and made it unable to be closed while launching the game.
Version History (SHAR MP)

MP Version 22

This update was released on March 7th, 2019.

General

  • Now based on Lucas' Simpsons Hit & Run Mod Launcher 1.22.
  • Fixed a silent crash on exit.
  • Made default mods that conflict with enabled mods get ignored.
  • Made 3D Phone Booth Previews, No License Screen Delay and No HUD allowed by default.

Settings Window

  • Added a Mirror Mode "mutator" to enable the new Mirror Mode hack.
  • Added a No Cheats "mutator" to enable the No Cheats hack and disables all other cheat hacks.
  • Made the Settings window only close after the game has been successfully launched.
  • Made this window use the icon of the current configuration (if one other than main is set and you're not using "-notitleconfiguration").
  • Replaced the "Token" field with an "Account..." button.
    • Also added a "-nomultiplayeraccountbutton" command line argument to revert this.

Command Line Arguments

  • Now supports many of the main Mod Launcher's command line arguments.
  • Added support for "CommandLine.txt".
  • Added "-multiplayersupersprint". This allows you to go into the Bonus Game but doesn't do anything to make that support SHAR MP.
  • Added "-noignoreenabledmods".
  • Added "-ignoredefaultallowedmods".
  • Added "-ignoredefaultenabledmods".
  • Added "-noignoreconflictingdefaultmods".
  • Added "-ignoredefaultmod".
  • Added "-modlaunchermods".

Limits

  • Changed the Billboard Quad Limit from 600 to 1300.
  • Set the Car Limit to 64.
  • Set the Action Button Limit to 184.
  • Set the Vehicle Collision Indices Limit to 64.
  • Set the Character Collision Indices Limit to 64.
  • Set the Dyna Phys Collision Indices Limit to 115.
Version History (SHAR MP)

MP Version 21

This update was released on January 20th, 2019.

General

Now based on Lucas' Simpsons: Hit & Run Mod Launcher 1.21.

Hack: Debug Test

Menus Page
Fixed a major security exploit where "Main Menu > Loren Mode" was not respected in Multiplayer and as such allowed you to experience the wonders of SHAR MP with it enabled. We apologise for the inconvenience.

Version History (SHAR MP)

MP Version 20

This update was released on December 31st, 2018.

General

Now based on Lucas' Simpsons Hit & Run Mod Launcher 1.20.2.

Version History (SHAR MP)

MP Version 19

This update was released on December 31st, 2018.

General

Now based on Lucas' Simpsons Hit & Run Mod Launcher 1.20.1.

Version History (SHAR MP)

MP Version 18

This update was released on December 25th, 2018.

General

  • Made the launcher show a message when it detects a mod conflict, allowing you to ignore the conflict and continue anyways.
  • Made the launcher able to detect conflicts with uncompiled mods.
  • Fixed an issue where Multiplayer Resources conflicted with mods that modified the same files (such as "art\frontend\ingame.p3d").
    • This addresses an issue introduced in SHAR MP 17 where changes to how and when conflicts are detected caused mods to conflict with Multiplayer Resources.
Version History (SHAR MP)

MP Version 17

This update was released on December 22nd, 2018.

General

Now based on Lucas' Simpsons Hit & Run Mod Launcher 1.20.

Version History (SHAR MP)

MP Version 16

General

Fixed an issue introduced in MP Version 15 where custom characters didn't work.

Version History (SHAR MP)

MP Version 15

General

Now based on Lucas' Simpsons Hit & Run Mod Launcher 1.19.

Version History (SHAR MP)

MP Version 14

General

Now based on Lucas' Simpsons Hit & Run Mod Launcher 1.18.2.

Version History (SHAR MP)

MP Version 13

General

Now based on Lucas' Simpsons Hit & Run Mod Launcher 1.18.1.

Version History (SHAR MP)

MP Version 12

General

  • Now based on Lucas' Simpsons Hit & Run Mod Launcher 1.18.
  • Changed it so the R key no longer deletes the mission icon on the HUD map. This also means the R key used to cycle debug pages in Debug Text is now re-enabled.
  • Improved synchronization of car rotations.
  • Improved synchronization of entering and exiting vehicles.
  • Now includes "npd.cho" and "npd_a.p3d" from Multiplayer Cars and Characters so every character has proper animations.

Settings

  • Added "Low Bandwidth" to the Server tab. This makes the client communicate with the server using the old tick-rate of 10.
  • Added "Play Offline" to the Server tab. This makes it so you can play by yourself without being connected to the server.
    • This is useful for testing secret stuff and multiplayer checks in your mod without having to use the actual server to do so.

Debug Pages for Debug Text

RakNet Page
  • Added "Actual bytes per second" which shows the combined total of "Actual bytes per second sent" and "Actual bytes per second received".
  • Added "Total bytes" which shows the combined total "Total bytes sent" and "Total bytes received".
  • Changed it so totals update continuously instead of every second.
  • Changed the formatting of bytes. They now shows in KB, MB, etc.
"resync" Page

Added this page.

Version History (SHAR MP)

MP Version 11

Currently, this changelog is available on this forum thread.

Mod Launcher Setup

1: Downloading the Mod Launcher

The first step is to download the Mod Launcher. You can do this by heading over to the Tool Downloads page and then clicking the download button.

Downloads Page

2: Extracting the Mod Launcher

Next, you want to extract the ZIP archive of the Mod Launcher you just downloaded.

Using Windows

To extract the archive using the built in Windows utility, simply Right Click > Extract All... to open the Extract Compressed (Zipped) Folders dialog.

From there, choose where you want to extract the Mod Launcher and then click Extract.

Using 7-Zip

To extract the archive using 7-Zip, simply Right Click > 7-Zip > Extract files....

From there, choose where you want to extract the Mod Launcher and then click OK.

3: Mod Launcher Folder

Now we should have a folder containing a few things:

  • A folder named DLLs: This folder contains DLLs used by the Mod Launcher. Unless explicitly instructed to do so by Donut Team, you should avoid making changes to the contents of this folder.
  • A folder named Hacks: This folder contains all of the hacks used by the Mod Launcher and mods created for it. Unless explicitly instructed to do so by Donut Team, you should avoid making changes to the contents of this folder.
  • A folder named Mods: This is one of several places where you can install mods for the Mod Launcher. There are a few mods included in this folder but you're free to remove them if you'd like.
  • Lucas Simpsons Hit & Run Mod Launcher.exe: This is, of course, the actual launcher itself.

4: Donut Team Account Integration

Let's go ahead and start up the Mod Launcher.

Upon first startup, you will be prompted for whether or not you'd like to allow the Mod Launcher to communicate with the Donut Team website. For more information about this feature, see Donut Team Account Integration.

Donut Team Account Integration Prompt

If you choose to opt-in to this feature, you'll need to link your Donut Team account by signing in with your account details or by using your Donut Team Token.

Account Dialog

5: Browsing for your Game Install

After the account prompts, you'll be greeted with the Main Window of the Mod Launcher which should look like this:

LucasModLauncher_MainWindow_1.18_NoMods.png

The first thing you'll want to do is click Open... in the bottom left corner and select Launcher Settings.... From there, move over to the Game tab.

Here you'll want to click the Browse... button next to Game EXE Path and browse for the Simpsons.exe in your install folder for the game.

LucasModLauncher_Settings_1_18_Game_Browse.png

6: Launching the Game

Now that you've told the Mod Launcher where your install of the game is, you can launch the game via the Launch button on the bottom right of the window. If you'd like the Mod Launcher to stay open in the background while you're playing, then untick the Close Launcher checkbox next to the Launch button.

Note that by default the following hacks are enabled in the Mods list with the following settings:

  • Aspect Ratio Support: Enables Automatic Aspect Ratio on the world and the HUD with an FOV of 78.
  • Bug Fixes: All user facing bug fixes are enabled.
  • Frame Limiter: The Target Frame Rate is set to 60 (except for on Loading Screens) and it is strongly recommended that you do not change this as the game's physics behave best at this frame rate.
  • Resizable Window: Presenting, processing and rendering while resizing are enabled.
  • Screenshots: Flash Screen and Play Sound are enabled.

The following hacks are always enabled when using the Mod Launcher.

  • Modern Computer Support: Makes the game work properly on Windows Vista or newer.
  • Modern Resolution Support: Makes the game support any resolution your graphics card supports instead of 6 hardcoded resolutions.

And you're done. Now you're playing with power.

Installing Mods

While you could simply enjoy the game as is, you can also install additional mods made by Donut Team or the community to enhance the game further.

Mods come in two forms, as a folder and as Lucas Mod Launcher Mod file (.lmlm). The install process for both is the same.

Where do I download mods?

What is the install process for mods?

Where can I put mods I download?

You can also put any downloaded mods in several different locations:

For this tutorial, we'll be placing it in the Documents location using the Mod Launcher's built-in link.

The mod I downloaded is a .ZIP, .RAR, .7z file. What do I do?

That's a compressed file. You will need to extract the content before we give the file to the Mod Launcher.

If it is a ZIP file, you can simply right-click and click "Extract All..."

Otherwise, you can download 7-Zip (https://www.7-zip.org/) and install it.

Once it is installed, right-click on the file and hover over "7-Zip" and then click "Extract to" to get the files inside.

Where does Donut Team recommend I put my mods?

Using the Documents location is the preferred way, as it is the easiest location to get to and manage. You can get to it by opening Lucas' Simpsons Hit & Run Mod Launcher.

Secondly, click on the "Open..." button in the bottom left-hand corner.

InstallingMods1.png

Under the Open menu, you should see a button that says "Mods" - Click that button to open your Mods folder in Windows Explorer.

You'll want to place any Mod Folder (any folder that contains a "Meta.ini" file) or any LMLM file in the folder that opens in Windows Explorer. You can view the screenshot below to see an example of how it may look.