1.0.1 ⭐

TikTok Live 1v1 Car Battle Stream Assistant System Details The CarBattle system is a 1v1 racing simulation script on the FiveM platform, designed to create fun and high engagement between streamers and viewers on TikTok Live. Viewers can type in the chat to register for the race and send gifts to trigger real-time effects on the racing vehicles.

1. Core Features

👥 TikTok Live Integration & Automated Queue Management

• Auto-Connection: Connects seamlessly to the TikTok live stream via API, reading chat comments and gift data in real-time.
• Chat Register: Viewers can type specific keywords (e.g., 1 or 01) in the chat to automatically join the racing queue.
• Winner-Stays: The winner of the current round stays on as the champion, building up a win streak, while the loser is eliminated so the next challenger in the queue can step up.

🗺️ Predefined Track System

• 7 Diverse Racing Tracks: Features 7 different tracks with varying paths and obstacles, including a standard circuit, city track, off-road (mountain dirt) track, ultra-long track, drag strip, motocross track, and a water-based boat race.
• 1v1 Spawn Points: Every track has perfectly configured starting points for exactly 2 vehicles to prevent overlapping or unfair advantages.
• Clear Checkpoint Markers: Each checkpoint location is predefined in detail to smoothly and stably guide the racers to the finish line.

🤖 Smart AI Racing Engine (Vehicles & Boats)

• Aggressive Racing Style: The AI controls the driver to race aggressively and fast, dodging obstacles and other cars without unnecessarily braking or stopping for red lights.
• Direct Re-routing: The moment a car hits a checkpoint, the system clears the AI's previous tasks, forcing a sharp turn toward the next checkpoint without any sluggishness or U-turns.
• Fair Vehicle Swap: Utilizes a "Shuffle Bag" randomizer system to ensure variety and fairness for both competitors.

2. Interactive Gift Effects

Livestream viewers can instantly send TikTok gifts to support their favorite racer or sabotage the opponent. Effects include:

• ⚡ Boost: Accelerates the vehicle with realistic nitrous fire particle effects shooting from the exhaust.
• 🚀 Mega Boost: Maximizes speed to completely overtake the opponent in a flash.
• 🐌 Slow Down: A debuff that forces the opponent's vehicle to drop to a crawl for a short duration.
• 🎲 Random Car: Randomly swaps the racer's car model mid-race for a fresh challenge.

3. Anti-Stuck & Auto-Rescue System

To resolve any AI driving hiccups, the system features a constant fail-safe mechanism:

• Stuck Detection: Automatically triggers if the car's speed remains at 0 for over 10 seconds, if it flips upside down, or if the engine is completely destroyed.
• Auto-Warp & Revive: If the driver falls out of the vehicle or dies, the system instantly revives them and warps them back into the driver's seat.
• Checkpoint Respawn: Temporarily hides the car, smoothly warps it back to the last passed checkpoint, repairs it to 100% health, and applies an initial forward speed boost so the race can continue without missing a beat.

4. UI & Visual Aids

• Smart Map & Radar: Displays checkpoints as cyan blips on the minimap, a yellow checkered flag at the finish line, and real-time red dots tracking the actual positions of the race cars.
• 3D Profile Above Cars: Displays the racers' TikTok profile pictures floating directly above their cars in real-time, alongside their current speed.
• Spectator Camera Control: An advanced camera control system for the streamer. Easily switch between Bird-Eye View, Champion Camera, Challenger Camera, or Freecam via on-screen NUI HUD buttons.
• Offline Test Mode: If the streamer wants to test the system without actually going live, they can switch to Test Mode and spawn simulated bots (/bot) to race against each other.