Lucas' Simpsons Hit & Run Mod Launcher Linux Launcher

Lucas' Simpsons Hit & Run Mod Launcher Linux Launcher is a collection of assets for using Lucas' Simpsons Hit & Run Mod Launcher on Linux. It aims to deliver the experience of playing mods for The Simpsons: Hit & Run while integrating with your Linux system as tightly as possible.

Installation

Due to differences between different Linux distributions, no installer is provided in this repo. Instead, it is encouraged to use a package specifically for your distribution. These are the current distributions for which Lucas' Simpsons Hit & Run Mod Launcher Linux Launcher is available:

Don't see your distro listed? Rep your favorite distro by creating a package for it! For more info, please see Recommended Installation Specification.

Usage

To get started with using Lucas' Simpsons Hit & Run Mod Launcher Linux Launcher:

Install the mod launcher from one of the sources above.
Click on the Lucas' Simpsons Hit & Run Mod Launcher application from your desktop's application launcher, or run lucas-simpsons-hit-and-run-mod-launcher.
Allow the script to boot Wine.
- If prompted with a Wine Mono installer, click Install to install the preferred Wine Mono runtime.
- If prompted with a Wine Gecko installer, click Cancel as this is not used by the mod launcher.
Allow the script to setup a .NET runtime.
Setup your Simpsons.exe path in the launcher UI.

This should be all that is required to get up and running. To import your mods, you can move them to ~/Documents/My Games/Lucas' Simpsons Hit & Run Mod Launcher/Mods/, and run check-for-duplicate-lmlms in there to remove any mods that are already installed as a part of the mod launcher package.

Contributing

For information on contributing, please see Contributing.md.

Features

This section is an informal introduction to what this Linux launcher offers. Complete technical documentation is available on the wiki.

Launcher Script

The launcher script is a Bash script that does all of the work with setting up Wine and .NET.

For more info, see the Mod Launcher Launcher page on the wiki.

MIME Types

The LMLM and LMLH file types are foriegn to Linux, so this launcher bundles a MIME type XML to handle any files with these extentions.

For more info, see MIME Types.

Desktop Entries

To allow starting the launchers from your desktop environemnt as if it were any other application, this comes with desktop entries, including support for the MIME types.

For more info, see Desktop Entries.

Duplicate LMLM Checker

As a result of splitting up your mods into a system directory (for default mods) and user directory (for user added mods), you may have some leftover default mods into your user directory. To help keep your user mod directory clean, the duplicate LMLM checker fixes this for you.

For more info, see Duplicate LMLM Checker.

Compatability

This section will detail how well the mod launcher and game run with Wine.

The Simpsons: Hit & Run

The Simpsons: Hit & Run itself pretty much runs exactly how you would expect it to. Performance parallels that of a Windows setup, as does the graphics and sound. The only thing that is sketchy is the game's built in fullscreen functionality. I recommend that you never use the built in fullscreen mode, and instead use the Resizeable Window mod with the mod launcher, combined with your window manager's fullscreen (Often binded to Alt + F11.).

File Loading

When starting up, the main thread of SHAR creates a separate thread for loading files. The main thread intends to yield to the IO thread, and does so using the Sleep function of the Windows API. This function pauses the execution of the current thread, for the amount of time specified by a parameter. A value of 0 for this holds special meaning this. The behavior of Sleep(0) in Windows XP and earlier, which SHAR relies on, is to