New Player Experience

Reference for gameplay_discover_newPlayerExperience, which defines the default "New Player Experience" discover page. Contains introductory freeroam experiences and curated beginner-friendly missions.

Overview

This is the primary discover page for new players (order = 0). It provides five freeroam experiences covering different gameplay styles (cruising, off-road, track racing, destruction, ramp truck) and ten curated missions spanning various mission types.

Page Info

Binding Legend

The module defines a bindingLegendActions table for UI button overlays:

Freeroam Experiences

leisurelyDrive - Leisurely Drive

• Level: Italy (town east spawn)
• Vehicle: Vivace 230S DCT
• Traffic: Enabled (delayed activation - waits until player moves 5m)
• Nav focus: Set to a scenic destination
• Tasks: "Explore" with leisurely drive subtext

johnson_valley - Johnson Valley Off-Road

• Level: Johnson Valley (remote pits spawn)
• Vehicles: Pickup (desert truck), Racetruck (TT2 spec), UTV (plus)
• Traffic: Disabled
• Setup: All vehicles configured with locked diffs, 4WD low range
• Tasks: "Explore" with off-road subtext

trackday - Track Day

• Level: Hirochi Raceway (pitlane spawn)
• Vehicles: 5 sport cars (Sunburst2, ETK-C, Scintilla, ETK800, Vivace)
• Traffic: Disabled
• Environment: Late afternoon (time 0.79), light fog
• Tasks: Track day instructions + explore

propDestruction - Prop Destruction

• Level: Industrial (factory spawn)
• Vehicles: Van + 11 destructible props (cannon, caravan, fridge, porta potty, piano, TV, couch, barrels, steel coil, pigeon)
• Traffic: Disabled
• Tasks: Destruction-themed exploration

ramplow - Ramp Truck

• Level: West Coast USA (highway spawn)
• Vehicle: US Semi with ramp trailer (t82_ramplow)
• Traffic: Enabled
• Tasks: Ramp truck driving

Mission Highlights

The drag strip race mission includes custom vehicle config: covet with 15gtz_turbo2_M.

How It Works

-- Module structure (loaded by gameplay_discover)
local D = {}
D.pageInfo = {
  title = "New Player Experience",
  sections = { ... },
  order = 0,
}
D.experiences = arrayConcat(freeroamExperiences, missions)
return D

Each experience's trigger function follows the standard pattern:

1. Configure traffic/spawning options via freeroam_freeroam
2. Start freeroam with startFreeroamByName
3. Spawn vehicles at predefined positions
4. Apply vehicle setup commands (off-road configs)
5. Set task list via guihooks.trigger
6. Call M.clearTasksOnClientEndMission() and M.basicControlsIntroPopup()

Key Behaviors

• The leisurely drive delays traffic activation until the player moves away from spawn
• Johnson Valley vehicles use util_stepHandler to wait for vehicle readiness before applying drivetrain setup
• Track day sets custom environment (time of day, fog density)
• Prop destruction spawns 12 vehicles total (1 driveable + 11 props)
• The ramp truck experience is the only NPE freeroam with traffic enabled
• All freeroam experiences set game state to "freeroam", "discover"

See Also

• discover/discover_037 - 0.37 Discover Experiences - Related reference
• discover/discover_038 - 0.38 Discover Experiences - Related reference
• Gameplay Systems Guide - Guide