> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Add a Mission to Your Arma 3 Server (mpmissions)

> How to add a mission to an Arma 3 server: upload the .pbo to mpmissions, add it to class Missions in server.cfg and restart. Includes the mission name format.

To add a mission to an Arma 3 server, upload the mission's `.pbo` file to the `mpmissions` folder with **Files** > **Upload**, then add it to `class Missions` in `server.cfg` with `template` set to the file name without `.pbo`, for example `template = MyMission.Altis;`. Restart the server. Admins can also switch missions in game with `#missions`.

| Difficulty | Time | Works on | Panel pages |
| - | - | - | - |
| Beginner | 5 minutes | Every FREAKHOSTING Arma 3 server | **Files** |

## Before you start

* Get the mission as a packed `.pbo` file, for example `MyMission.Altis.pbo`. The part after the dot is the map (here Altis).
* If the mission needs mods or a Creator DLC map, install those first. See [install mods](https://help.freakhosting.com/games/arma-3/installing-mods-and-mission-files-in-arma-3.md).

## How to upload a mission

**1. Stop the server**

[Stop the server](https://help.freakhosting.com/portals/game-panel/how-to-start-stop-and-restart-your-game-server.md) so it doesn't hold the mission list.

**2. Open mpmissions**

Click **Files** and open the `mpmissions` folder. On a new server it only holds `readme.txt`.

**3. Upload the .pbo**

Click **Upload** and choose your `.pbo` file. Keep the file name exactly as it is.

**4. Add it to server.cfg**

Go back to the root, open `server.cfg` and add the mission to `class Missions` (see below). Click **Save Content**.

**5. Start the server**

Start the server. The first mission in the list loads when the first player joins, or straight away with **Auto Initialize Mission** on.

## How to add the mission to class Missions

The default `server.cfg` already has a `class Missions` block with two built-in Zeus missions. Replace them, or add your mission as another class. Each mission needs its own class name.

```cpp theme={null}
class Missions
{
    class Mission1
    {
        template = MyMission.Altis;   // file name without .pbo
        difficulty = "Regular";       // Recruit, Regular, Veteran or Custom
        class Params {};
    };
};
```

| Line | What it means |
| - | - |
| `class Mission1` | Any unique name for this entry |
| `template` | The `.pbo` file name without `.pbo`, for example `Altis_Life.Altis` for `Altis_Life.Altis.pbo` |
| `difficulty` | The difficulty for this mission. It overrides `forcedDifficulty`. |
| `class Params {}` | Mission parameters. Leave it empty to use the mission's defaults. |

With more than one mission class, the server runs them in order. Add `randomMissionOrder = true;` outside `class Missions` to pick them at random.

## How to change mission in game

1. Log in as admin with `#login yourAdminPassword`. See [become admin](https://help.freakhosting.com/games/arma-3/how-to-become-admin-on-your-arma-3-server.md).
2. Type `#missions` to open the mission list, or `#mission MyMission.Altis` to load one directly.
3. Use `#restart` to restart the current mission.

To limit which missions admins can choose, add `missionWhitelist[] = {"MyMission.Altis"};` to `server.cfg`.

## How to keep the mission running with no players

Set `persistent = 1;` in `server.cfg`. The mission then keeps running when everyone leaves (missions with base or instant respawn). Turn on **Auto Initialize Mission** on **Startup** to start it without waiting for a player.

## Frequently asked questions

### Can I use a mission I made in the editor?

Yes. Export it from the Eden editor as a multiplayer scenario, which gives you a `.pbo` file, and upload that to `mpmissions`. The server's own `readme.txt` in that folder says exported multiplayer scenarios and downloaded custom scenarios go there.

### Why does my mission not show up?

Check that the `template` matches the file name exactly (without `.pbo`), that the file is in `mpmissions` and that all mods the mission needs are loaded. Then restart.

### Can I upload an unpacked mission folder?

Use a packed `.pbo`. It is the format the Bohemia Interactive wiki uses for custom missions, and players download it when they join.

## Related guides

> [card] [Arma 3 server guide](https://help.freakhosting.com/games/arma-3/arma-3-server-hosting-guide.md)
>
> Every Arma 3 page in one place.

> [card] [server.cfg explained](https://help.freakhosting.com/games/arma-3/configuring-servercfg-for-arma-3.md)
>
> Every important server.cfg line.

> [card] [Admin commands](https://help.freakhosting.com/games/arma-3/arma-3-server-admin-commands.md)
>
> \#missions, #restart and more.

> [card] [Custom difficulty](https://help.freakhosting.com/games/arma-3/configuring-custom-difficulty-and-ai-skill.md)
>
> Difficulty presets and AI skill.

> [card] [File Manager](https://help.freakhosting.com/portals/game-panel/how-to-use-the-file-manager.md)
>
> Upload and edit files.

***

> [!NOTE]
>
> **Tested by the FREAKHOSTING team** on our Game Panel on 31 October 2026 (Arma 3 dedicated server 2.22). `server.cfg` syntax checked against the [Bohemia Interactive server config page](https://community.bistudio.com/wiki/Arma_3:_Server_Config_File). Steps may differ slightly if the game changes.

> [!NOTE]
>
> ### Need Extra Help?
>
> If you encounter any issues, our support team is ready to assist:
>
> * **Live Chat:** Quick assistance via our website.
> * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
> * **Discord:** [Join our Community](https://discord.gg/freakhosting)
> * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)

> [!TIP]
>
> ### Save on Your Hosting
>
> Ready to upgrade your hosting? Use code **KB20** at checkout for **20% off** your first order!

***

**Last Updated:** October 2026


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.