Smooth Navigation

ClaudusBridge provides smooth, professional camera navigation for AI clients. The AI never teleports — all movement is fluid, like a human user operating the editor.

---

Why Smooth Navigation Matters

• Professional workflows — Engineering firms use this for architectural review
• Visual continuity — Teleporting breaks spatial awareness
• User experience — Watching the AI navigate smoothly builds trust
• Inspection quality — Smooth orbiting reveals details that teleporting misses

---

Navigation Tools

ai_navigate

Primary navigation tool with multiple modes:

Mode	Description	Key Params
absolute	Move to world coordinates	x, y, z, yaw, pitch
relative	Move relative to current position	forward, right, up
look_at_actor	Face a named actor	actor_name

# Move forward 500 units smoothly
curl -X POST http://localhost:3000/mcp \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
    "name":"ai_navigate","arguments":{"forward":500,"speed":1.0}}}'

move_camera

WASD-style relative movement — the most intuitive way to navigate:

# Move forward and slightly right
curl -X POST http://localhost:3000/mcp \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
    "name":"move_camera","arguments":{"forward":300,"right":100}}}'

orbit_camera

Orbit around a target point or actor:

# Orbit around coordinates
curl -X POST http://localhost:3000/mcp \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
    "name":"orbit_camera","arguments":{"target_x":0,"target_y":0,"target_z":100,"angle":45}}}'

focus_viewport_on_actor

Center the camera on a specific actor:

curl -X POST http://localhost:3000/mcp \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
    "name":"focus_viewport_on_actor","arguments":{"actor_name":"SM_House_01"}}}'

---

Navigation Protocol

The recommended workflow for AI navigation:

1. ai_perceive          -> Know where you are
2. ai_navigate/move     -> Move smoothly to destination
3. ai_perceive          -> Verify arrival
4. ai_vision_full       -> Capture visual for inspection
5. Read the image       -> Actually look at what you captured
6. Decide next move     -> Based on what you see

---

Construction Inspection Pattern

When building objects, use orbital navigation to inspect from multiple angles:

1. Place object
2. focus_viewport_on_actor -> Center on the new object
3. orbit_camera (0 deg)    -> Front view, capture
4. orbit_camera (90 deg)   -> Right side view, capture
5. orbit_camera (180 deg)  -> Back view, capture
6. orbit_camera (270 deg)  -> Left side view, capture
7. Evaluate all captures   -> Decide if corrections needed

---

Tips

• Never use absolute coordinates for large jumps — break them into smooth steps
• Use focus_viewport_on_actor before orbiting — ensures you're centered on the target
• Combine with perception — always perceive after moving to update spatial awareness
• Speed parameter — use lower speeds for precision work, higher for long-distance travel