The Urt5 Official Mapping plugin

This guide explains the steps required to install the FrozenSand - Urban Terror Mapping Plugin, and configure the Unreal Engine, to facilitate the creation of custom levels (maps) for Urban Terror 5: Resurgence.

Be aware that the Engine takes a lot of disk space (G0 GB+), and maybe 5 to 10 GB for a Level.

(This guide is for Windows. Some steps will vary on Linux.)

Getting Unreal Engine 4

Urban Terror is built upon Unreal Engine 4. To create a custom level you need to use the Unreal Editor. The first step is to download the editor. There are several ways to get the UE4 editor. The easiest is to download and install it through the Epic Games Launcher.

• Download the Epic Games Launcher: https://www.epicgames.com/store/download
• Start the Launcher.
• Log in with your existing Epic Games account or create a new account.
• Switch to the Library tab at the top of the launcher.
• Click the yellow plus sign to add a new engine version. You need to use the same version that the Mapping Plugin was released for. That's currently 4.26.x (the patch version 'x' is not relevant for creating a custom levels, so use the latest).
• Click Install. A new window should pop up that lets you choose the install location.
• Click the *Options* button. Make sure to select Linux. Everything else doesn't matter and can be unchecked to save disk space. Click *Apply* to confirm your choices.
• Click the *Install* button and wait for the Unreal Editor to download and install.

Setting up Your Project

Creating a New Project

Once you have the editor installed and ready to go, you need to create a new project.

• Launch the editor by clicking on the launch button in the Epic Games Launcher, or using the desktop shortcut, and wait for the Unreal Project Browser to open.
• Select *Blank Project* and click *Next*.
• Select the *Blank* template and click *Next*.
• Choose a path and a project name. The project name is not important for your level and won't appear anywhere once you have packaged your level. Choose something that makes sense to you. For this guide, we'll use **MyProject**.
• Adjust the project settings to be: *Blueprint*, *Maximum Quality*, *Raytracing Disabled*, *Desktop/Console*, *No Starter Content*.
• Click the *Create Project* button and wait for the Editor to open your new project.

Installing the Urban Terror Mapping Plugin

Before started with your new project, there are some Urban Terror specific things to configure first. This includes the Urban Terror Mapping Plugin, some project settings, and the folder structure.

• Close the editor if you have it open.
• Download the Urban Terror Mapping Plugin.
• Open your file manager and navigate to your project folder.
• Check if there is a folder called *Plugins* in your project folder. If there isn't, create it.
• Unpack the UrbanTerrorMappingPlugin.zip file into the *Plugins* folder of your project.

The Unreal Engine has a lot of settings. When creating levels for Urban Terror, some of your settings should match the settings the game is using. You could go into the project settings in the editor and manually change them all, but there is a faster way to do that. Project settings are stored in `MyProject/Config/DefaultEngine.ini`.

• Navigate to `MyProject/Config/` folder and open the *DefaultEngine.ini* text file.
• Navigate to the `MyProject/Plugins/UrbanTerrorMapping/` folder and open the *readMe.md* text file.
• Copy the settings text from *readme.md*, and append it at the bottom of the *DefaultEngine.ini* file.
• Save and close the files.

This will do a few things:

• Override the default world settings class with the URTWorldSettings class from the Urban Terror Mapping plugin.

This is required. Otherwise, the game will not load your level.

• Make your project use the forward rendering path. Urban Terror uses forward shading. In order for you to be able to correctly preview your assets and level the way they would be rendered in the actual game, you need to use forward shading for your project as well.
• Adjust some navigation settings. This allows you to preview any navmesh you might use the way it will be generated by the game at runtime.
• Add all the surface type definitions the game is using to your project. This enables you to correctly apply these surface types to the materials and meshes in your level.
• Add the custom collision pre-sets used in the game.

Folder Structure

Now that your project settings are set up, it's time to open up your project again. This might take a while again. Most likely the engine needs to compile a lot of shaders because you switched to the forward renderer.

Once your project is open, take a look at the content browser.

• Right-click on *Content* and create a new folder called *ThirdParty*.
• Inside the *ThirdParty* folder, create a new folder and give it a descriptive name. This is the folder that all the content of your custom level will be in. This name must also be used for your .pak file when you eventually package your level. So it is advised that you give it the name you intend to call your level. For this guide, we'll use **MyLevel**.

How you structure your project inside your level folder is totally up to you. Here are just two common ways to organize the content of your level into subfolders:

Organizing by using a folder for each asset type

|-- Content

   |-- ThirdParty
       |-- MyLevel
           |-- Audio        // contains all audio/sound files
           |-- Effects      // contains all particle/visual effects
           |-- Maps         // contains the map file(s)
           |-- Materials    // contains all materials used in the level by all art assets
           |-- Meshes       // contains all meshes used in the level
           |-- Textures     // contains all textures used in the level by all art assets

Organizing by creating a subfolder for each art asset. Meshes, materials, and textures are thrown together into the asset's folder.

|-- Content

   |-- ThirdParty
       |-- MyLevel
           |-- Art                // contains all meshes, materials and textures in the level, sorted into meaningful subfolders for each asset
           |   |-- Industrial     
           |   |   |-- Buildings  // contains all wall, floor and other base building assets as well as their materials and textures
           |   |   |-- Machinery  // contains all machinery meshes and their materials and textures
           |   |   |-- Pipes      // contains all pipe meshes and their materials and textures
           |   |-- Nature
           |   |   |-- Rocks      // contains all rock meshes and their materials and textures
           |   |   |-- Trees      // contains all tree meshes and their materials and textures
           |-- Audio              // contains all audio/sound files
           |-- Effects            // contains all particle/visual effects
           |-- Maps               // contains the map file(s)

Keep in mind though, that there is a maximum file path length of 260 characters in UE4. So don't use too deeply nested folders, and keep your asset names reasonably short, otherwise, you won't be able to cook and package your level.

Working on Your Project

Creating a New level

With your project set up and ready to go, it's finally time to create your level.

• In the top menu bar select *File* → *New Level* → *Default*.
• Save the level in your *Maps* folder and give it the same name as you chose for the folder in the previous step.

Available and Restricted Features

Now you can start importing assets and place them in your level. You can use almost all the tools and features that Unreal Engine offers, with a few exceptions. You can use static meshes, skeletal meshes, animations, particle systems, materials, material functions, material instances, landscapes, foliage actors, sound cues, attenuation classes, behaviour trees, etc.

There is one major feature, which you cannot use though: Blueprints are a very powerful visual coding system that would allow you to alter almost any game logic and in a worst-case scenario also allows someone to run malicious code on the machines of other players who load their level. To keep the game experience consistent across all levels and to keep our players safe from harm, custom Blueprints have been disallowed. For the same reason, the Level Blueprint is disabled as well. If you package your level, and the pak file contains any Blueprint, the game will refuse to load your level. (more on the topic in *Cooking and packaging your level* later in this document). You are however allowed to use default engine Blueprints and Blueprints from the Urban Terror Mapping plugin, both of which will not actually be included in your packaged level file, but will reference content supplied with the game.