Lucas' Simpsons Hit & Run Mod Launcher

This book contains information about Lucas' Simpsons Hit & Run Mod Launcher.

Introduction

What is the Mod Launcher?

Lucas' Simpsons Hit & Run Mod Launcher is main tool used to create and run mods for The Simpsons: Hit & Run though it can also be used to simply run the original game with quality-of-life improvements.

It has been actively maintained since 2013 and has gained a wide array of features in that time including but not limited to:

  • Bug fixes that resolve issues with the base game and improve the game experience.
  • Support for user created mods that can be enabled alongside one another (as long as they do not conflict).
    • Mods can provide custom files that override those in the game's folder without permanently modifying any of them.
    • Mods can register fully custom characters, vehicles and more.
  • Support for various features expected from modern games.
    • Anti-aliasing (MSAA).
    • Borderless windowed mode.
    • Discord Rich Presence.
    • Proper support for any aspect ratio and resolution.

Nearly every feature of the Mod Launcher is optional and can be toggled at your discretion via the Mods list.

Download & Setup

To learn how to download the Mod Launcher and set it up, check out the Initial Setup guide.

Included Hacks & Mods

To learn about what hacks and mods are included with the Mod Launcher, check out the Included Hacks and Included Mods pages.

Other Pages

Here are some other pages that may be of interest:

 

Initial Setup

This is a guide on how to download and setup the Mod Launcher.

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.

ModLauncherSetup1

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 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: First Time Setup

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

Upon first startup, you will be prompted to sign into your Donut Team account to enable Donut Team Account Integration.

2.png

This is optional and you may simply press "Skip" if you do not wish to do so.

5: Launching the Game

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

3.png

From here, you can simply click the "Launch" button on the bottom right to launch the game.

The first time you do this, you will be prompted to browse for your install of the game. By default, the game is installed to C:\Program Files\Vivendi Universal Games\The Simpsons Hit & Run on 32-bit systems or C:\Program Files (x86)\Vivendi Universal Games\The Simpsons Hit & Run on 64-bit systems.

Once you navigate to your install, select "Simpsons.exe" and click "Open".

4.png

Once you've done that, the game will launch and you are done setting up the Mod Launcher!

Extra: Configuring the Mod Launcher

Now that you have the Mod Launcher setup, you might be interested in learning more about the various settings it has. You can read all about them here.

Extra: Installing Mods

Now that you have the Mod Launcher setup, you might be interested in downloading and installing additional mods. You can read a tutorial on how to do that here.

Extra: Localising the Mod Launcher

If you would prefer the Mod Launcher be in a language other than English, you can check out this page which contains a list of available language packs and how to install them. It also explains how to create your own if you'd like to contribute one.

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.

In the example shown, there are 3 LMLM files and one mod folder.

Make sure to press the "Reload" button (or Control+R) in the Mod Launcher to show all the content you just added.

Language Localisation

The Mod Launcher only ships with English language localisation. However, it supports additional languages via community made language XML files.

Downloading Languages

This is a list of currently available languages and where to obtain them.

Additional languages can be installed simply by placing the XML file into a "Languages" folder next to the Mod Launcher's executable.

Language Author Version Last Updated Download
English Donut Team 1.23 Built-in Built-in
Russian / русский Gordon CMB 1.22.4 January 21st, 2019 Download / скачать

Once installed, the Mod Launcher will prompt you to choose a Language the next time you start it. The setting can be changed again later by going "Open > Launcher Settings..." and going to the "Launcher" tab.

Creating Languages

You can start creating your own language localization for the Mod Launcher by downloading the newest template XML file from the sidebar of this page (currently Template_1.23.xml), placing it in a "Languages" folder next to the Mod Launcher's executable and un-commenting and editing the Translation elements inside it.

Any language strings not included in your XML file will fall back to their English defaults. Certain strings also have other fallbacks for backwards compatibility with older versions of the Mod Launcher.

 

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.23 May 16th, 2019 Download Changelog  
1.22.4 April 25th, 2019 Download Changelog  
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.23

This update was released on May 16th, 2019.

General

  • Added the "-nodtcomms" command line argument. This disables Donut Team Account Integration.
  • Added the "-uppercasetext" and "-lowercasetext" command line arguments. These make all the localisable text in the Mod Launcher and messages it shows upper or lower case respectively.
  • Made it so file/folder browse dialogues fall back to Windows XP style versions in the event the Mod Launcher or .NET fail to create Windows Vista style dialogues.
    • This resolves an issue where this happened on Windows 10 1809 when using a High Contrast theme.
    • This was also able to happen on Windows 7 with "Disable visual themes" ticked in the executable's compatibility settings.

Mods List

  • Added a "Non-enabled Favourites" category.
  • Added a "Descriptionless Hacks" category when using the "-testing" command line argument.
  • Added the existing shortcut keys to the right click menu items for "Search...", "Pages" and "Reload".

Launcher Settings

Fixed an issue where "Copy Require Line" was disabled in the right click menu of "Hack Support" on the "Non-mod Hacks" page (which is only visible with "Show Advanced Hacks" ticked).

Localisation

There are some fixes and improvements to localisation in this version as well as new strings.

  • Fixed an issue where the "Jump List" tickbox on the "Manage Configurations..." window did not correctly handle being repositioned/resized with language localisation.
  • Made non-ingame messages from the Custom Files, Custom Save Data, Debug Test and Screenshots hacks support language localisation.

A new template language (Template_1.23.xml) was published on this page including all the new strings.

Hacks

Added descriptions to the following hacks:

  • Anti-aliasing
  • Cancellable Initial Walk
  • Dynamic Tree Node Entity Limits
  • Force Mission Select Level Reload
  • Lens Flare
  • Letterbox
  • Mirror Mode
  • No Cursor Until Mouse Move
  • No Go To Objective Camera Focus
  • No Mute on Defocus
  • No Pause on Defocus
  • No Suppressed Drivers
  • One Tap Player Car Death
  • Skip Main Menu
  • Skippable Start Cameras
  • Starting Coins


Updated the descriptions of the following hacks:

  • Discord Rich Presence
  • Frame Limiter
  • HUD Map Ignore Player Height
  • NVIDIA Highlights
  • No Cheats
  • No Fast Car Reset
  • No Introduction Movies
  • No Jump Limit
  • No Mission Start Cameras
  • Replayable Bonus Missions


Made it so the following hacks can no longer be required by mods:

  • Ambient Car Support
  • Aspect Ratio Support
  • Custom Audio Format Support
  • Custom Main Menu Items
  • Custom Save Data
  • Interprocess Communication
  • Lua Support
  • Road Names


Attempting to require these hacks in a mod that doesn't have a RequiredLauncher specified or has a RequiredLauncher with a version lower than 1.23 will be ignored for backwards compatibility reasons.

Hack: Hack Support

  • Added the "-hookd3d" command line argument.
  • Added the "-nohandlefilenotfound" command line argument.
  • Added the "-nohardwareskinning" and "-hardwareskinning" command line arguments.
  • Added the "-noreloadcarcameradata" command line argument.
  • Fixed an issue where the Direct3D hook in this hack caused the game to reset the Direct3D device redundantly once at startup.
  • Made this hack block the game from resetting the Direct3D device when it's not nessecary.
    • Also added the "-noblockredundantreset" command line argument to opt out of this.
  • Made the game terminate abruptly with no message or crash dump in the case that an exception occurs in the hack window procedure event (instead of letting Windows swallow the exception and likely cause corruption).

Hack: Custom Controller Support

Added this new advanced hack that other hacks can use to extend the game's controller support.

Hack: Direct3D 9

Added this new hack that makes the game use Direct3D 9 instead of Direct3D 8.

This may be helpful when trying to use 3rd party tools such as ReShade.

Hack: Lens Flare

  • Made this hack work differently (using an occlusion query instead of a lockable render target) when using Direct3D 9.
    • Also added a "-noocclusion" command line argument to opt out of this.
    • Also added a "-occlusionsleep" command line argument.

Hack: No Cursor Until Mouse Move

Made this hack only show the cursor if it moves more than 5 pixels on either axis. This tolerance is customisable in the hack's settings (0 meaning any movement and -1 meaning the old behaviour where it will show up any time the window receives a mouse move event even if the cursor's position doesn't change).

Hack: Resizable Window

  • Added the "-nomaintainwindowcentre" command line argument. This prevents this hack from trying to maintain the centre point of the game window when the game resizes it.
  • Made the game terminate abruptly with no message or crash dump in the case that an exception occurs in the resizing timer callback (instead of letting Windows swallow the exception and likely cause corruption).
  • Made this hack check if the game window is currently maximised instead of checking if the "Start Maximised" setting is ticked before suppressing the changing of the resolution when the game loads its settings.
  • Made this hack update the game's unmaximised size and position if the game is maximised when it loads its settings.
  • Made this hack force the game window to fit within the working area of the screen it's on when maintaining the window centre when the game resizes its window.
  • Made this hack prevent you from resizing the client area of the game below 1 pixel on the width or height.
    • Also added a "-allowzerowindowsize" to opt out of this.
  • No longer resizes or repositions the window if the resolution changes when the game is in full screen.
    • This became an issue with Hack Support blocking the game from resetting its Direct3D device redundantly in this version.
  • No longer maintains the centre of the window when changing out of full screen.
  • No longer handles resizing when the game is in full screen.

Hack: Screenshots

Improved error handling.

Hack: XInput

Added this new hack that makes the game use XInput instead of DirectInput for controllers/gamepads.

This has various advantages over DirectInput:

  • Makes controller rumble work.
    • This can be disabled in the hack's settings.
  • Makes the game compatible with Steam's controller support when launching the Mod Launcher through Steam as a non-Steam game.
  • Makes it so you can plug in new controllers while the game is running.

Currently, DirectInput only controllers will not work with this hack enabled and only one trigger can be used at a time. You can bind actions to both but they cannot be pressed at the same time.

Version History

1.22.4

This update was released on April 25th, 2019.

General

  • Added the "-nocheckforupdates" command line argument. This prevents the Mod Launcher from checking for updates regardless of your setting.
  • Added the "-language" command line argument. This allows you to override the language of the game.
    • This doesn't work in the original English release of the game.
    • This still requires you to provide the dialog RCF file for the language you're overriding to.
  • Added the "-proxy" command line argument.
  • Added the "-updatecheckurl" command line argument.
  • Fixed a bug introduced in 1.13 where the Mod Launcher required Service Pack 1 of .NET 3.5 due to using functionality added in it.
  • Fixed a crash in the Mod Launcher that occured when launching the game when there's no resolutions listed in the resolutions combo box and the windowed check box is checked but disabled.
  • Made it so lucasstuff.com is considered a Donut Team domain.
  • Made the Mod Launcher show a message after starting if Hack Support isn't loaded that tells you to make sure you extracted the ZIP file.
    • Also added the "-nohacksupportcheck" to disable this.
  • Made the game show an explanatory error message if there's no audio output device (or the Windows audio service isn't running) instead of crashing.
    • Also added the "-noaudiodevicecheck" command line argument to disable this.
  • Made it so "-allowignoremodconflicts" allows you to skip the error message the Mod Launcher shows when you're using the minimum install of the game.

Launcher Settings

  • Made it so the file name of the game executable is selected by default on the Game tab.
  • Made it so this window will get wider if needed to accomodate larger buttons/text from language localisation.

Localisation

  • Made it so the Mod Launcher will show a language selection dialogue on first launch if there's any additional languages or on subsequent launches if the languages have changed.
    • Also added the "-noselectlanguage" command line argument. This disables this dialogue.
    • Also added the "-selectlanguage" command line argument. This forces this dialogue to show up.
  • Made localisation extend to various messages from Hack Support.
    • Also added the "-nohacklanguagelocalisation" command line argument to opt out of this.
  • Made certain proper nouns like the title of the Mod Launcher or "Donut Team" get substituted in various strings.
    • There is full backwards compatibility with the old formats of these strings so old language packs still work.

A new template language (Template_1.22.4.xml) was published on this page including these new string formats as well as the original strings. The template also now indicates when strings were removed if they were in this update or any previous ones.

Hack: Hack Support

Added the "-breakgame" command line argument. This break points the game as soon as possible after Hack Support is loaded.

Hack: Additional Script Functionality

Fixed an assert when starting a mission that has an "insidetrigger" or "outsidetrigger" objective or condition on its first stage.

Hack: Debug Checks

Locator Missing Detection is no longer referred to as experimental.

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