Troubleshooting

No F1 Cars Found

Problem: "No F1 cars with players found!" notification

Solutions:

• Verify F1 car models are correctly listed in F1Config.F1_MODELS

• Ensure players are actually in F1 vehicles

• Check that vehicle models match exactly (case-sensitive)

• Wait for the scan cycle (default: 1 second intervals)

Camera Not Following Driver

Problem: Camera doesn't switch when changing targets

Solutions:

• The script uses first-person spectate mode by default

• Ensure the target player hasn't left their vehicle

• Try switching to a different driver

• Exit and re-enter spectate mode

Static Cameras Not Working

Problem: "No static camera positions configured" notification

Solutions:

• Add F1Config.STATIC_CAMERAS table to your config.lua

• Ensure coordinates are valid vector4 values

• Check that cameras are placed in accessible locations

• Verify syntax (commas, brackets) in configuration

Interaction Point Not Appearing

Problem: Can't find the activation marker

Solutions:

• Verify F1Config.INTERACTION.POINT coordinates are correct

• Check DRAW_DISTANCE is high enough

• If using ox_target, ensure the resource is started

• Try switching MODE between 'marker' and 'ox'

• Check marker color isn't transparent (alpha > 0)

UI Not Visible

Problem: Can't see the spectate interface

Solutions:

• Press F9 to toggle UI visibility

• Check F1Config.UI.SHOW_OVERLAY = true

• Verify BACKGROUND_ALPHA isn't set to 0

• Ensure you're actually in spectate mode

Poor Performance

Problem: Lag or stuttering during spectate

Solutions:

• Reduce MAX_RENDER_DISTANCE in performance settings

• Increase update intervals in UPDATE_RATES

• Set FORCE_HIGH_LOD = false if experiencing issues

• Check server performance and player count

Mouse Look Not Working

Problem: Can't look around in static camera

Solutions:

• Ensure you're in Static Camera mode (not Driver Spectate)

• Check that no other scripts are blocking mouse input

• Verify camera exists (should show "Static Camera: ON" notification)

• Try switching cameras with Left/Right arrows