Getting Started

Before changing match rules or UI, run the shipped flow once so you know which Blueprints and widgets are involved.

sequenceDiagram
  participant Menu as WBP_MainMenu
  participant GI as BP_VehicleGameInstance
  participant Select as Map_VehicleSelection
  participant GM as BP_VehicleGameMode
  participant Arena as Map_Gameplay

  Menu->>GI: Set player name and match settings
  Menu->>Select: Choose Vehicle
  Select->>Menu: Pick DT_Vehicles row
  Menu->>Arena: Play Solo or Host Match
  GM->>Arena: Spawn pawns and BP_Ball
  Arena->>Arena: Match countdown then play

Open the project

1. Add Vehicle Soccer Template from FAB and open it in Unreal Engine 5.8.
2. The editor loads Map_MainMenu (Content/VehicleSoccerTemplate/Maps/Map_MainMenu).
3. Press Play (PIE).

Example: solo match from the main menu

This is the fastest path through the template — no networking required.

1. On WBP_MainMenu, enter a player name (for example Striker) and click Set Player Name.
2. Leave Play Mode on Solo and match settings at their menu defaults.
3. Click Choose Vehicle, then pick Sports or Offroad on WBP_VehicleSelection.
4. Click Play Solo — the project travels to Map_Gameplay.
5. After the Match Countdown on WBP_VehicleUI finishes, drive toward BP_Ball and hit it into the opposing BP_GoalPost.

You should see the score update on Team One Score / Team Two Score, hear MS_Goal, and watch the ball respawn after Ball Reset Countdown.

Controls during the example match

Input	What happens
W / S or left-stick forward/back	Throttle (IA_MoveForward)
A / D or left-stick left/right	Steer (IA_MoveRight)
Space	Jump / dodge (IA_Jump)
Left Shift (hold)	Boost (IA_Boost) — meter on WBP_VehicleUI
Left Ctrl	Handbrake / powerslide (IA_Handbrake)
Q / E	Air roll while airborne (IA_AirRoll)
R	Flip car upright (IA_ResetCar)
F	Lock camera on ball (IA_FocusBall)
C	Switch camera (IA_SwitchCamera)
Tab (hold)	Show WBP_ScoreBoard (IA_Scoreboard)

Exact keys come from IMC_KeyboardDefault; gamepad bindings are in IMC_GamepadDefault.

Example: host a 2 x 2 listen server

Use this when testing multiplayer on one machine with multiple PIE clients.

1. On WBP_MainMenu, set Play Mode to 2 x 2.
2. Set Match Time to 300 (five minutes) on the menu spin box.
3. Click Host Match (or Host Game).
4. Choose a vehicle, then start the match.
5. In the editor, use Play → Number of Players 4 and Net Mode → Play As Listen Server to join with additional local clients.

Each client spawns a BP_VehicleParent pawn at a BP_VehiclePlayerStart; BP_VehicleGameMode alternates TeamOne / TeamTwo via Last Team Assigned.

What to inspect after playing

Asset	Why open it
BP_VehicleGameMode	Vehicle Game Mode Settings, Ball Spawn Transform, team scores
BP_VehicleGameState	bCanScoreGoal, bIsOvertime, match timer
VehiclePlayerController	Enhanced Input bindings and WBP_VehicleUI reference
DT_Vehicles	Default Sports and Offroad rows
BP_Ball / BP_GoalPost	Scoring and ball reset behaviour

Next steps

• Tune match rules — example presets for casual, ranked, and blitz modes
• Customize the HUD — rebrand menus and in-match UI
• Add a vehicle to the roster — worked example adding a third car