Skip to main content
Behavior settings control how your boat moves, floats, and interacts with the environment. Adjust these to create your ideal navigation experience. Control the boat’s movement characteristics including speed, acceleration, and turning.

​
Speed and Acceleration

​
boatSpeed
number
The boat’s maximum top speed.Range: 1 to 10
  • Lower values: Slower, more controlled navigation
  • Higher values: Faster exploration of large directories
​
acceleration
number
How quickly the boat speeds up when moving forward or backward.Range: 0.001 to 1.0
  • Lower values: Gradual, smooth acceleration
  • Higher values: Quick, responsive speed-up
​
deceleration
number
How quickly the boat slows down when no input is provided.Range: 0.001 to 1.0
  • Lower values: Boat glides longer, momentum preserved
  • Higher values: Quick stops, more precise control
For precise navigation in complex directory structures, use lower speed (2-3) with higher deceleration (0.05+). For quick exploration of large codebases, increase speed (7-10) with moderate deceleration.

​
Turning

​
turnSpeed
number
How quickly the boat rotates when turning left or right.Range: 0.01 to 0.05
  • Lower values: Wider turning radius, more realistic
  • Higher values: Sharp turns, more responsive
​
turnDeceleration
number
How quickly the boat’s rotation slows down after turning input stops.Range: 0.01 to 0.1
  • Lower values: Boat continues turning longer
  • Higher values: Quick stop to rotation
Turn speed and turn deceleration work together. Higher turn deceleration helps prevent overshooting when using high turn speeds.

​
Floating

Adjust the boat’s rocking and bobbing animations for a more or less realistic water experience.

​
Rocking (Side-to-Side)

​
rockingAmplitude
number
The amount of side-to-side tilt the boat experiences.Range: 0.01 to 0.1
  • Lower values: Subtle, gentle rocking
  • Higher values: Dramatic tilting motion
​
rockingSpeed
number
The speed of the side-to-side rocking motion.Range: 0.1 to 1.0
  • Lower values: Slow, calm waters
  • Higher values: Quick, choppy waters

​
Bobbing (Up-and-Down)

​
bobbingAmplitude
number
The amount of vertical bounce the boat experiences.Range: 0.01 to 1.0
  • Lower values: Minimal vertical movement
  • Higher values: Pronounced bouncing
​
bobbingSpeed
number
The speed of the vertical bobbing motion.Range: 0.1 to 1.0
  • Lower values: Slow, gentle waves
  • Higher values: Fast, active waters
For a calm sailing experience, set both rocking and bobbing amplitudes to lower values (0.01-0.03). For stormy seas, increase amplitudes (0.05+) and speeds (0.7+).

​
Collision

Configure how the boat interacts with obstacles in the environment.
​
collisionRadius
number
default:100
The distance from the boat’s center at which collisions are detected.Range: 50 to 300
  • Lower values: Tighter collision detection, can get closer to objects
  • Higher values: Early collision detection, more buffer space
This is the impact radius within which the boat will collide with objects.
​
collisionPushStrength
number
default:5
The force applied when the boat collides with an object.Range: 1 to 10
  • Lower values: Gentle deflection on impact
  • Higher values: Strong bounce-back from obstacles
This is the deflection strength applied during collisions.
A larger collision radius with lower push strength creates a “soft bounce” effect. A smaller radius with higher push strength creates sharp, punchy collisions.

​
Configuration File Reference

All behavior settings are stored in the settings object: 
// src/extension/store/index.ts
export const DEFAULT_SETTINGS = {
  // Navigation
  boatSpeed: 3.0,
  acceleration: 0.02,
  deceleration: 0.01,
  turnSpeed: 0.02,
  turnDeceleration: 0.05,
  
  // Floating - Rocking
  rockingAmplitude: 0.03,
  rockingSpeed: 0.3,
  
  // Floating - Bobbing
  bobbingAmplitude: 0.2,
  bobbingSpeed: 0.6,
  
  // Collision
  collisionRadius: 100,
  collisionPushStrength: 5,
};

​
Best Practices

  1. Start with defaults - The default values provide a balanced experience
  2. Adjust incrementally - Make small changes and test before going extreme
  3. Match your workflow - Fast navigation for exploration, precise control for focused work
  4. Consider motion sensitivity - Lower floating values if the motion is distracting

Build docs developers (and LLMs) love

Get started for freeTalk to us