Assembla Instructions

Assembla instructions

How to Setup Assembla's Perforce repo on your machine
=============================================

1. Install the P4V client.
_During setup, there'll be a wizard to help you connect. Feel free to go through it, but it probably won't work, due to some special configurations Assembla requires._
1. Create a file named `p4config.txt` somewhere on your computer (preferably somewhere you have write access)
1. Copy this into it (replace `[username]` with your Assembla username):
```
P4PORT=perforce.assembla.com:1666 
P4HOST=beings-of-light.tribal-phase 
P4USER=[username]
P4CHARSET=utf8 
P4CLIENT=Tribal_Phase 
```
1. Run this command on the prompt, replace `[path]` with the full path to the `p4config.txt` file:
`p4 set P4CONFIG=[path]`
_**Note:** If the path has spaces in it, wrap it with double quotes_

How to get the code (first time)
------------------------

1. Open P4V.
1. On the "Open Connection" window, make sure it has `perforce.assembla.com:1666` in the "Server" field and your Assembla username in the "User" field.
2. Near the "Workspace" field, click "New..."
	1. Enter your password, if necessary.
	1. Leave "Workspace" name with the default value
	2. On "Workspace Root", click "Browse..." and select the root folder for the project
	3. On "Stream", click "Browse..."
		1. Select "Mainline" (it should be the only one).
		2. Click "OK"
	3. Click "OK"
4. Click "OK"
1. On the P4V window, at the "Workspace" panel (singular, in case you're seeing a "Workspaces" panel as well), right-click on the root folder (it should be the path you selected earlier) and then "Get latest revision"
2. Wait for it to download everything.

Notes
-

* If you're going to edit anything outside the UE Editor, you have to check out the file first. To that, right-click the file in P4V (in the Workspace panel from before) and then "Check out..." and click "OK" in the next window.
* If you're going to edit files in Visual Studio, I recommend you install a P4 plugin, so you don't have to manually check files out.
* Before you build, you need to check out the Intermediate folder. This is a temporary condition that we're trying to solve.
* Remember: when a file is checked out, no one else can edit it. So submit your changes as soon as you're done.