From 9d5ff616bca2a68b0b10f08b8ca542203b47f2f3 Mon Sep 17 00:00:00 2001 From: Latch Date: Thu, 2 Apr 2026 12:49:15 -0500 Subject: [PATCH 1/2] Additional steps and common issues addressed Many people were expecting to be able to move around at the end of the getting started. Added the proper steps to allow that and covered the common issue of the joystick input not working. --- docs/getting-started/quick-start.md | 32 +++++++++++++++++++++++++++-- 1 file changed, 30 insertions(+), 2 deletions(-) diff --git a/docs/getting-started/quick-start.md b/docs/getting-started/quick-start.md index ecdf78a..a8709a8 100644 --- a/docs/getting-started/quick-start.md +++ b/docs/getting-started/quick-start.md @@ -26,6 +26,7 @@ Go to **GameObject -> PlayStation 1 -> Scene Exporter**. This adds a GameObject 1. Import a subdivided floor mesh from your 3D tool 2. Assign a material with a texture 3. Add the `PSXObjectExporter` component to it +4. In the component set Collision>Type to Static !!! danger "Texture Requirements" All textures **must be power-of-two in both width and height**, and the maximum size is **256x256**. Valid sizes: 16x16, 32x32, 64x64, 128x128, 256x256 (and non-square like 64x128). SplashEdit does NOT check this for you - incorrect textures will produce broken results. @@ -38,13 +39,20 @@ Go to **GameObject -> PlayStation 1 -> Scene Exporter**. This adds a GameObject The player is invisible at runtime - it represents the camera and controller. -## 7. Add the Scene to the Build +## 7. Add the Nav Region + +1. Open the PlayStation 1 > Nav Region Builder +2. Click **Build Nav Regions** + +Note: Closing the Nav Region Builder window will hide the visual but it's still there + +## 8. Add the Scene to the Build 1. Open the Control Panel (++ctrl+shift+l++) 2. Go to the **Scenes** tab 3. Click **"+ Add Current Scene"** -## 8. Build and Run +## 9. Build and Run 1. Go to the **Build** tab 2. Set Target to **Emulator** @@ -52,6 +60,10 @@ The player is invisible at runtime - it represents the camera and controller. SplashEdit exports the scene, compiles the PS1 executable, and launches PCSX-Redux. You should see your textured floor with camera controls. +## 10. Enjoy + +You should now be able to walk around. Left joystick for movement and right joystick for camera controls. If you aren't getting proper input. See the trouble shooting section below. + ## What Just Happened? Behind the scenes, SplashEdit: @@ -70,3 +82,19 @@ Behind the scenes, SplashEdit: - [Write Lua scripts](../lua/index.md) for game logic - [Add interactables](../components/interactables.md) the player can interact with - Check out the [tutorials](../tutorials/index.md) for complete game mechanics + + +## Trouble Shooting + +Problem: +The game runs but I can't move around with the Joysticks. Inputs don't work / are wrong + +Solution 1: + +When your game launches there should be some tabs at the top. If you don't see them press ESC to bring them up. Then go to +Configuration > Controls +Make sure "Controller Type" is analog and "Analog Mode" is checked. Also if you are using an original controller you may have to physically click the "ANALOG" button between the joysticks to get proper input. + +Solution 2: + +If that still doesn't work review steps 5, 6, and 7 for a step that was missed. \ No newline at end of file From e7d9dc4a7b2965a6199f1c64c8773aeb04340cb4 Mon Sep 17 00:00:00 2001 From: Latch Date: Thu, 2 Apr 2026 16:23:09 -0500 Subject: [PATCH 2/2] Removed Unrequired Nav Region --- docs/getting-started/quick-start.md | 17 +++++------------ 1 file changed, 5 insertions(+), 12 deletions(-) diff --git a/docs/getting-started/quick-start.md b/docs/getting-started/quick-start.md index a8709a8..a328713 100644 --- a/docs/getting-started/quick-start.md +++ b/docs/getting-started/quick-start.md @@ -39,20 +39,13 @@ Go to **GameObject -> PlayStation 1 -> Scene Exporter**. This adds a GameObject The player is invisible at runtime - it represents the camera and controller. -## 7. Add the Nav Region - -1. Open the PlayStation 1 > Nav Region Builder -2. Click **Build Nav Regions** - -Note: Closing the Nav Region Builder window will hide the visual but it's still there - -## 8. Add the Scene to the Build +## 7. Add the Scene to the Build 1. Open the Control Panel (++ctrl+shift+l++) 2. Go to the **Scenes** tab 3. Click **"+ Add Current Scene"** -## 9. Build and Run +## 8. Build and Run 1. Go to the **Build** tab 2. Set Target to **Emulator** @@ -60,7 +53,7 @@ Note: Closing the Nav Region Builder window will hide the visual but it's still SplashEdit exports the scene, compiles the PS1 executable, and launches PCSX-Redux. You should see your textured floor with camera controls. -## 10. Enjoy +## 9. Enjoy You should now be able to walk around. Left joystick for movement and right joystick for camera controls. If you aren't getting proper input. See the trouble shooting section below. @@ -87,7 +80,7 @@ Behind the scenes, SplashEdit: ## Trouble Shooting Problem: -The game runs but I can't move around with the Joysticks. Inputs don't work / are wrong +The game runs but I can't move around with the Joysticks. Inputs don't work / are wrong. Solution 1: @@ -97,4 +90,4 @@ Make sure "Controller Type" is analog and "Analog Mode" is checked. Also if you Solution 2: -If that still doesn't work review steps 5, 6, and 7 for a step that was missed. \ No newline at end of file +If that still doesn't work review steps 5 and 6 for a step that was missed. \ No newline at end of file