General Game Mode Setup – Arma Reforger
Lou Montana (talk | contribs) m (Text replacement - "<syntaxhighlight lang="c#">" to "<enforce>") |
Lou Montana (talk | contribs) m (Text replacement - "</syntaxhighlight>" to "</enforce>") |
||
| Line 154: | Line 154: | ||
BaseGameMode baseGameMode = GetGame().GetGameMode(); | BaseGameMode baseGameMode = GetGame().GetGameMode(); | ||
SCR_GameModeBase gameMode = SCR_GameModeBase.Cast( baseGameMode ); | SCR_GameModeBase gameMode = SCR_GameModeBase.Cast( baseGameMode ); | ||
</ | </enforce> | ||
'''SCR_FactionManager''': single instance in the world - mandatory. | '''SCR_FactionManager''': single instance in the world - mandatory. | ||
| Line 161: | Line 161: | ||
FactionManager baseFactionManager = GetGame().GetFactionManager(); | FactionManager baseFactionManager = GetGame().GetFactionManager(); | ||
SCR_FactionManager factionManager = SCR_FactionManager.Cast( baseFactionManager ); | SCR_FactionManager factionManager = SCR_FactionManager.Cast( baseFactionManager ); | ||
</ | </enforce> | ||
'''SCR_LoadoutManager''' : single instance in the world - mandatory. | '''SCR_LoadoutManager''' : single instance in the world - mandatory. | ||
| Line 167: | Line 167: | ||
<enforce> | <enforce> | ||
SCR_LoadoutManager loadoutManager = GetGame().GetLoadoutManager(); | SCR_LoadoutManager loadoutManager = GetGame().GetLoadoutManager(); | ||
</ | </enforce> | ||
'''SCR_RespawnSystemComponent:''' single instance in the world, attached to game mode. Mandatory. | '''SCR_RespawnSystemComponent:''' single instance in the world, attached to game mode. Mandatory. | ||
| Line 174: | Line 174: | ||
SCR_GameModeBase gameMode; /* = yourInstance; */ | SCR_GameModeBase gameMode; /* = yourInstance; */ | ||
SCR_RespawnSystemComponent respawnSystemComponent = gameMode.GetRespawnSystemComponent(); | SCR_RespawnSystemComponent respawnSystemComponent = gameMode.GetRespawnSystemComponent(); | ||
</ | </enforce> | ||
'''SCR_RespawnComponent:''' Not to confuse with '''SCR_RespawnSystemComponent'''! | '''SCR_RespawnComponent:''' Not to confuse with '''SCR_RespawnSystemComponent'''! | ||
| Line 185: | Line 185: | ||
// Client: if myId is local playerId, respawn component is returned. Null otherwise. (Owned PlayerController component only) | // Client: if myId is local playerId, respawn component is returned. Null otherwise. (Owned PlayerController component only) | ||
// Authority: if myId is valid playerId, respawn component is returned. Null otherwise. (Any PlayerController component) | // Authority: if myId is valid playerId, respawn component is returned. Null otherwise. (Any PlayerController component) | ||
</ | </enforce> | ||
Revision as of 19:18, 30 July 2022
The SCR_BaseGameMode entity is the lowest usable game mode implementation that allows you to set up a custom game mode.
The core idea behind SCR_BaseGameMode is the expansion via specialized components of SCR_BaseGameModeComponent type.
These provide the user with API that allows hooking onto certain game events as necessary. Many provided components can work standalone and can be mixed and matched.
Example Scenarios
To easily get familiar with how game modes can be set up now, please see the following scenarios:
Basic Setup
To setup the most basic scenario the user must add the following. For the simplest set-up add all items from the "Pre-made" column.
Free for All
Faction Based
Requirements
There are several components which are crucial to the functionality of any game mode:
The first and most important is the SCR_RespawnSystemComponent which handles spawning and assigning of requested player entities and via the usage of SCR_RespawnComponent allows handling requests and responses between the authority and the remote client.
It also allows and handles synchronization of player loadout, faction and spawn point selection. Due to that, there always must be an instance of the SCR_FactionManager and SCR_LoadoutManager entities present in the world.
Additionally required is a component of SCR_RespawnHandlerComponent type - a base for implementing custom ways of handling respawning itself. See SCR_AutomaticRespawnHandlerComponent and SCR_RespawnMenuHandlerComponent for examples. The former handles respawning purely on the authority side (automatically), where the latter allows communication and request/approval selection between the remote client and the authority.
Instances
SCR_BaseGameMode: single instance in the world - mandatory.
Ties game mode together, manages attached SCR_BaseGameModeComponent(s), calls necessary methods.
SCR_FactionManager: single instance in the world - mandatory.
Provides available factions and API for retrieving and finding these by keys or indices.
SCR_LoadoutManager : single instance in the world - mandatory.
Provides available loadouts and API for retrieving and finding these by indices.
SCR_RespawnSystemComponent: single instance in the world, attached to game mode. Mandatory.
Provides means of setting and request/response player faction, loadout and spawn points.
SCR_RespawnComponent: Not to confuse with SCR_RespawnSystemComponent!
This component is and should always be attached to a player controller. That means that remote client will always be able to retrieve their local SCR_RespawnComponent only! The authority will be able to retrieve and iterate over all SCR_RespawnComponent.
Game State
The game has three pre-defined states that can be set by the server and are automatically replicated with appropriate callback to the clients. This can be omitted, leaving the game always in GAME state.
- PREGAME (e.g. wait for n players?)
- GAME (core game loop)
- POSTGAME (e.g. show scoreboard, next scenario voting)
For particular implementation and details, see SCR_EGameModeState, SCR_GameModeEndData and SCR_BaseGameMode.OnGameStateChanged().
Gamemode End
The game mode transitions into POSTGAME state once the authority deems so by calling the EndGameMode() method.
This method accepts an instance of SCR_GameModeEndData, which is a small serializable structure that is replicated to all clients and contains somewhat arbitrary data. This can be used to synchronize the end state (winner player, winner faction, ...) to show e.g. the end-game screen.
Troubleshooting
My game mode is not working as it was before, errors are logged into the console regarding missing game mode, what do I do?
Navigate to the Basic Setup section.
Drag prefabs from the Faction Based table if you want to have US versus USSR game mode or Free for All table if FFA is what you are looking for.