You've already forked UnrealEngineUWP
mirror of
https://github.com/izzy2lost/UnrealEngineUWP.git
synced 2026-03-26 18:15:20 -07:00
82 lines
4.5 KiB
Plaintext
82 lines
4.5 KiB
Plaintext
Availability:Public
|
|
Title:Gameplay Modules
|
|
Crumbs:%ROOT%, Programming
|
|
Description:Collections of gameplay classes belonging to a game project compiled into DLLs.
|
|
Version: 4.5
|
|
|
|
[TOC(start:2)]
|
|
|
|
[EXCERPT:Intro]
|
|
In the same manner that the engine itself is comprised of a collection of modules, each game is made up of one or more gameplay modules. These are similar to packages in previous versions of the engine in that they are containers for a collection of related classes. In Unreal Engine 4, since gameplay is all done in C++, modules are actually DLLs instead of proprietary package files.
|
|
[/EXCERPT:Intro]
|
|
|
|
[REGION:note]
|
|
If your game project is not already created, see [Creating a Game Project](Engine/Basics/Projects/Browser#creatingnewprojects) for instructions on creating and setting up a project for your game.
|
|
[/REGION]
|
|
|
|
## Module Creation
|
|
|
|
Gameplay modules must contain, at the very least, a header file (`.h`), C++ file (`.cpp`), and a build file (`*.Build.cs`). The header file must be located in the `Public` folder of the module's directory, i.e. `[GameName]\Source\[ModuleName]\Public`. This file includes any header files - including the module's auto-generated headers - necessary to compile the classes contained within the module.
|
|
|
|
#include "Engine.h"
|
|
#include "EnginePrivate.h"
|
|
#include "<ModuleName>Classes.h"
|
|
|
|
The C++ file is placed in the `Private` folder of the module's directory, i.e. `[GameName]\Source\[ModuleName]\Private`, registers and implements the module.
|
|
|
|
[REGION:note]At least one module in your game must be registered using `IMPLEMENT_PRIMARY_GAME_MODULE`. Additional modules can use the alternative `IMPLEMENT_GAME_MODULE` method. See the [Multiple Gameplay Modules](#MultipleGameplayModules) section for more details on using more than one gameplay module in a game project.[/REGION]
|
|
|
|
// Include our game's header file
|
|
#include "<ModuleName>.h"
|
|
|
|
// Designate the module as primary
|
|
IMPLEMENT_PRIMARY_GAME_MODULE( <ModuleName>, "<GameName>" );
|
|
|
|
The build file is placed in the root directory of the gameplay module, i.e. `[GameName]\Source\[ModuleName]`, and it defines certain pieces of information used by the UnrealBuildTool to compile the module.
|
|
|
|
using UnrealBuildTool;
|
|
|
|
public class <ModuleName> : ModuleRules
|
|
{
|
|
public <ModuleName>( TargetInfo Target )
|
|
{
|
|
PublicDependencyModuleNames.AddRange( new string[] { "Core", "Engine" } );
|
|
PrivateDependencyModuleNames.AddRange( new string[] { "RenderCore" } );
|
|
}
|
|
}
|
|
|
|
### INI File Setup
|
|
|
|
Because the new gameplay modules will have `UObject` code, some configuration is necessary.
|
|
|
|
1. The module needs to be added in several areas of the `DefaultEngine.ini` file:
|
|
|
|
The `EditPackages` array in the `[UnrealEd.EditorEngine]` section:
|
|
|
|
[UnrealEd.EditorEngine]
|
|
+EditPackages=<ModuleName>
|
|
|
|
The `[Launch]` section:
|
|
|
|
[Launch]
|
|
Module=<ModuleName>
|
|
|
|
The `NativePackages` array of the `[/Script/Engine.UObjectPackages]` section:
|
|
|
|
[/Script/Engine.UObjectPackages]
|
|
+NativePackages=<ModuleName>
|
|
|
|
|
|
## Multiple Gameplay Modules
|
|
|
|
There are philosophical choices about game DLL modularity. Splitting a game up into a lot of DLL files may be more trouble than it is worth, but this is a decision to be made by each individual team based on their needs and principles. Using multiple gameplay modules will result in better link times and faster code iteration, but with more modules you will need to deal with DLL exports and/or interface classes more often. This trade-off is the correct one for engine and editor code, but it is questionable for gameplay.
|
|
|
|
You can create a primary game module, then any number of additional game-specific modules. You can create `*.Build.cs` files for these new modules, then add references to these modules to your game's [`Target.cs` file](Programming/UnrealBuildSystem/TargetFiles) (OutExtraModuleNames array). Be sure to use the appropriate macro for the game modules in the C++ code. At least one module must use the `IMPLEMENT_PRIMARY_GAME_MODULE` macro, while all others should use the `IMPLEMENT_GAME_MODULE` macro. UBT should then automatically discover the modules and compile additional game DLL files.
|
|
|
|
## Limitations
|
|
|
|
Below are a few other notes about setting up gameplay modules:
|
|
|
|
* We do support creating modules that are cross-dependent (both export and import functions and data from each other -- e.g., Engine and UnrealEd modules), but this is not ideal for compile-times and may sometimes cause problems with static initialization of variables. Gameplay modules that are not cross-dependent are harder to design and maintain, but the code may be cleaner for it.
|
|
|