Skip to content

Latest commit

 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A setup script for the Steam version of Alice: Madness Returns on Linux and Windows. It restores the bundled American McGee's Alice launcher (disabled in the Steam release), applies community patches to both games, and walks you through common settings.

Two scripts are provided — use whichever fits your platform:

Script Platform
alice-fix.sh Linux (bash)
alice-fix.ps1 Linux (PowerShell 7) / Windows (PowerShell 5.1+, 7)

What it does

Step Action
1 Locates (or downloads) American McGee's Alice within the Madness Returns install
2 Fixes the Alice1Path in DefaultEngine.ini so Madness Returns can find Alice 1
3 Downloads and installs MadnessPatch
4 Downloads and installs VorpalFix
5 Sets the required Steam launch options in localconfig.vdf (Linux only)
6–7 Interactive preferences for both games

Patches applied

MadnessPatch — fixes for Alice: Madness Returns:

  • High-framerate physics and collision fixes
  • Subtitle scaling for high-resolution displays
  • Ultrawide FOV correction
  • DLC unlock, controller improvements, crash prevention, and more

VorpalFix — fixes for American McGee's Alice (2011 remaster):

  • Widescreen HUD, menu, and FMV fixes
  • Raw mouse input, SDL controller support with gyro aiming
  • Anti-aliasing, anisotropic filtering, enhanced LOD
  • Custom FPS limit, custom resolution, and more

Linux

Requirements

  • curl
  • unzip
  • 7z — only required if American McGee's Alice is not already present in the installation

Fedora:

sudo dnf install curl unzip 7zip

Bazzite / SteamOS (Homebrew):

brew install curl unzip p7zip

Debian / Ubuntu:

sudo apt install curl unzip p7zip-full

Arch Linux:

sudo pacman -S curl unzip p7zip

Usage (bash)

One-liner (no download required):

bash <(curl -fsSL https://github.com/jacobjordan94/alice-fix/releases/latest/download/alice-fix.sh)

Or download and run:

chmod +x alice-fix.sh
./alice-fix.sh [--install-path=<path>] [--steam-root=<path>]
Flag Description
--install-path=<path> Path to the Alice: Madness Returns directory. Use when the game is installed on a separate drive or outside the default Steam library.
--steam-root=<path> Path to the Steam root directory. Use when Steam itself is installed in a non-standard location.
--help, -h Print usage and exit.
# Auto-detect Steam installation
./alice-fix.sh

# Game on a separate drive
./alice-fix.sh --install-path="/mnt/games/Alice Madness Returns"

# Custom Steam root
./alice-fix.sh --steam-root="~/GamesDrive/Steam"

Usage (PowerShell)

One-liner (no download required):

irm https://github.com/jacobjordan94/alice-fix/releases/latest/download/alice-fix.ps1 | iex

Or download and run:

chmod +x alice-fix.ps1
./alice-fix.ps1 [-InstallPath <path>] [-SteamRoot <path>]
# Auto-detect Steam installation
pwsh ./alice-fix.ps1

# Game on a separate drive
pwsh ./alice-fix.ps1 -InstallPath "/mnt/games/Alice Madness Returns"

# Custom Steam root
pwsh ./alice-fix.ps1 -SteamRoot "~/GamesDrive/Steam"

Windows

Requirements

  • 7z — only required if American McGee's Alice is not already present in the installation. Download from 7-zip.org.

    After installing, if the script reports that 7z cannot be found, add it to your PATH by running the following in Command Prompt and then reopening your terminal:

    setx path "%path%;C:\Program Files\7-Zip"

    Replace C:\Program Files\7-Zip with your actual install directory if you chose a different location.

Usage

One-liner (no download required):

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process; irm https://github.com/jacobjordan94/alice-fix/releases/latest/download/alice-fix.ps1 | iex

Or download and run:

.\alice-fix.ps1 [-InstallPath <path>] [-SteamRoot <path>]
Flag Description
-InstallPath <path> Path to the Alice: Madness Returns directory. Use when the game is installed on a separate drive or outside the default Steam library.
-SteamRoot <path> Path to the Steam root directory. Use when Steam itself is installed in a non-standard location.
# Auto-detect Steam installation
.\alice-fix.ps1

# Game on a separate drive
.\alice-fix.ps1 -InstallPath "D:\Games\Alice Madness Returns"

# Custom Steam root
.\alice-fix.ps1 -SteamRoot "D:\Steam"

Troubleshooting

Script execution is blocked

Windows may prevent unsigned scripts from running. If you see an error about execution policy, run the following in the same PowerShell window before executing the script:

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

This only applies to the current session and does not change your system's global policy.


What gets configured

The script prompts you to customise the most commonly changed settings in each patch. Press Enter at any prompt to keep the current value.

Alice: Madness Returns (MadnessPatch.ini)

  • Max FPS
  • Skip EA / Spicy Horse / Unreal Engine intro videos
  • Swap A/B and X/Y buttons (Nintendo controllers)
  • Windowed mode
  • Ultrawide FOV correction
  • Controller icons (auto / Xbox / PS3)

American McGee's Alice (VorpalFix.ini)

  • Max FPS (-1 to match monitor refresh rate)
  • Resolution (auto or custom width × height)
  • Show original intro videos
  • Swap A/B and X/Y buttons (Nintendo controllers)
  • Borderless fullscreen
  • Anti-aliasing (MSAA samples)
  • Anisotropic filtering

Additional settings for both patches can be edited directly in their .ini files after the script finishes. The paths are printed at the end of the run.


Credits


Notes

  • Steam is closed automatically on Linux before any files are modified. If it cannot be closed gracefully you will be prompted to close it manually.
  • The script is safe to re-run. If MadnessPatch or VorpalFix are already installed, you will be prompted before they are re-downloaded and applied.
  • The Steam launch option WINEDLLOVERRIDES="winmm.dll=n,b" %command% is set automatically on Linux. This is required for the patches to load under Proton. It is not needed on Windows.
  • American McGee's Alice is launched from the main menu of Alice: Madness Returns once everything is set up.

About

Linux setup script for Alice: Madness Returns (Steam) — installs MadnessPatch & VorpalFix, restores the bundled American McGee's Alice, and configures launch options automatically.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages