How to Create a //Lyra/XistGame Stream

Time to create a new Lyra game! We’ll call it XistGame. Call yours whatever you want.

Procedure Overview

You must have successfully created //Lyra/Xist.

• Create Stream: //Lyra/XistGame with Parent: //Lyra/Xist
• Create Workspace
• Populate Workspace with Parent Data
• Sync Stream

Summary of Result

• P4 Stream //Lyra/XistGame will contain a fresh New Game project
• P4 Workspace XistGame_$(P4USER) will be mapped to //Lyra/XistGame
  • Stored locally in D:/Dev/XistGame

Go work on your game!

Create Stream: //Lyra/XistGame

Set up Powershell variables & environment

$GameName = "XistGame"  # Set to your preference

$StreamName = $GameName  # make Stream: //Lyra/$StreamName
$WorkspaceName = $GameName  # make Workspace: D:/Dev/$WorkspaceName

# change P4USER if your P4 username != your Windows username
$env:P4USER = $env:UserName
$env:P4CLIENT = "${WorkspaceName}_${env:P4USER}"  # P4 server uses _$P4USER suffix

# Location where you want to store your local Workspace content
$WorkspaceDir = "D:/Dev/$WorkspaceName"

Create Stream: //Lyra/$StreamName

# Create $StreamName Stream with Parent //Lyra/Xist
p4 stream -t development -P //Lyra/Xist //Lyra/$StreamName

Create Workspace: XistGame_$(P4USER)

Must be in $WorkspaceDir current directory when running p4 workspace.

# make dir $WorkspaceDir if needed
if (!(Test-Path $WorkspaceDir)) {mkdir $WorkspaceDir}

# create workspace ($env:P4CLIENT) for Main stream
cd $WorkspaceDir  # set current directory = $WorkspaceDir for `p4 workspace`
p4 workspace -S //Lyra/$StreamName

Populate new stream with Parent files

# Populate from parent stream
p4 populate -S //Lyra/$StreamName -r

Sync Stream

# Sync newly populated files into local workspace
p4 sync

Work on your Game

Edit the files in your local workspace $WorkspaceDir.

When you make changes to your game that you want to keep, p4 add and p4 submit to copy them up to the P4 server //Lyra/XistGame stream.

You can use p4v as a GUI during your ordinary workflow. You don’t have to use the command-line once you have everything initially set up.