The Unreal Game Mode class
Consider a situation where you want to be able to pause your game. All the logic and implementation that’s required to be able to pause the game will be placed inside a single class. This class will be responsible for handling the game flow when a player enters the game. The game flow can be any action or a set of actions that occur in the game. For example, game pause, play, and restart are considered simple game flow actions. Similarly, in the case of a multiplayer game, we require all the network-related gameplay logic to be placed together. This is exactly what the Game Mode class is there for.
Game Mode is a class that drives the game logic and imposes game-related rules on players. It essentially contains information about the current game being played, including gameplay variables and events, which will be mentioned later in this chapter. Game Mode can hold all the managers of the gameplay objects, it’s a singleton class, and it can be accessed by any object or abstract class present in the game.
As with all the other classes, the Game Mode class can be extended in Blueprints or C++. This can be done to include extra functionality and logic that may be required to keep players updated about what’s happening inside the game.
Let’s go over some example game logic that goes inside the Game Mode class:
- Limiting the number of players that are allowed to enter the game
- Controlling the Spawn location and Player Controller logic of newly connected players
- Keeping track of the Game Score
- Keeping track of the Game Win/Lose condition
- Implementing the Game Over/Restart Game scenario
In the next section, we will look at the default classes provided by Game Mode.
Game Mode default classes
In addition to itself, Game Mode uses several classes to implement game logic. It allows you to specify classes for its following defaults:
- Game Session Class: Handles admin-level game flow such as login approval.
- Game State Class: Handles the state of the game so that clients can see what’s going on inside the game.
- Player Controller Class: The main class that’s used to possess and control a pawn. It can be thought of as a brain that decides what to do.
- Player State Class: Holds the current state of a player inside the game.
- HUD Class: Handles the user interface shown to the player.
- Default Pawn Class: The main actor that the player controls. This is essentially the player character.
- Spectator Class: Being a subclass of the
DefaultPawn
class, theSpectatorPawn
class specifies the pawn responsible for spectating the game. - Replay Spectator Player Controller: The Player Controller that’s responsible for manipulating the replay during playback, within the game.
- Server Stat Replicator Class: Responsible for replicating server stat net data.
You can either use the default classes as-is or you can specify your own for custom implementation and behavior. These classes will work in conjunction with Game Mode and will automatically run without being placed inside the world.
Gameplay events
In terms of a multiplayer game, when many players enter the game, it becomes essential to handle logic to allow them to enter the game and maintain their state, as well as viewing other players’ states and handling their interactions.
Game Mode provides you with several events that can be overridden to handle such multiplayer gameplay logic. The following events are especially useful for networking features and abilities (which they are mostly used for):
On Post Log In
: This event is called after the player is logged into the game successfully. From this point onward, it is safe to call replicated logic (used for networking in multiplayer games) on thePlayer Controller
class.Handle Starting New Player
: This event is called after theOn Post Log In
event and can be used to define what happens to the newly entered player. By default, it creates a pawn for the newly connected player.SpawnDefaultPawnAtTransform
: This event triggers the actual pawn spawning within the game. Newly connected players can be spawned at particular transforms or at preset player start positions placed within the level (which can be added by dragging and dropping thePlayer Start
from the Models window into the world).On Logout
: This event is called when a player leaves the game or is destroyed.On Restart Player
: This event is called to respawn the player. Similar toSpawnDefaultPawnAtTransform
, the player can be respawned at specific transforms or pre-specified locations (using the player start position).
Networking
The Game Mode class is not replicated to any clients or joined players. Its scope is only limited to the server where it is spawned. Essentially, the client-server model dictates that the clients only act as inputs within the game that is being played on the server. Therefore, the gameplay logic should not exist for the clients; it should only exist for the server.
GameModeBase versus Game Mode
From version 4.14 onward, Epic introduced the AGameModeBase
class, which acts as the parent class for all Game Mode classes. It is essentially a simplified version of the AGameMode
class.
However, the Game Mode class contains some additional functionality that is better suited for multiplayer shooter-type games as it implements the Match State
concept. By default, the Game Mode Base is included in new template-based projects.
Game Mode also contains a State Machine that handles and keeps track of the player’s state.
Now that you have some understanding of Game Mode and its relevant classes, in the next section, you will learn about levels and the Level Blueprint, and how they tie to the Game Mode class.