First-Person Walking on Imported Ships

[MarkoBarthel]

Imported ships can optionally support first-person walking in singleplayer. Ship creators can define an entry point and add simple collision boxes for floors, walls, and consoles. Every time the player enters first-person mode, they return to the configured entry point, even if they walked away from it before switching to the exterior view.

Set up walking in the Ship Editor

1. Open your ship in Ship Setup and select FPS setup.
2. Place the FPS entry marker at foot level, on top of the intended floor. Set Entry yaw to choose which way the player faces.
3. Select + Collision box to add a floor. Use the wireframe preview to position, resize, and rotate the box. Add more boxes for walls and obstacles as needed.
4. Turn FPS walking on, select Save JSON, and start a new voyage to test the setup.

The entry needs a walkable floor and enough clearance for the player to stand. If the entry is blocked or has no walkable floor, the game keeps the current camera view and shows a message.

Configure boat.json directly

Add this optional section to your existing boat.json:

Positions and sizes are in ship-local centimeters, with X forward, Y starboard, and Z up. sizeCm is the full size of the box. In this example, the floor is 20 cm thick and its top is at Z = 100 cm, matching the entry height. You can add up to 64 collision boxes. Omit firstPerson or set "enabled": false to keep walking disabled.

The boxes move with the ship and block the player without applying physical forces to the vessel. In first-person mode, the ship uses LOD 0 and its 3D bridge instruments update normally.