Merge branch 'dev' of https://github.com/xen-42/outer-wilds-new-horizons into dev

.gitignore

@@ -417,3 +417,4 @@ docs/.m_cache/**
 # Unity project
 new-horizons-unity
 new-horizons-unity/**
+docs/.env

NewHorizons/Utility/AstroObjectLocator.cs

@@ -131,7 +131,10 @@ namespace NewHorizons.Utility
                 case AstroObject.Name.CustomString:
                     if (primary._customName.Equals("Sun Station"))
                     {
-                        otherChildren.Add(GameObject.Find("SS_Debris_Body"));
+                        // there are multiple debris with the same name
+                        otherChildren.AddRange(Object.FindObjectsOfType<AstroObject>()
+                            .Select(x => x.gameObject)
+                            .Where(x => x.name == "SS_Debris_Body"));
                     }
                     break;
                 default:

docs/content/pages/home.md

@@ -14,7 +14,8 @@ This is the official documentation for [New Horizons](https://github.com/xen-42/
 
 Before starting, go into your in-game mod settings for New Horizons and switch Debug mode on. This allows you to:
 
-- Print the position of what you are looking at to the logs by pressing "P". This is useful for determining locations to place details.
+- Use the Prop Placer tool. This convienence tool allows you to place details in game and save your work to your config files.
+- Print the position of what you are looking at to the logs by pressing "P". This is useful for determining locations to place props the Prop Placer is unable to, such as signal scope points or dialogue triggers.
 - Use the "Reload Configs" button in the pause menu. This will restart the current solar system and update all the planets. Much faster than quitting and relaunching the game.
 
 !!! alert-danger "Get VSCode"

docs/content/pages/tutorials/details.md

@@ -3,7 +3,7 @@ Title: Detailing
 Sort_Priority: 90
 ---
 
-## Details/Scatterer
+# Details/Scatterer
 
 For physical objects there are currently two ways of setting them up: specify an asset bundle and path to load a custom asset you created, or specify the path to the item you want to copy from the game in the scene hierarchy. Use the [Unity Explorer](https://outerwildsmods.com/mods/unityexplorer){ target="_blank" } mod to find an object you want to copy onto your new body. Some objects work better than others for this. Good luck. Some pointers:
 
@@ -11,6 +11,49 @@ For physical objects there are currently two ways of setting them up: specify an
 - Do not use the search functionality on Scene Explorer, it is really, really slow. Use the "Object Search" tab instead.
 - Generally you can find planets by writing their name with no spaces/punctuation followed by "_Body".
 
+## Using the Prop Placer
+
+The Prop Placer is a convenience tool that lets you manually place details from inside the game. Once enabled, press "G" and your currently selected prop will be placed wherever your crosshair is pointing.
+
+### Enabling
+
+1. Pause the game. You will see an extra menu option titled "Toggle Prop Placer Menu". Click it
+2. The prop placer menu should now be open. At the bottom of the menu, you will see a list of mods. Click yours.
+   1. This menu scrolls. If you do not see your mod, it may be further down the list.
+3. The Prop Placer is now active! Unpause the game and you can now place Nomai vases using "G"
+
+### How to Save
+
+1. In the Prop Placer Menu, you will see a greyed out button titled "Update your mod's configs".
+2. Click the small button to the left of it.
+3. Click "Update your mod's configs" to save!
+
+!!! alert-danger "IMPORTANT"
+    Your updated configs will save *only* to your mod's build folder, eg "AppData\Roaming\OuterWildsModManager\OWML\Mods\you.yourModName"
+
+!!! alert-warning "WARNING"
+    Dying in-game will cause you to lose all work since you last saved. Make sure to save often.
+
+What's that? You want to place something other than just vases? Well I can't say I agree with your choices, but here's how you would do that.
+
+### How to Select Props
+
+1. Pause the game again. The prop placer menu should still be visible.
+2. At the top of the menu, you'll see a text box contianing the path for the vase. Replace this with the path for the prop you want to place. For example: `DreamWorld_Body/Sector_DreamWorld/Sector_DreamZone_1/Props_DreamZone_1/OtherComponentsGroup/Trees_Z1/DreamHouseIsland/Tree_DW_M_Var`
+3. Tip: use the Unity Explorer mod to find the path for the object you want to place. You only have to do this once.
+4. Unpause the game and press "G". Say hello to your new tree!
+5. Pause the game again. You will now see the prop you just placed on the list of recently placed props just below the "path" text box.
+6. Click on the button titled "Prefab_NOM_VaseThin". You can now place vases again.
+
+### Extra features
+
+1. Made a mistake? **Press the "-" key to undo.** Press the "+" key to redo.  
+2. If you have the Unity Explorer mod enabled, you can use this to tweak the position, rotation, and scale of your props. Your changes will be saved.  
+3. Want to save some recently placed props between game launches? On the recently placed props list, click the star next to the prop's name to favorite it.  
+4. Found a bug that ruined your configs? Check `AppData\Roaming\OuterWildsModManager\OWML\Mods\xen.NewHorizons\configBackups` for backup saves of your work. Folders are titled "\[date\]T\[time\]".  
+5. Want to add props to Ember Twin but don't feel like making a config file for it? We got you! Place that prop and the config file will be created automatically on your next save.  
+6. This even works for planets that were created by other mods!
+
 ## Asset Bundles
 
 Here is a template project: [Outer Wilds Unity Template](https://github.com/xen-42/outer-wilds-unity-template){ target="_blank" }