/OnAllFronts-Public

UE5 MilSim FPS / RTS Game (formerly ProjectM)

Primary LanguageC++MIT LicenseMIT

On All Fronts

Latest Demo

Artillery

https://youtu.be/pimnY7-lyx4

What is this?

On All Fronts is a tactical shooter and strategy FPS / RTS game developed with Unreal Engine 5, leveraging the new Mass Entity (ECS) framework to have a very large number of entities not seen in traditional FPS games (tens or hundreds of thousands). Think Squad meets Foxhole meets PlanetSide 2 mixed in with massive number of AI controlled soldiers.

Note that the project has transitioned to closed source so we could use paid assets, but this open source repo will stay around to help others learn the Mass Entity system which is not very well-documented/supported yet.

Join our Discord Server here.

Motivation

In today's MilSim games players frequently end up doing things or seeing things that would not happen in an actual MilSim. Examples:

  • Soldiers magically spawn onto the battlefield
  • Areas of interest are captured by standing near them
  • Areas that should be defended have little or no one defending them (because it's boring)
  • Soldiers being revived who should be dead
  • Soldiers being healed much faster than they should be able to

On All Fronts aims to eliminate these unrealistic occurrences while keeping the game fun. It mainly does this by leveraging AI to do the not-so-fun stuff such as:

  • Moving soldiers to the frontlines
  • Defending all areas of interest, even those with little activity
  • Logistics
  • Vehicle repairs
  • Medical evacuation (medevac)

Human players will never spawn soldiers onto the battlefield. Instead they will possess an AI-controller soldier already on the battlefield. Each match will last until all soldiers of one team are dead or main objectives have been accomplished.

Roadmap

The project is broken into multiple phases. For current status, see Project Tracker.

Phase 1: Demo

  • Single player: One human player and thousands of AI soldiers (no vehicles)
  • Epic's City Sample map

Phase 2: Early Access

  • Multiplayer FPS game with per-server battles
  • Human and AI soldiers only (no vehicles)
  • Epic's City Sample map

Phase 3: Release

  • Ground vehicles
  • Commander assets (e.g. artillery)
  • More maps

Phase 4: Multiplayer MMO

All players in the game will be in a single battle at a time, across multiple servers.

This phase is split into two sub-phases below.

Phase 4A: Server switching between zones

The map will be split up into zones. When a player reaches the border between zones, they load into a different server that manages that area of the map.

Phase 4B: Server meshing across zones

Seamless switching between servers and players at the borders of servers will talk to all nearby servers to have a seamless experience across zones.

End Game

The ultimate goal is to recreate a war at a scale such as in this video (with the teams a bit more balanced): https://youtu.be/RSqKx3FG0Lw

Possible Features

These ideas below would be explored in one of the phases above.

  1. Railroad system for logistics. Railroads can be damaged and repaired.
  2. Oil pipelines for transfering oil to vehicles quicker.
  3. Base building (FOBs and COPs)
  4. Pontoon bridges which can be built for river crossings. Bridges can be destroyed.
  5. Building destruction
  6. Naval warfare
  7. Helicopters
  8. Airplanes (not player controlled initially, only AI)

FAQ

Development Environment Setup

Prerequisites

  1. Install Git. Two recommended options:
    1. For Git beginners, GitHub Desktop is recommended.
    2. For more advanced users, Git for Windows is recommended. Use the default options in installer.
  2. Install Unreal Engine 5.0.3 from Epic Games Launcher.
  3. Install Visual Studio 2022.

    1. Follow steps here for which options to choose when installing.

    2. In Visual Studio Installer make sure to select a .NET Framework SDK version, at least 4.6. image

    3. If you don't have it installed, install latest .NET Core 3.1: https://dotnet.microsoft.com/en-us/download/dotnet?cid=getdotnetcore

  4. If you plan to modify C++/C# code: Launch Visual Studio > Tools > Options
    1. Text Editor > C/C++ > Tabs > select "Keep tabs"
    2. Text Editor > C# > Tabs > select "Keep tabs"
    3. Text Editor > Advanced > uncheck "Use adaptive formatting"

Quick Start

The project is structured as an Unreal Engine plugin. To quickly get started, we have an Unreal Engine starter project that already includes a reference to plugin. To use it:

  1. In GitHub Desktop:
    1. File > Clone repository > URL tab
    2. URL: https://github.com/Leroy231/ProjectMStarter.git
    3. Local path: choose a folder on your machine where you want the Unreal Engine project created
    4. Click Clone
  2. In Windows Explorer double click the .uproject at the root of the folder where you cloned the project.
  3. You should get a prompt about missing modules. Click Yes to build them.
  4. Note that you won't see any progress while it's building, just be patient. If you want to make sure it's building, open Task Manager and you should see Microsoft C++ Compiler using CPU. On an Intel Core i7-9700K CPU @ 3.60GHz this took about 3 minutes.
  5. When it's done, it should open the project in Unreal Engine. Now move onto the next section below.

Add Assets

  1. First confirm that the ProjectM folder shows up in your Content Drawer under Plugins. If you don't see Plugins, click Settings button on top right of Content Drawer > Show Plugin Content.
  2. Add Content Packs from Content Drawer > Add > Add Feature or Content Pack > Blueprint
    1. First Person > Add to project.
    2. Third Person > Add to project.
  3. Add Unreal Engine Marketplace free content to project. Note that some of this content hasn't been migrated to UE5 yet, so when you try to add it from the Epic Games Launcher, check "Show all projects" after clicking "Add to Project". Then in the "Select Version" dropdown select the newest version in the list.
    1. Military Weapons Silver
    2. M1A1 Abrams Tank
    3. Realistic Starter VFX Pack Vol 2
    4. Animation Starter Pack
  4. Now in Content Drawer open "Plugins/ProjectM Content/Playgrounds/Maps/L_MediumWithTanks" level and use PIE to test out the project.
    1. You might have to build NavMesh paths via menu for move commands to work: Build > Build Paths.

Adding Plugin to Existing Project

  1. If you want to use the City Sample project for developing in a large level, get the project from UE Marketplace and then create a project using that template.
  2. If there is no .sln in the project folder, generate VS project from right clicking .uproject in project folder.
  3. Open .sln in Visual Studio if it isn't already open.
  4. If project isn't open yet in UE, run the project from VS.
  5. Enable the required plugins in UE project if they are not already:
    1. Edit > Plugins
    2. Search for "mass"
    3. Check MassAI, MassCrowd, MassEntity, MassGameplay. Answer Yes if it asks if you're sure.
  6. Quit UE.
  7. In PowerShell:
    1. cd to project folder. This is the folder that has the .uproject file.
    2. If Plugins folder does not exist, mkdir Plugins.
    3. cd Plugins
    4. git clone https://github.com/Leroy231/OnAllFronts.git
    5. If in City Sample: rmdir -recurse AnimToTexture
    6. git clone --branch projectm https://github.com/Leroy231/AnimToTexture.git
  8. Right click the .uproject file again and re-generate the solution to get the new files from the Plugins folder to show in VS.
  9. In order to get Mass ParallelForEachEntityChunk to actually parallelize, it requires passing an argument to editor on launch:
    1. In VS Solution Explorer, right click the project under Games folder > Properties.
    2. Debugging > Command Arguments > Add " -ParallelMassQueries=1" to the end (without quotes).
  10. Rerun project from VS.
  11. Edit > Project Settings
    1. Engine - Input > Bindings
      1. Ensure you have all the AxisMappings and ActionMappings from here: https://github.com/Leroy231/ProjectMStarter/blob/main/Config/DefaultInput.ini
    2. Engine - Mass
      1. Search for "MassUpdateISMProcessor" > Mass > Module Settings > Mass Entity > Processor CDOs > Index (for MassUpdateISMProcessor) > Auto Register with Processing Phases > uncheck. Note this will already be unchecked in the City Sample project.
      2. Search for "MassGenericUpdateISMVertexAnimationProcessor" > Mass > Module Settings > Mass Entity > Processor CDOs > Index (for MassGenericUpdateISMVertexAnimationProcessor) > Auto Register with Processing Phases > check
      3. Do the same as previous for "MassSimpleUpdateISMProcessor".
    3. Engine - Navigation System > Agents > Supported Agents > Add agents based on the "SupportedAgents" towards bottom of this file: https://github.com/Leroy231/ProjectMStarter/blob/main/Config/DefaultEngine.ini
      1. Only the Name, Nav Agent Radius, and Nav Agent Height need to be set.
  12. Follow steps above in Add Assets section.

To add soldiers to City Sample Level

  1. Duplicate Small_City_LVL and call it Small_City_ProjectM_LVL
  2. Open Small_City_ProjectM_LVL
  3. Delete Actors
    1. Mass Spawners: BP_MassTraffic* and BP_MassCrowdSpawner
    2. BP_CitySampleWorldInfo
    3. BP_Nightmode
    4. SmartObjectCollection
  4. Open L_Template
  5. Copy PM_* actors
  6. Paste in Small_City_ProjectM_LVL. Ensure locations of all actors were preserved.
  7. Set up world info
    1. Select actor "PM_WorldInfo"
    2. Details pane > Sim > Sunlight > set "Sun Light" to "DirectionalLight_WP"
    3. Set "Sky Dome" to "SM_dome"
  8. From menu: Build > Build ZoneGraph
  9. Select each PM_MilitaryUnitMassSpawner* actor > Details > World Partition > Is Spatially Loaded > uncheck
  10. World Settings > GameMode Override > BP_FirstPersonGameModeCommander
  11. We need to make collisions loaded all the time because AI soldiers rely on them to determine if they have line of sight to enemies:
    1. Load all cells in World Partition
    2. While we've got all cells loaded, build NavMesh from menu: Build > Build Paths
    3. In Outliner search for "coll"
    4. Click on any actor in the Outliner and select all (Ctrl+A)
    5. Details > World Partition > Is Spatially Loaded > uncheck
    6. World Partition: Unload all cells and load any if desired