ModsUpdated: 7/15/2026

Urban Strife Modding SDK Tutorial: Getting Started

A comprehensive guide to the Urban Strife modding SDK. Learn how to use the Unreal Engine editor to create custom NPCs, maps, and gameplay loops.

Urban Strife Modding SDK Tutorial: Getting Started

The full release of Urban Strife by White Pond Games and MicroProse brings with it a powerful tool that promises to extend the shelf life of this survival RPG indefinitely: the official modding SDK. Unlike simple configuration tweaks or value edits, this SDK provides direct access to the Unreal Engine editor, the very same tool used by the developers to construct the post-apocalyptic American South. This isn't a watered-down toolkit; it is a professional-grade suite that allows you to manipulate the game's core systems, from the unique Horde AI behavior down to individual weapon ballistics.

For a game built on complex systemic interactions, the ability to mod is transformative. The base game's 20-day Atlanta Horde siege, the delicate balance of Action Points (AP) management, and the interplay between the three factions—the Rogue Army Garrison, The Shady Lady Bikers, and The Cult of Second Chance—are all governed by variables you can now access. Whether you want to create a new campaign where the player starts in a fortified Urban Shelter with a specific set of survivors, or design a custom NPC who offers a unique Interrupt Fire training regimen, the SDK unlocks these possibilities.

This tutorial will guide you through your first steps, from setting up the editor to creating your first functional asset. We will focus on practical application, ensuring you understand not just the how, but the why behind the game's modding architecture. By the end, you will have the foundational knowledge required to start building your own survival scenarios in the world of Urban Strife.

Setting Up the Urban Strife Unreal Engine Editor

Before you can start creating custom content, you must properly configure the Urban Strife Unreal Engine editor. The development team at White Pond Games has streamlined this process significantly compared to raw Unreal Engine projects, but there are specific dependencies tied to the game's tactical layer that you absolutely must respect. The editor requires a specific version of the engine, so do not assume that the latest Unreal build will work without issues.

First, you must ensure you own a legitimate copy of Urban Strife on Steam. The SDK is distributed exclusively through the Steam library under the "Tools" section. Navigate to your library, filter the list to show "Tools," and locate the Urban Strife Modding SDK. The download is substantial—expect a size comparable to the base game—because it includes the full asset library, including models for the Rogue Army Garrison soldiers, the bikes of The Shady Lady Bikers, and the unique ritual items used by The Cult of Second Chance. Once downloaded, you need to point the editor to the base game's asset directory to ensure all references resolve correctly.

After installation, verify the file paths in the project settings. A common error for beginners is having the base game installed on a separate drive from the SDK. This breaks the material references for the ballistic simulation system, causing bullets to pass through walls without registering damage or penetration decals. You should also take this time to explore the content browser. Look for the UrbanStrife_Data folder to familiarize yourself with the naming conventions used by the developers. You will find data tables for Action Points (AP) costs, base damage values for Molotov Cocktails, and the crafting recipes unlocked by befriending NPCs like Professor Ford.

Setup StepKey Folder/LocationCommon Issue
SDK InstallationSteam Library > ToolsSDK not appearing; restart Steam client
Asset LinkingConfig/DefaultEngine.iniMissing textures due to path mismatch
Content BrowserUrbanStrife_Content/BlueprintsRead-only files; copy to local mod folder
Ballistic VerificationUrbanStrife_Content/Core/WeaponsWall penetration data loss
Script CompilationToolbar > Build > CompileUnrealHeaderTool errors

Understanding the Core Modding Framework: Blueprints and Data Tables

The Urban Strife Unreal Engine editor relies heavily on Unreal Engine's Blueprint scripting system. White Pond Games did not simply expose the assets; they structured the game logic in a way that modders can override and extend. This is crucial for creating a custom NPC or altering the behavior of the Horde AI. The framework is divided into distinct layers: the Base Layer (read-only game code), the Extension Layer (modding hooks), and the Override Layer (your custom logic).

The Base Layer contains the compiled code that drives the real ballistic simulation. While you cannot modify the C++ source directly without a full engine license, the Blueprint libraries that call these functions are fully accessible. For instance, the system that determines if a zombie can "hear" a gunshot is exposed. You can modify the hearing radius of individual zombies or even change how the Horde AI aggregates these individual sensors into a mass movement order. This is the core of the game's threat system—the tension of knowing that a single missed shot can trigger a cascading movement of the undead across the map.

Data Tables drive the game's extensive crafting and character progression. The 3-tier profession perk system is not hard-coded; it exists in structured tables you can edit. You can add a fourth tier, create a hybrid class that mixes the Ghost Perk from the stealth infiltrator build with the support build's healing efficiency, or redefine how the Defense Tracker calculates threat values for the Day 20 Atlanta Horde siege. To create a new item, you must define it in the Items table and then create a corresponding Blueprint if it requires custom behavior. For example, adding a new recipe for Dum-Dum Ammo variants requires a simple table edit, while creating a new throwable explosive requires a Blueprint that inherits from the base explosive class to handle the physics of the fragmentation.

Data TableFunctionModding Potential
DT_ProfessionsDefines starting skills and perksCreate hybrid classes with unique skill trees
DT_CraftingRecipesItem combinations and required stationsAdd hidden recipes tied to new NPCs
DT_HordeConfigZombie sensor range, speed, and pack logicAdjust the difficulty of the Day 20 siege
DT_FactionRepReputation thresholds and rewardsScript new faction rewards for custom groups
DT_BallisticsCaliber penetration and damage drop-offRebalance weapons to favor specific builds

How to Create a Custom NPC: A Step-by-Step Guide

One of the most requested features for the Urban Strife community is the ability to create a custom NPC. This process involves more than just placing a character model on a map; it requires you to define their faction allegiance, dialogue, combat behavior, and potential recruitment logic for the Urban Shelter. We will create a simple vendor NPC who sells unique attachments.

Begin by creating a new Blueprint Class that inherits from the BP_BaseNPC parent class. This parent class already contains the node network for the Interrupt Fire reaction system and cover-seeking logic. Name your new Blueprint BP_CustomGunsmith. Open the Blueprint and navigate to the Components tab. Here, you must add a SkeletalMeshComponent and assign a character model. The SDK includes a variety of civilian and military models used in the base game; for this tutorial, select a model that aligns with the neutral trading faction to avoid conflicting with the Rogue Army Garrison aggression triggers.

Next, configure the NPC's behavior tree. The Urban Strife Unreal Engine editor uses a modified behavior tree system that integrates the unique Horde AI awareness states. For a shopkeeper, you want a passive behavior tree that causes the NPC to sandbox around a specific location. Override the GetFactionRelation function to return a neutral disposition to the player, The Shady Lady Bikers, and The Cult of Second Chance, but a hostile disposition to the undead. This prevents the NPC from being automatically attacked by the player's militia, but ensures they will flee or fight if a horde breaches the safe zone.

Now, define the NPC's inventory. This is handled through a dedicated component called NPCInventoryComponent. Here, you can add specific weapons, ammo, and, crucially, a custom crafting recipe for sale. According to community reports, you can link this NPC to the base building system so that recruiting them to your Urban Shelter unlocks a new workbench recipe for a weapon attachment that reduces the Action Points (AP) cost of snap shots. To finalize the NPC, you must set their dialogue and barter tables. The dialogue system is data-driven, so you can create a new dialogue tree in the DT_Dialogue table, referencing your NPC's unique ID. Link this tree to a barter screen that lists the custom attachments you designed. Estimated testing suggests that placing this NPC in a custom map requires adding a spawner actor that references your BP_CustomGunsmith Blueprint.

  1. Duplicate Base NPC: Right-click BP_BaseNPC and create a child Blueprint.
  2. Assign Mesh: Select the SkeletalMesh component and choose an asset.
  3. Configure AI: Open the Behavior Tree asset and set it to BT_PassiveVendor.
  4. Set Faction: Override BPI_Faction to return Faction_Neutral.
  5. Populate Inventory: Add items to the DefaultInventory array.
  6. Link Dialogue: Create a new row in DT_VendorDialogue and assign it to the NPC.

Map Creation and Event Scripting for Survival Scenarios

Creating a map for Urban Strife requires a deep understanding of the game's unique line-of-sight and sound propagation systems. The Unreal Engine editor provides the landscape sculpting tools, but White Pond Games has added a custom "Sound Volume" actor that modders must place to define how gunfire echoes through city streets. Without these volumes, the Horde AI will fail to react to distant combat, trivializing the survival experience.

Start by creating a new Level. Use the landscape tool to sculpt a small section of a rural highway or a suburban block. The key to a functional map is the Navigation Mesh (NavMesh). The Horde AI relies on a tightly optimized NavMesh to move dozens of zombies simultaneously in a single turn. If your NavMesh has holes, the horde will break formation, causing individual zombies to idle in place. You must also place "Horde Entry Points" around the edge of your map. These actors tell the Horde AI where reinforcements can spawn from, dictating the direction of the pressure during the Day 20 Atlanta Horde siege-style events.

Level design must account for the ballistic simulation system. Walls must have the correct physical materials assigned to them (PM_Concrete, PM_Wood, PM_Glass). If you forget to assign a physical material to a mesh, the real ballistic simulation will treat it as an impenetrable barrier, or worse, a material with zero collision for projectiles. This is critical for the Interrupt Fire mechanic; a sniper needs the ability to punch through a wooden fence to suppress a target. You should also place "Cover Nodes" manually for the best results. While the engine can auto-generate cover, manual placement ensures that the Rogue Army Garrison soldiers use realistic military tactics when they spawn on your map.

Scripting dynamic events involves using the Level Blueprint. A classic scenario is a "survive the night" mode. You can script a timer that, upon expiration, activates a series of horde spawners. According to community modding reports, you can link this to the Defense Tracker system to give the player a 24-hour radio warning, mimicking the main campaign's structure. This adds a strategic layer where the player must use the time to craft Molotov Cocktails and set up barricades, utilizing the base building mechanics within a custom mission map.

Map ElementRequired AssetFunction
Sound PropagationBP_SoundVolumeDefines how far a gunshot is heard by the Horde AI
Horde SpawningBP_HordeEntryPointDesignates spawn locations for zombie packs
Ballistic MaterialsPhysical Material AssetEnsures bullets penetrate wood but not concrete
Cover SystemNavLinkProxy & Cover NodesManual placement for tactical shootouts
Event TriggersLevel BlueprintScripts radio warnings, supply drops, or faction ambushes

Advanced Modding: Custom Weapons and Faction Integration

Once you are comfortable with the basics, you can delve into creating custom weapons that interact with the 3-tier profession perk system. This is where the Urban Strife modding for beginners path diverges into advanced territory. Creating a custom weapon is not just a 3D modeling exercise; it is a scripting challenge that requires you to interface with the perk system and the Action Points (AP) economy.

To add a new firearm, you need a mesh, a firing animation, and a data table entry. The data table defines the weapon's interaction with the real ballistic simulation. You can set the caliber, which automatically determines its wall penetration capabilities. For example, a custom .50 caliber rifle will inherently punch through more walls than a 9mm pistol, because the caliber links to the physical material properties we discussed earlier. You can also define the weapon's interaction with the 3-tier profession perk system. Does this weapon gain a critical hit chance bonus for the ranged specialist? Does it allow the stealth infiltrator to use a suppressed variant with the Ghost Perk? These are parameters you set in the DT_WeaponStats table.

Integrating this weapon with a faction creates a cohesive mod. Suppose you want to add a unique crossbow to The Cult of Second Chance. You would create the weapon Blueprint, set its damage type to "Bleed" (which synergizes with the Cult's unique recipes), and then open the DT_FactionRewards table. Here, you can add the crossbow as a reward for reaching "Revered" status with the faction. Furthermore, you can edit the Urban Shelter’s workshop to require a specific workstation upgrade, obtained via the Cult's questline, to craft the special bolts for this crossbow. This creates a deep integration loop that feels native to the game. The free modding SDK allows you to add custom meshes for these bolts, which can be set to pierce through multiple targets if your ballistic penetration values are high enough.

The final integration point is the Horde AI reaction. You can flag your custom weapon as "Silent" or "Loud" in the data table. A silent weapon does not trigger the mass movement of the horde, allowing the stealth infiltrator build to function properly. However, an "Insufficiently Silent" tag can be added, meaning the weapon is quiet but still triggers individual zombie sensors if they are too close, adding a layer of risk management. This is the kind of depth that makes Urban Strife modding so compelling. The MicroProse publishing team has highlighted the importance of this systemic depth, and the SDK provides the tools to manipulate it fully.


What is the Urban Strife Modding SDK and where do I get it?

The Urban Strife Modding SDK is a free toolkit provided by White Pond Games that gives you access to the Unreal Engine editor version used to create the game. You can find it in your Steam library under the "Tools" section after purchasing Urban Strife. It allows you to create custom content such as new maps, weapons, and NPCs.

Do I need programming experience to create a custom NPC?

Not necessarily. While deep C++ knowledge is helpful for engine-level changes, the Urban Strife Unreal Engine editor relies heavily on Blueprint visual scripting. You can create a custom NPC with basic logic, a new inventory, and a barter menu using only Blueprints and data table edits, without writing a single line of code.

How do mods affect the Day 20 Atlanta Horde siege?

Mods can drastically alter the siege. You can edit the DT_HordeConfig table to change the number of zombies, their speed, or their spawn points. You can also script new events, like a reinforcement squad from the Rogue Army Garrison arriving if your reputation with them is high enough, turning the tide of the battle.

Can I break my game by installing mods?

It's always recommended to back up your save files before installing major gameplay overhaul mods. The SDK writes to a separate mod directory, so verifying your game files through Steam can usually revert the base game to its original state if a mod causes instability. Always read the mod creator's description for known conflicts, especially with mods that alter the Defense Tracker or Action Points (AP) systems.

For further reading on how the base building mechanics work before you mod them, check out our guide on Urban Shelter upgrades and survivor management. For official announcements and SDK updates, join the community on the official Discord server.

Frequently Asked Questions

What version of Unreal Engine does Urban Strife use?

Urban Strife is built on Unreal Engine. The Modding SDK is designed to work with the same engine version. Check the SDK documentation on the official Steam page for the exact version requirement, as it may update with game patches.

Can I create custom weapons with the SDK?

Yes, custom weapon creation is one of the primary features of the Modding SDK. You can define new weapon stats, calibers, penetration values, and crafting recipes. The SDK includes weapon templates that follow the game's real ballistic simulation rules, ensuring your custom weapons integrate properly with the existing combat system.

How do I test my mod in-game?

The SDK includes a local testing environment. After building your mod, use the SDK's "Playtest" feature to load your mod into a sandbox map. This allows you to verify weapon stats, item placement, and AI behavior without affecting your main campaign save. You can also use console commands to spawn specific items and test interactions.

Are there modding competitions or community events?

The official Discord server hosts monthly modding challenges where the community votes on the best creations. White Pond Games occasionally features outstanding mods in their development updates. Participating in these events is an excellent way to get feedback and exposure for your work.