Open source Real-Time Strategy Plugin for Unreal Engine 4 developed by the original creators of Hostile Worlds for Unreal Engine 3.
We really love the spirit of Unreal 4 moving to open-source, and we'd love to give something back.
Note that we're still in heavy development. Some things are already in place, such as
- Camera Movement & Bounds
- Initial Unit Placement
- Single- and Multi-Unit Selection
- Movement Orders
- Stop Orders
- Attack Orders
- Health, Damage (and Healing), Cooldown, Range
- Victory Conditions
- Projectiles
- Unit Target Acquisition
- Control Groups
- Health Bars
- Minimap
- Teams
- Constructions
- Unit Production/Tech Research
- Resource Gathering
- Fog of War
- AI Players
- Cheats
All of this is already completely working in multiplayer as well, and has been fully exposed to scripting, enabling you to update UI and play animations and sounds.
We're going to add all of this to the Unreal Marketplace for free as well soon (tm).
For a quick look, just open Source/RTSProject/RTSProject.uproject
, load Maps/SKM-DarkSpace.umap
in the editor and hit Play. We recommend taking a closer look at that map (and the rest of the example project) as reference for your own one as well.
Real-Time Strategy Plugin for Unreal Engine 4 provides plugin content which is usually not backwards-compatible: Content saved with a newer engine version cannot be opened again with an older engine version. Thus, every time a feature or bugfix requires a plugin content update, the plugin does not support older engine versions anymore. The following table summarizes plugin compatibility with engine versions:
Plugin Version | Supported Engine Versions |
---|---|
1.0.0 | 4.24, 4.25 |
1.1.0 | 4.25 |
1.2.0 | 4.25 |
Git (master) | 4.27 |
Git (feature/ue5) | 5.0EA |
- Close your Unreal Editor.
- Download the latest release.
- Copy the
RealTimeStrategy
folder toPlugins
folder next to your.uproject
file (create if necessary). - Start the Unreal Editor.
- Close your Unreal Editor.
- Clone the repository or download a release.
- Copy the
RealTimeStrategy
folder toPlugins
folder next to your.uproject
file (create if necessary). - Right-click your .uproject file and select Re-generate Visual Studio project files.
- If you want to create C subclasses of the plugin classes, add
"RealTimeStrategy"
to thePublicDependencyModuleNames
of theBuild.cs
file of your project. Note that you might need to add other dependencies as well, depending on the respective class you want to extend. Take a look atRealTimeStrategy.Build.cs
of the plugin for a full list of referenced engine modules. - Build the resulting solution in Visual Studio.
- Start the Unreal Editor.
Take a look at the official manual to get started right away!
We are sorry that you've experienced issues or are missing a feature! After verifying that you are using the latest version and having checked whether a similar issue has already been reported, feel free to open a new issue. In order to help us resolving your problem as fast as possible, please include the following details in your report:
- Steps to reproduce
- What happened?
- What did you expect to happen?
After being able to reproduce the issue, we'll look into fixing it immediately.
We know that using this plugin in production requires you to be completely sure about stability and compatibility. Thus, new releases are created using Semantic Versioning. In short:
- Version numbers are specified as MAJOR.MINOR.PATCH.
- MAJOR version increases indicate incompatible API changes.
- MINOR version increases indicate added functionality in a backwards compatible manner.
- PATCH version increases indicate backwards compatible bug fixes.
You'll always find all available releases and their respective release notes at:
https://github.com/npruehs/ue4-rts/releases
You want to contribute to Real-Time Strategy Plugin for Unreal Engine 4? Great! Take a look at Contributing to get started right away!
Real-Time Strategy Plugin for Unreal Engine 4 is released under the MIT License.