One Click Solution#

If you want to use a cloud provider with a one click solution there is one for digital ocean. I haven’t used the one click solution so let me know how it works for you

• Digital Ocean One Click

In my opinion, Digital Ocean is the cheaper and easier to use option. They actually include instructions. You can sign up for Digital Ocean with this link and can host it for as little as $4/mo(6 with backups which I recommend)

Local Install#

Run the Helix Core installer. When prompted, set your P4Port to localhost:1666 and your Perforce Root to the directory where you want your data to be stored at.

The installation should be quick, once that’s done you can install the p4v software. When installation, make sure you check off that you want the p4v command., p4 merge and p4 admin.

Setup#

You will now have 3 new programs on your computer. The ones we will use mainly is p4v which is the perforce visual client. It’s similar to Gitkraken or Github Desktop for git. The second program is p4admin which is what we will use for setting up our Depot.

1. Create a new Depot. File -> New -> Depot and enter name. My game is Edgemaul Legends, I named my depot edgemaul-legends
2. Open P4V(program installed on your computer from the second installer)
3. Create a new mainline stream. Click View on the toolbar -> Stream Graph. Once there right click inside of that window that popped up and click New Stream. On the Stream Type dropdown, select Mainline. I named my main stream, main. It can be whatever you want it to be
4. The client will ask you to put files inside the stream now or do it later. I usually opt to do it now. Here you can just drag and drop your projects files inside of the upload menu. Be mindful to skip the Intermediate, Saved and Binaries directory for your project as well as any project level plugins you may be uploading
5. Once this is done, you’re ready to use Perforce! Open your project in Unreal Engine. I’m using Ue5 so I’ll describe those steps. In the bottom right, hit Source Control -> In the dropdown click Perforce -> for the workspace click the dropdown and select the one option -> hit okay. Unreal engine should now be handling checking in and out assets for you

Workflow#

Here is a quick look at my workflow. Let’s assume I’m working on version 0.1 of my game and I’m implementing the baseline for my loot system. I would do this for my streams

main
└───dev_0.1
      └───task_0.1-loot_system
      └───task_0.1-some_other_task

We have the base of our depot, main, our dev branch which I make one for each version, dev_0.1 and then the tasks for each dev branch which I use task_0.1-feature. Mind you, this is my way. Its not the only way nor am I saying this is the correct way. This just works for me. I opt for this way since it allows me to make bitesized features that I can iterate on with tests and validating builds frequently

One thing to note, if you are working with multiple people. Perforce will lock any file you’re working on so there are no merge conflicts in other branches. For whatever system you come up with, you want to be mindful of this. For example, I may not want to try to have 2 people work on the inventory system as they may step over each others toes and create messy conflicts

Bonus#

I would consider applying these bonus features. I use the typemaps feature to tell Perforce how to handle my files when I upload as well as how many revisions to keep. I set the revisions to 3 just so I won’t keep a mass amount of files on my server. If storage cost isn’t an issue, I would consider keeping all revisions

	binary+w //....exe
	binary+w //....dll
	binary+w //....lib
	binary+w //....app
	binary+w //....dylib
	binary+w //....stub
	binary+w //....ipa
	binary //....bmp
	text //....ini
	text //....config
	text //....cpp
	text //....h
	text //....c
	text //....cs
	text //....m
	text //....mm
	text //....py
	binary+lS3 //....uasset
	binary+lS3 //....umap
	binary+lS3 //....upk
	binary+lS3 //....udk
	binary+lS3 //....ubulk

Saved/
LocalBuilds/
*.csproj.*
.vs/*
*.pdb
*.suo
*.opensdf
*.sdf
*.tmp
*.mdb
obj/
*.vcxproj
*.sln
*-Debug.*
FileOpenOrder/
*.xcworkspace
*.xcodeproj
./Makefile
./CMakeLists.txt
.ue4dependencies
Samples/*
FeaturePacks/*
Engine/Documentation/*

# Engine intermediates
Engine/Intermediate/*
Intermediate/

# Intermediate folders for programs should not be checked in
Engine\Programs\*\Intermediate\*

# Intermediate folders created for various C# programs
Engine\Source\Programs\*\obj\*

# Saved folders for programs should not be checked in
Engine\Programs\*\Saved\*
Engine\Programs\UnrealBuildTool\*

# Derived data cache should never be checked in
Engine/DerivedDataCache/*

# Ignore any build receipts
Engine/Build/Receipts/*

# Ignore personal workspace vars
p4config.txt

# Ignore Unix backup files
*~

# Ignore Mac desktop services store files
.DS_Store

# Ignore crash reports
crashinfo--*

# Ignore linux project files
*.user
*.pro
*.pri
*.kdev4

# Obj-C/Swift specific
*.hmap
*.ipa
*.dSYM.zip
*.dSYM

# Ignore documentation generated for C# tools
Engine/Binaries/DotNET/UnrealBuildTool.xml
Engine/Binaries/DotNET/AutomationScripts/BuildGraph.Automation.xml

# Ignore version files in the Engine/Binaries directory created by UBT
/Engine/Binaries/**/*.version

# Ignore exp files in the the Engine/Binaries directory as they aren't C/C++ source files
/Engine/Binaries/**/*.exp

# Ignore Swarm local save files
Engine/Binaries/DotNET/SwarmAgent.DeveloperOptions.xml
Engine/Binaries/DotNET/SwarmAgent.Options.xml

# Intermediary Files
*.target.xml
*.exe.config
*.exe.manifest

# Ignore project-specific files
*/Build/Receipts/*
*/DerivedDataCache/*
*/Binaries/*
*/Intermediate/*

# idea
# Default ignored files
/shelf/
/workspace.xml

# vs code

/.vs/
.vs/
.vs/*

*/.name/*
/.name