Troubleshoot Common Issues

Rider Can't Register Online

Symptoms: "Registration unavailable" or error when submitting

Common Causes:

• Registration deadline passed
• Classes full (capacity limits met)
• Event set to "Officiate Registration Only"
• Missing required fields (machine info, emergency contact)

Solutions:

1. Check event settings → "Online Registration" is enabled and deadline hasn't passed
2. Review class capacity limits—increase if needed
3. Ensure all required fields are present in registration form
4. Clear browser cache and try again
5. Try different browser (Chrome/Edge recommended)

Rider Not Showing in Check-In List

Symptoms: Rider says they registered but aren't in check-in

Common Causes:

• Registration incomplete (didn't submit, payment failed)
• Registered for wrong event
• Using wrong search term (name vs. number)

Solutions:

1. Search by number plate, first name, and last name separately
2. Check "All Registrations" view (not just "Checked In")
3. Ask rider to show confirmation email with registration ID
4. Manually add rider via "Officiate Registration" if needed

Number Plate Already Taken

Symptoms: "Number plate already in use" error

Solutions:

1. Check if another rider registered with that number
2. If duplicate is incorrect, edit that registration to change number
3. Rider must choose different number or contact other rider to resolve

Automated Timing Not Working (No Crossings)

Symptoms: Riders running but no crossings detected

Common Causes:

• Riders' phones location services not enabled or accuracy too low
• Track not properly configured (no timing zones)
• Riders not running the race with Adrenaline app

Solutions:

1. Verify track has finish line configured (TrackLang or manual setup)
2. Ask riders to check: Location services enabled, location permission granted to app, high accuracy mode on
3. Ensure riders opened app and "joined" the race (not just spectating)
4. Check cellular/internet connection—timing data needs to upload
5. Run ad-hoc test race to verify track timing zones work

AI Vision Not Detecting Riders

Symptoms: Camera feed visible but no detections

Common Causes:

• Camera angle too extreme or obscured view
• Poor lighting (too dark, backlit, glare)
• Camera not defined in TrackLang
• Low resolution or frame rate

Solutions:

1. Check camera angle: should be perpendicular, not more than 60° tilt
2. Improve lighting: avoid shooting into sun, add artificial lighting if needed
3. Verify camera defined in TrackLang with correct position, heading, tilt, FOV
4. Use minimum 1080p @ 30fps (4K @ 60fps preferred)
5. Clean camera lens—dust/dirt reduces detection accuracy
6. Ensure camera feed is connected to Adrenaline (check Race Control camera panel)

Stopwatch Timing: Crossings in Wrong Order

Symptoms: Rider 5 crossed before Rider 3, but recorded opposite

Solutions:

1. Use Crossing Order Editor to fix: swap crossings, adjust timestamps
2. Delete incorrect crossing and re-add with correct rider number
3. For future: use "Look Free" mode (Alt+Enter gate drop, Spacebar crossings in real-time)
4. Slow down—wait to see number before hitting Spacebar

Race Won't Start (Riders Can't Join)

Symptoms: Riders say race not showing in app

Solutions:

1. Check race status: must be "Staging" or "Live" (not "Scheduled" or "Complete")
2. Ensure riders registered for that specific race/class
3. Verify riders have internet connection to receive race updates
4. Try "Refresh" in app or restart app
5. Check event is published (not draft)

Can't Add Classes to Event

Symptoms: "Add Class" button missing or not working

Solutions:

1. Ensure you're in event editing mode (not viewing published event)
2. Check permissions: you must be event owner or have edit rights
3. Try creating from class template instead of manual class creation
4. Clear browser cache and refresh

Event Not Showing in Public Listing

Symptoms: Created event but no one can find it

Solutions:

1. Publish the event (draft events are private)
2. Set visibility to "Public" (not "Private" or "Unlisted")
3. Ensure event date is in the future (past events don't show in default listing)
4. Wait up to 5 minutes for cache to refresh

Can't Edit Published Event

Symptoms: Fields are read-only or greyed out

Solutions:

1. Click "Edit Event" button if viewing published version
2. Some fields locked after registration opens (e.g., class structure)—this is intentional
3. To make major changes: create new event and migrate registrations, or contact support

Ordering/Grouping Not Saving

Symptoms: Drag-and-drop changes revert after refresh

Solutions:

1. Wait for "Saving..." indicator to complete before leaving page
2. Check internet connection—changes saved to server
3. If using "Group Classes" or "Order Races," ensure you click "Apply" or "Save"
4. Try refreshing page and re-ordering—might be browser caching issue

TrackLang Errors: "No matching tracks detected"

Symptoms: Error when clicking "Run"

Solutions:

1. Ensure you have track trackname { ... } declaration
2. Check track key matches in feature locators (e.g., mx1@100 if track is track mx1)
3. Verify opening and closing braces match

TrackLang: "Circular reference" Error

Symptoms: Error like "Circular reference: turn1 → turn2 → turn1"

Solutions:

1. Feature A's location depends on Feature B, but Feature B depends on Feature A—infinite loop
2. Use absolute positioning (@100) for one of the features instead of relative (@featurekey+50)
3. Review feature location chain to find the loop

3D View Not Updating After Code Changes

Symptoms: Changed code but 3D view still shows old track

Solutions:

1. Click "Run" to rebuild the track—changes don't apply until you run
2. Check console for errors—failed builds don't update 3D view
3. Refresh browser if 3D view frozen

Can't Fork Public Track

Symptoms: "Fork" button missing or greyed out

Solutions:

1. Track must be marked "Public"—private tracks can't be forked by others
2. You must be logged in to fork
3. Can only fork minor versions (not build versions)

Profile URL Not Working (404 Error)

Symptoms: adrenaline.mx/racer/123/doe/john shows "Not Found"

Solutions:

1. Profile URL format: /racer/[number]/[last]/[first] - check spelling and number
2. Rider may have changed profile URL—search by name instead
3. Rider may have deleted account or set profile to private
4. Try searching from main rider directory instead of direct URL

Sponsor Logos Not Showing

Symptoms: Uploaded sponsors but they don't display

Solutions:

1. Sponsor display requires "Rated Account" subscription—check subscription status
2. Uploaded image must be valid format (PNG, JPG, SVG)
3. Image might be processing—wait a few minutes and refresh
4. Check image size: max 5MB per logo

Ratings Not Updating After Race

Symptoms: Finished race but Elo rating unchanged

Solutions:

1. Only sanctioned races affect ratings—check if event was sanctioned
2. Race must be marked "Complete" with final results published
3. Ratings update within 24 hours (not instant)
4. Must have raced against other rated riders (can't gain rating racing alone)

Can't Add Machine to Profile

Symptoms: Add machine form not saving

Solutions:

1. Fill all required fields: year, make, model, number plate
2. Number plate must be unique to your account (can't duplicate your own numbers)
3. Check internet connection
4. Try from profile management page instead of registration flow

Page Loading Slowly or Timing Out

Solutions:

1. Check internet connection speed
2. Clear browser cache: Ctrl+Shift+Delete → Clear cached files
3. Try different browser (Chrome/Edge recommended)
4. Disable browser extensions that might interfere (ad blockers, etc.)
5. If on mobile: close other apps to free memory

"Connection Lost" During Race

Symptoms: Race Control shows connection error

Solutions:

1. Check WiFi/cellular connection
2. Page will auto-reconnect when connection restored
3. Data is cached locally—crossings/results won't be lost
4. Refresh page if auto-reconnect fails
5. For critical races: use wired ethernet connection instead of WiFi

Changes Not Saving (Generic)

Symptoms: Made changes but they revert after refresh

Solutions:

1. Wait for "Saving..." indicator to complete
2. Check browser console for errors (F12)
3. Verify internet connection active
4. Clear browser cache and try again
5. Try incognito/private browsing mode to rule out extensions

Location Services Not Working in App

Solutions:

1. Check phone location services enabled (Settings → Location)
2. Grant Adrenaline location permission (Settings → Apps → Adrenaline → Permissions)
3. Enable "High Accuracy" mode (not battery saver)
4. Ensure phone has clear view of sky for best accuracy
5. Restart app and phone if issue persists

App Crashes During Race

Solutions:

1. Update to latest app version from app store
2. Close other apps to free memory
3. Restart phone before race
4. Ensure phone battery above 20% (low battery can cause instability)
5. Report crash to support with phone model and OS version

Can't See Live Results in App

Solutions:

1. Pull down to refresh results screen
2. Check internet connection (cellular or WiFi)
3. Ensure race is "Live" status (not "Scheduled" or "Complete")
4. Log out and back in to refresh session