# The Complete Guide to Medal of Honor: Allied Assault in 2025

**Relive the classic World War II shooter with modern compatibility and multiplayer support!**

Thanks to the [**OpenMohaa project**](https://github.com/openmoh/openmohaa), you can now experience this classic with modern compatibility, enhanced performance, and active multiplayer servers.

This comprehensive guide will walk you through everything you need to:

- ✅ Install and run MOHAA on modern systems (Windows, Mac, Linux)
- ✅ Set up multiplayer gaming with friends
- ✅ Host your own dedicated server
- ✅ Add custom maps and modifications

---

## What You'll Need

- Original MOHAA game files (legally purchased from GOG)
- 30 minutes for setup
- Basic terminal/command line familiarity (we'll guide you through it!)

For detailed technical documentation, check these folders:

- [Local installation details](./local/README.md)
- [Server administration](./server/README.md)
- [Custom maps collection](./maps/README.md)

## 📥 Part 1: Getting the Game Files

### Step 1: Purchase & Download from GOG

- Create an account on GoG and buy the original game [Medal of Honor: Allied Assault War Chest](https://www.gog.com/en/game/medal_of_honor_allied_assault_war_chest)
- Go to your account => Games => Medal of Honor: Allied Assault War Chest => At the bottom of the page you can find a section named `Download offline backup game installers`
  - You should be able to view them from this link once you login: [https://www.gog.com/en/account](https://www.gog.com/en/account)
- Download the game's 3 files (`setup_medal_of_honor_2.0.0.21.exe`, `setup_medal_of_honor_2.0.0.21-1.bin`, `setup_medal_of_honor_2.0.0.21-2.bin`)

### Step 2: Install Original MOHAA

**Windows users:**

- Run the .exe file to extract the game files

**Mac & Linux users:**

- Install innoextract using `brew install innoextract` or other package managers for extracting the game files from the .exe file
- Run `innoextract setup_medal_of_honor_2.0.0.21.exe` to extract the game files
- This will create `app` & `tmp` directories. Feel free to delete the `tmp` directory after extraction
- The `app` folder is the game directory. You can rename it to `mohaa` or any name you prefer

## 🚀 Part 2: Installing OpenMohaa

### Step 3: Download OpenMohaa Release

Navigate to the releases page of OpenMohaa on [GitHub](https://github.com/openmoh/openmohaa/releases).
Find the latest release (as of Aug 2025, it's [v0.82.1](https://github.com/openmoh/openmohaa/releases/tag/v0.82.1)).
Scroll to the Assets section at the bottom and pick the appropriate version for your system architecture.

Most probably you will need one of the following:

- [Windows x64](https://github.com/openmoh/openmohaa/releases/download/v0.82.1/openmohaa-v0.82.1-windows-x64.zip)
- [Mac](https://github.com/openmoh/openmohaa/releases/download/v0.82.1/openmohaa-v0.82.1-macos-multiarch.arm64-x86_64.zip)
- [Windows ARM (Parallels)](https://github.com/openmoh/openmohaa/releases/download/v0.82.1/openmohaa-v0.82.1-windows-arm64.zip)
- [Linux x64](https://github.com/openmoh/openmohaa/releases/download/v0.82.1/openmohaa-v0.82.1-linux-amd64.zip)

Download the zip file and extract the files directly into the game directory (the one you created in the previous step).

### Step 4: Prepare Files for Execution

**Windows users:** Nothing is needed in this step.

**Mac & Linux users:**

- Open the terminal and navigate to the game directory
- Run the following commands to allow the OpenMohaa files to run:

  ```bash
  isMac() { [ "$(uname -s)" = "Darwin" ]; }

  if isMac; then
    # Remove quarantine attribute if it exists
    # xattr -rd com.apple.quarantine ./
    if xattr -p com.apple.quarantine launch_openmohaa_* omohaaded openmohaa >/dev/null 2>&1; then
      xattr -rd com.apple.quarantine launch_openmohaa_* omohaaded openmohaa
    fi
    # Make the files executable
    chmod +x launch_openmohaa_* omohaaded openmohaa
  fi
  ```

## 🎮 Part 3: Playing the Game

### Step 5: Launch MOHAA

Now you can launch any of the following:

- `launch_openmohaa_base` for the base game
- `launch_openmohaa_spearhead` for the Spearhead expansion
- `launch_openmohaa_breakthrough` for the Breakthrough expansion
- `omohaaded` for the dedicated server (more on this in the server section)

**Basic launch:**

```bash
./launch_openmohaa_base
```

**Custom resolution example:**

```bash
./launch_openmohaa_base +set r_mode -1 +set r_customwidth 1920 +set r_customheight 1080
```

## ⚙️ Part 4: Configuration & Customization

### Step 6: Locate Configuration Files

The OpenMohaa local configuration folder is located in the following directories:

- Windows: `C:\Users\<YourUser>\AppData\Local\openmohaa` (or `%APPDATA%\openmohaa`)
- Mac: `~/Library/Application\ Support/openmohaa`
- Linux: `~/.openmohaa`

For now, we will customize the `omconfig.cfg` file to set some options, which is located in OpenMohaa's `main/configs` directory.

_Launch the game and then exit it to generate the `omconfig.cfg` file, or copy the file from the repo to the same location._

Exact path to the file:

- Windows: `C:\Users\<YourUser>\AppData\Local\openmohaa\main\configs\omconfig.cfg` or `%APPDATA%\openmohaa\main\configs\omconfig.cfg`
- Mac: `~/Library/Application\ Support/openmohaa/main/configs/omconfig.cfg`
- Linux: `~/.openmohaa/main/configs/omconfig.cfg`

### Step 7: Customize Your Experience

You can customize the game by editing the `omconfig.cfg` file, which contains various settings for graphics, controls, and gameplay.

### 🗺️ Adding Custom Maps

Check out our [Maps Guide](./maps/README.md) for more information!

## 🖥️ Part 5: Server Setup (Optional)

Want to host your own server? Here's how to get started!

### Public Internet Server

You can install it on a remote server and play online with friends worldwide.

**Quick setup steps:**

- Make a copy of the game folder to a new directory
- Download the OpenMohaa release for your server architecture [(Linux x64 is recommended)](https://github.com/openmoh/openmohaa/releases/download/v0.82.1/openmohaa-v0.82.1-linux-amd64.zip)
- Extract the files into the new directory
- (Optional) You can remove all `music` and `video` files from the `main`, `mainta`, and `maintt` directories to save space
- Create a `server_opm.cfg` in the `main` directory (or on the server's ~/.openmohaa/main)
  - Use the contents from [Base](./server/server_opm.cfg) or [Custom](./server/server_opm.custom.cfg)
- If you want to include any custom maps, you can place the `.pk3` files in the `main` directory of the server folder (or on the server'same ~/.openmohaa/main)
- Copy the folder to your online server using `scp -r /path/to/server/folder root@<server-ip>:/server`
- SSH into the server: `ssh root@<server-ip>`
- Navigate to the server folder: `cd /server`
- Run the server: `./omohaaded +set com_target_game 0 +exec server_opm.cfg`
- To run the server in Docker, you can use the following simplified command: `docker run --name mohaa -d --rm -it -p 12203:12203/udp -v $HOME/.openmohaa:/root/.openmohaa -v $PWD:/server -w /server debian bash -c './omohaaded +set com_target_game 0 +exec server_opm.cfg'`

> **⚠️ Important:** Remember to update your server's firewall to allow inbound traffic on ports `12203` & (`12300` if you enabled GameSpy).

📖 **Need more details?** Check out our comprehensive [server installation guide](./server/README.md).

---

## 🤝 Community & Support

- 🐛 **Found a bug?** Open an issue on GitHub
- 💬 **Questions?** Join the discussion in Issues
- 🔧 **Contributing?** Pull requests welcome!

## 🗺️ Roadmap & Future Plans

### Coming Soon

- [ ] 🐳 Enhanced Docker support for easy server deployment
- [ ] 📦 Automated setup scripts for both local and server installation
- [ ] 📁 Improved file organization separating game files from customization
- [ ] 🔄 Auto-restart server on configuration changes
- [ ] 🌐 Public file hosting for easy map downloads
- [ ] 🔧 One-click server initialization scripts
- [ ] 🖥️ Itermocil integration for easy terminal management

---

## 📜 License & Credits

This guide is for educational purposes. Medal of Honor: Allied Assault is owned by EA Games.

Special thanks to the [**OpenMohaa**](https://github.com/openmoh/openmohaa) project team for keeping this classic alive!