Pixel Car Racer: Garage & DragAI · Claude 3.5

Core Game Loop and Mechanics

The Player Experience:

Players alternate between two core activities that form an addictive loop:

1. Garage Management - Players spend time in their garage customizing their car with purchased parts, managing their inventory, and preparing for races
2. Drag Racing - Players take their customized car to the strip and compete in quarter-mile races to earn money for more parts

Moment-to-Moment Gameplay:

• In the garage: Browse parts in the shop, compare stats, purchase upgrades, install them on your car, and see visual changes
• In races: Perfect your launch timing, shift gears at optimal RPM points, and watch your car accelerate down the strip
• Between activities: Track your earnings, unlock new parts and races, and plan your next upgrade path

Progression & Engagement:

• Money earned from races unlocks better parts and more powerful upgrades
• Each upgrade visibly improves car performance and appearance
• Faster times unlock tougher opponents and bigger payouts
• The satisfaction of seeing your custom build dominate the strip

Win/Lose Conditions:

• Win races by crossing the finish line first (better time)
• Lose if opponent finishes first
• Perfect shifts and launch timing are key to victory
• Poor gear timing results in slower times and lost races

Replayability:

• Endless customization combinations create unique builds
• Chasing faster times and perfect runs
• Experimenting with different part combinations
• Competing against progressively harder AI opponents

Starting Scope

For the initial implementation, we'll focus on creating a polished, playable core experience that demonstrates the key mechanics:

Phase 1 - Initial Release (Implement Now):

Garage System:

• Single car slot with one starter car (pixel art sports car)
• Simplified shop with 3-4 categories of parts:
  • Engines (3 options: Stock, Stage 1, Stage 2)
  • Turbos (3 options: None, Small Turbo, Large Turbo)
  • Wheels (3 visual options)
  • Paint (5 color options)
• Basic inventory system showing installed parts
• Clear part stats display (HP, Weight, Cost)
• Install/uninstall functionality
• Single currency system (dollars)

Racing System:

• One race track with mountain background
• Manual gear shifting (4 gears)
• Launch control with timing-based start
• Simple AI opponent
• Win/lose with time comparison
• Money rewards for winning ($500-1000 per win)

UI/Controls:

• Clean garage interface with Shop/Inventory tabs
• Race HUD with tachometer, speedometer, gear indicator
• Touch controls: Gas/Brake pedals, Shift lever
• Desktop: Arrow keys for gas/brake, Space for shift

Phase 2 - Future Enhancements (Plan for Later):

• Multiple car slots and car variety
• Expanded part categories (exhaust, suspension, fuel systems, air filters, intercoolers)
• Visual customization (body kits, spoilers, decals)
• Multiple race tracks and environments
• Tournament system and story mode
• Premium currency and special parts
• Burnout mechanics and tire smoke effects
• More detailed tuning (PSI, fuel mixture, etc.)
• Leaderboards and statistics tracking

Game Perspective

Side-scrolling perspective for the racing sequences, showing cars from the side as they accelerate down the strip. This classic view is perfect for drag racing, allowing players to see:

• Both cars side-by-side during races
• Clear visual feedback of speed and position
• Detailed pixel art of the cars and their modifications
• Scrolling background creating sense of motion

Fixed-screen perspective for the garage, showing:

• Top-down or isometric view of the garage workspace
• Clear display of the car being customized
• Shop interface overlaying the garage scene
• Part selection and installation areas

Game World and Level Design

Garage Environment:

• Interior garage scene with concrete floor, tool benches, and automotive equipment
• Car positioned centrally for easy viewing during customization
• UI overlays for shop and inventory that don't obscure the car
• Ambient details: tool cabinets, posters, parts scattered around
• Warm lighting to create an inviting workspace atmosphere

Race Track:

• Quarter-mile drag strip with two lanes
• Starting line with Christmas tree light system (staging lights)
• Finish line clearly marked at the end
• Scrolling background featuring mountain scenery with pine trees
• Track surface with lane markings and distance markers
• Crowd barriers and spectator areas in background
• Ambient details: timing tower, sponsor banners, pit area

Single Race Track Design: The initial track features:

• Straight asphalt strip, two lanes wide
• Mountain backdrop with layered parallax scrolling (mountains, trees, sky)
• Starting area with staging lights and burnout box
• Clear finish line with checkered pattern
• Distance markers at 1/8 mile and 1/4 mile points

Edit Mode Design

Edit mode allows players to customize their racing experience and car setup:

Customizable Properties:

1. Car Appearance:

   • Paint color (5 preset colors: Red, Blue, Yellow, Green, Black)
   • Wheel style (3 options: Stock, Sport, Racing)
   • Each change updates the car visual in real-time

2. Performance Parts:

   • Engine selection (affects HP and acceleration)
   • Turbo selection (affects boost and top speed)
   • Parts show clear stat changes when selected

3. Race Settings:

   • AI difficulty (Easy, Medium, Hard) - affects opponent reaction time and shift timing
   • Starting money (for testing: $5,000 / $10,000 / $20,000)

Edit Mode Interface:

• Accessed from main menu before starting game
• Clean tabbed interface: Appearance / Performance / Settings
• Real-time preview of car with changes
• "Reset to Default" button for each category
• "Save & Start Game" button to begin with custom setup

Constraints:

• Paint colors limited to preset palette (maintains art style consistency)
• Parts must be purchased before installation (can't equip parts you don't own)
• Starting money cap at $20,000 (prevents breaking progression)
• AI difficulty affects timing windows, not physics (keeps races fair)

Control Design

Genre: 2D Drag Racing / Arcade Racer
Camera: Side-scrolling (racing), Fixed-screen (garage)

Garage Controls

Mobile (Touch):

• Tap on parts in shop to view details
• Tap "Buy" button to purchase
• Tap on installed parts to uninstall
• Tap on inventory parts to install
• Swipe or tap tabs to switch between Shop/Inventory
• Tap "Race" button to enter racing mode

Desktop (Mouse/Keyboard):

• Click on parts to select and view details
• Click buttons to buy/install/uninstall
• Click tabs to switch views
• Click "Race" button to enter racing mode
• No keyboard shortcuts needed in garage (mouse-driven UI)

Racing Controls

Mobile (Touch):

• Gas Pedal (bottom left): Touch and hold to accelerate
• Brake Pedal (bottom left, above gas): Touch to brake/slow down
• Shift Lever (bottom right): Tap to shift up to next gear
• Launch Control: Release gas at optimal RPM when lights turn green

Desktop (Keyboard):

• Up Arrow or W: Gas/Accelerate
• Down Arrow or S: Brake
• Space Bar: Shift up to next gear
• Launch Control: Hold gas, release at optimal RPM when lights turn green

Control Mechanics:

• Gas is analog on mobile (pressure sensitive if supported), digital on desktop
• Shifting requires precise timing - shift too early (low RPM) or too late (redline) loses speed
• Optimal shift point is in the "green zone" of the tachometer (around 75-85% of max RPM)
• Launch timing: Release gas when final green light appears for perfect launch
• Early/late launches result in slower acceleration

HUD Elements (Always Visible During Race):

• Tachometer (center-left): Shows RPM with color-coded zones (green = optimal shift point, red = redline)
• Speedometer (center-right): Shows current speed in MPH/KPH
• Gear Indicator (center): Shows current gear (1, 2, 3, 4)
• Position Indicator (top): Shows your position vs opponent
• Time/Distance (top-right): Shows elapsed time and distance covered

Race Flow:

1. Staging: Cars pull up to starting line, Christmas tree lights begin sequence
2. Launch: Three amber lights, then green - player must time gas release
3. Acceleration: Shift through gears at optimal RPM points
4. Finish: First car across finish line wins, times displayed

Art Style and Visual Theme

Overall Style: Vibrant Pixel Art with Automotive Detail

The game embraces a detailed 2D pixel art aesthetic inspired by classic arcade racers but with modern polish and depth. Every element should feel crisp, colorful, and mechanically authentic.

Visual Theme:

• Automotive Culture Focus: Celebrate car culture with detailed mechanical parts, realistic garage environments, and authentic racing atmosphere
• Retro-Modern Fusion: Classic pixel art style with contemporary UI design and smooth animations
• High Contrast & Saturation: Bold, vibrant colors that pop on screen without being garish
• Mechanical Authenticity: Parts should look recognizable and functional, even in pixel form

Color Palette:

• Garage: Warm industrial tones - grays, browns, metallic silvers, with pops of color from tools and parts
• Race Track: Cool outdoor palette - blue skies, green mountains, dark asphalt, with vibrant car colors standing out
• UI: Dark backgrounds (charcoal, black) with bright accent colors (neon green for money, gold for premium items, white for text)
• Cars: Full spectrum of vibrant automotive colors - racing reds, electric blues, sunshine yellows, deep blacks

Asset Approach:

• Cars & Parts: Generated pixel art assets for all vehicles and components
• Backgrounds: Generated pixel art for garage interior and race track scenery
• UI Elements: Mix of generated assets (buttons, icons) and code-rendered elements (text, simple shapes)
• Effects: Code-rendered particles for tire smoke, dust, speed lines

Consistency Guidelines:

• All pixel art at consistent resolution (cars ~200-300px wide, parts ~64-128px)
• Unified lighting direction (top-left light source for 3D depth)
• Consistent line weight and anti-aliasing approach
• Matching level of detail across all assets (not too simple, not overly complex)

Animation Style:

• Smooth sprite-based animations for cars (idle, acceleration, shifting)
• Particle effects for smoke, dust, and speed
• UI transitions should be snappy and responsive
• Tachometer needle and speedometer should animate fluidly

Typography:

• Pixel-style font for in-game text (stats, numbers, labels)
• Clean sans-serif for UI buttons and menus
• High contrast text (white on dark, or with dark outlines)
• Large, readable sizes for mobile play