Skip to main content
Customize your Gitlantis experience by changing your boat’s colors and adjusting its movement physics to match your preferences.

​
Changing Boat Colors

Your boat has six customizable color zones that you can personalize.
1

Access Color Settings

Open the Gitlantis settings to access boat customization options. You can modify colors for different parts of your boat.
2

Customize Each Boat Part

The boat has six distinct parts you can color:
  • Walls (boat_body): The main cabin walls
  • Floaters (boat_buffer): The side bumpers/buffers
  • Roof (boat_roof_accessory): The cabin roof and accessories
  • Hull (PaletteMaterial001): The bottom of the boat
  • Body (PaletteMaterial004): Additional body elements
  • Rails (PaletteMaterial003): The railings around the boat
Each part accepts standard color values (hex, RGB, or color names). See src/browser/hooks/useBoat/colors/index.ts:11-16.
3

Understand Material Properties

Different boat parts have different material finishes:
  • Walls, Roof, Hull: Roughness 0.8, Metalness 0.8 (matte metallic)
  • Floaters: Roughness 0.4, Metalness 0.4 (semi-glossy)
  • Body and Rails: Use the base material properties
These properties affect how light reflects off each surface. See src/browser/hooks/useBoat/colors/index.ts:19-52.

​
Adjusting Boat Speed

Control how fast your boat moves through the water.
1

Set Maximum Speed

Adjust the boatSpeed setting to control your boat’s top speed:
  • Higher values make the boat move faster
  • Lower values provide more precise control for detailed navigation
  • The boat reaches maximum speed gradually due to acceleration
Backward movement is always 50% of forward speed. See src/browser/hooks/useBoat/navigation/index.tsx:76-80.
2

Adjust Acceleration

Control how quickly your boat reaches maximum speed:
  • Acceleration: How fast the boat speeds up when you press movement keys
  • Deceleration: How fast the boat slows down when you release keys
Higher acceleration values make the boat feel more responsive, while lower values create a heavier, more realistic feel. See src/browser/hooks/useBoat/navigation/index.tsx:25-27.

​
Modifying Physics

Fine-tune the boat’s movement and floating behavior.
1

Adjust Turning Physics

Control how your boat turns:
  • Turn Speed: How quickly the boat rotates when turning
  • Turn Deceleration: How quickly the boat stops rotating
When stationary, turning works normally. When moving, the turning direction reverses automatically when in reverse. See src/browser/hooks/useBoat/navigation/index.tsx:112-132.
2

Configure Rocking Motion

Adjust how the boat rocks side to side when moving:
  • Rocking Amplitude: How far the boat tilts (rotation amount)
  • Rocking Speed: How fast the rocking motion oscillates
Rocking is more pronounced when the boat is stationary and decreases as speed increases. See src/browser/hooks/useBoat/navigation/index.tsx:56-59.
3

Configure Bobbing Motion

Adjust the up-and-down bobbing movement:
  • Bobbing Amplitude: How high and low the boat moves vertically
  • Bobbing Speed: How fast the bobbing motion cycles
Like rocking, bobbing is more visible when stationary and less noticeable at higher speeds. See src/browser/hooks/useBoat/navigation/index.tsx:61-64.
4

Understand Floating Behavior

When completely stationary (no keys pressed and no motion), your boat floats naturally:
  • Wave Height: 0.4 units (configurable)
  • Wave Speed: 0.7 multiplier (configurable)
  • Roughness: 0.1 for choppy wave effect
  • Multiple Wave Layers: Primary, secondary, and chop waves combine
  • Position-Based Waves: Waves vary based on boat location
  • Realistic Tilting: Boat tilts forward/backward and side to side
The floating motion immediately stops when any movement key is pressed or motion is detected. See src/browser/hooks/useBoat/floating/index.tsx:13-19 and src/browser/hooks/useBoat/floating/index.tsx:34-62.

​
Advanced Physics Details

The boat tracks its “intended direction” for proper turning behavior:
  • When moving forward, left/right turns work normally
  • When moving backward, turning directions reverse automatically
  • When coasting (no input), the boat preserves its movement direction
  • Direction only resets to neutral when completely stopped
This creates realistic boat steering where left always turns the bow left, regardless of direction. See src/browser/hooks/useBoat/navigation/index.tsx:83-99.
Movement calculations use delta time with a multiplier:
const deltaMultiplier = Math.min(delta * 60, 2);
This ensures consistent movement speeds across different frame rates, capped at 2x to prevent extreme jumps during lag. See src/browser/hooks/useBoat/navigation/index.tsx:48.
Floating effects decrease as speed increases:
const movementFactor = 1 - Math.min(Math.abs(state.current.speed) / config.maxSpeed, 1);
At maximum speed, movementFactor is 0 (no floating). At rest, it’s 1 (full floating effect). See src/browser/hooks/useBoat/navigation/index.tsx:51-52.

​
Tips for Customization

  • Start with speed: Adjust boat speed first to find a comfortable navigation pace
  • Fine-tune acceleration: If the boat feels sluggish or too twitchy, adjust acceleration/deceleration
  • Reduce floating effects: If the motion makes you uncomfortable, lower amplitude values
  • Increase turn speed: For quick navigation in tight folder structures
  • Match your style: Fast speed + high acceleration for quick exploration, or slow speed + low acceleration for careful browsing

Build docs developers (and LLMs) love

Get started for freeTalk to us