update docs

Author: greggman

docs/unity/3d-characters.md

@@ -1,6 +1,16 @@
 Title: 3d Characters
 Description: How to control 3D characters with HappyFunTimes
 
+I wanted to include a 3D game but I don't own any 3D assets
+and it seemed improper to include Unity's Standard Assets
+so, here are the instructions to create a 3D example
+from scratch. I'm only guessing it will take around 20-30 minutes
+(5 minutes if you've already done it once).
+
+It will hopefully also be a good tutorial on how to take
+something that's already designed to work with controllers
+and make it work with HappyFunTimes
+
 Follow these steps
 
 * Make a new project
@@ -54,14 +64,20 @@ Follow these steps
   The steps are
 
      1.  rename it `ThirdPersonUserControllerHFT`
-     2.  add a `private HFTInput m_hftInput;`
-     3.  In `Start` set `m_hftInput = GetComponent<HFTInput>();`;
-     4.  In `Update` check for `m_hftInput.GetButtonDown("fire1");`
-     5.  In `FixedUpdate` add in `+ m_hftInput.GetAxis("Horizontal")` and
+     2.  add a `private HFTInput m_hftInput;` and `private HFTGamepad m_gamepad;`
+     3.  In `Start` set `m_hftInput = GetComponent<HFTInput>();` and `m_gamepad = GetComponent<HTFGamepad>();`.
+     4.  Add `m_gamepad.OnDisconnect += Remove`;
+     5.  Add a `Remove` method that calls `Destroy`.
+     6.  In `Update` check for `m_hftInput.GetButtonDown("fire1");`
+     7.  In `FixedUpdate` add in `+ m_hftInput.GetAxis("Horizontal")` and
          `- m_hftInput.GetAxis("Vertical")`
-     6.  Also add `m_hftInput.GetButton("fire2")` to the crouch check
+     8.  Also add `m_hftInput.GetButton("fire2")` to the crouch check
+
+  <img width="696" height="342" src="images/3d-011-edit-script.gif" />
 
-  <img width="643" height="353" src="images/3d-011-edit-script.gif" />
+  <a href="assets/3d-step1-diff.html" target="_blank">Here's a diff of the changes (click here for a new tab)</a>.
+
+  <iframe src="assets/3d-step1-diff.html" width="900" height="500"></iframe>
 
 * Select the prefab again
 
@@ -90,5 +106,57 @@ Follow these steps
 
 Hopefully that shows how simple it is to get started.
 
+## Colors and Names
+
+Let's had a little more code to show names and colors.
+
+<a href="assets/3d-step2-diff.html">Here are the changes to the script (click here for a new tab)</a>.
+
+<iframe src="assets/3d-step2-diff.html" width="900" height="500"></iframe>
+
+We added a `nameTransform` Transform public field. We need to set that to a transform **inside the prefab**
+so we'll follow these steps
+
+1.  Drag the `ThirdPersonController` prefab into the scene hierarchy
+2.  Create a GameObject.
+3.  Drag the GameObject under the root of the prefab
+4.  Rename it to `name` (or anything)
+5.  Move it above the character's head
+6.  Drag it to the `Name Transform` field of our `ThirdPersonUserControlHFT` script.
+7.  From the menus pick `GameObject->Apply Changes to Prefab`
+8.  Delete the prefab from the scene
+
+Here's a silent video of the steps
+
+<iframe width="853" height="480" src="https://www.youtube.com/embed/Sp2-vWM14_M" frameborder="0" allowfullscreen></iframe>
+
+Now run it. There should be a "name" box showing the players name in a color matching
+the player's controller.
+
+<img width="637" height="389" src="images/3d-120-run.gif" />
+
+**NOTE**, this way of showing names is **not** the recommended Unity way. The point of this example
+is to show how to use HappyFunTimes to set colors and read names, **not how to use Unity**.
+To display names the Unity way please [search for examples](https://www.google.com/search?q=displaying+a+name+above+a+character+unity).
+
+Similarly in the example above all players spawn at the same place and if they fall over the edge
+of the world they fall forever. [Spawning at random locations](https://www.google.com/search?q=unity+spawn+at+random+location)
+and [dying or resetting if the player falls off the world](https://www.google.com/search?q=reset+when+player+falls+of+world+unity)
+are standard Unity game development issues and have nothing to do with HappyFuntTimes.
+While I want to be helpful I can't teach you Unity. I can only teach you HappyFunTimes. For Unity issues
+please use the [Unity Forums](https://forum.unity3d.com/) and/or [Unity Answers](http://answers.unity3d.com/).
+Also see the samples.
+
+The Simple and Clean examples in `Assets/HappyFunTimes/MoreSamples` spawn players at random locations given a globally defined area.
+For Spawn points you can apply ideas from the example above. On the LevelManager (or some global object)
+you make an array of `Transform`s. `public Transform[] spawnPoints;`
+You then make a bunch of GameObjects, as many as you want, one for each spawn point and add them to the list
+of spawn points Unity just like we added the `name` GameObject to the `nameTransform` above. When player
+is added, then either in their `Start` or `InitNetPlayer` functions (if you're not using the HFTGamepad)
+you'd find that list and either pick one of the spawn points at random or pick the next one or whaever fits
+your game. Again, these are Unity game development issues not HappyFunTimes issues. I hope that doesn't
+come across as harsh but I also hope you see my point.
+
+