Superspeed Seeds: Racing Royale 🚀

A chaotic, seed-powered racing game where redemption means reaching the Mainnet! Built for the SuperSeed Tesla Contest.

---

🎮 Game Overview

Once a mighty Superseed, your powers vanished in the catastrophic Liquidation Event, a fallout from the Dark Winds. To reclaim your status, you must ascend the treacherous, 100-level Tower of Seeds, dodge relentless Fudders, and race towards the ultimate goal: the MAINNET.

But beware! David, the furious founder of the Superseed Chain, blames you for the TGE delay and hunts every Seed in the tower. Your journey is a race against time, debt, and David himself.

Choose your SeedDriver, master unique abilities, collect Seeds for upgrades, conquer challenging worlds, and maybe, just maybe, survive long enough to see the TGE.

---

🔥 Core Features

• 100 Levels to Conquer: Climb the Tower of Seeds, facing increasing difficulty and new challenges in each world.
• 4 Unique SeedDrivers: Play as Seedguy (Dash), João (Speed Boost), Mesky (Slow Field), or The Chosen Seed (Immunity), each with distinct abilities and cooldowns.
• Dynamic Worlds & Weather: Race through 11 diverse worlds (Earth, Fire, Water, Frost, Underworld, Desert, Jungle, Space, Cyber, Mystic, Superseed), each with unique visuals and challenging weather effects (Rain, Wind, Snow).
• Enemy Variety:
  • Roaming Fudders: Basic enemies bouncing off walls (types vary by world).
  • Homing Fudders: Some enemies will track you down!
  • Seedslingers (Shooters): Stationary turrets firing projectiles. Appear from Level 10 onwards.
  • David: The relentless founder appears in later levels(20+), homing in and performing devastating dashes.
• Power-Ups: Grab temporary boosts:
  • ❄️ Freeze: Slows down all enemies for 2 seconds.
  • 🧲 Magnet: Pulls nearby Seeds towards you for 3 seconds.
  • 🛡️ Shield: (In-Game Shop) Provides a one-hit temporary shield.
  • 🪢 Multiplier: Souble seeds picked up for a set amount of time.
• Upgrade Systems:
  • In-Game Shop (Seeds): Spend collected Seeds mid-run to upgrade Speed, increase Seed/Enemy counts, buy a one-hit Shield, slow enemies, or purchase extra Checkpoint uses.
  • Repayment Vault (SUPR): Use SUPR Coins (earned from Achievements) for permanent upgrades like base speed boosts, starting shields, cooldown reductions, larger pickup radius, passive enemy slowing aura, and more!
• Checkpoint System: Start with a base number of checkpoints (plus vault upgrades). Click the Checkpoint button strategically to save your progress mid-run.
• Challenging Minigames: Encounter random minigames after levels for bonus Seeds or SCC:
  • 🌾 Seed Harvest Frenzy: Collect seeds against the clock.
  • ☠️ David's Revenge: Survive David's relentless pursuit.
  • 🌀 Inverse Gauntlet: Navigate a deadly obstacle course with reversed controls.
• Achievements & Hall of Seeds: Unlock dozens of achievements across Bronze, Silver, and Gold tiers, earning SUPR rewards. Track your progress and stats in the Hall of Seeds.
• Seederboard: Compete for the best times and highest levels reached. Save your score after each run!
• Story & Lore: Unravel the saga through an introductory video (requires MoviePy/NumPy).
• Difficulty Modes: Choose between Normal and Hard (more/faster enemies).
• Visual Flair: Enjoy player trails, ability animations, particle effects, shield auras, and distinct world backgrounds.

---

👾 Choose Your SeedDriver

Select one of four heroes to pilot your Seed Pod:

1. 🌱 Seedguy: The determined underdog.
   • Ability: Dash - Short forward burst. (6s Cooldown)
2. 🧔 João: Mastermind dev, David's favorite.
   • Ability: Speed Boost - Increased speed and acceleration for 5s. (30s Cooldown)
3. 🎯 Mesky: Marketing genius, turns markets bullish.
   • Ability: Slow Field - Creates an aura slowing nearby enemies for 3s. (30 Cooldown)
4. ⭐ The Chosen Seed: Blessed, confident, main character energy.
   • Ability: Immunity - Become invincible for 5s. (60s Cooldown)

---

☠️ Know Your Enemies

• Repayment Reapers / Fudders: World-specific roaming enemies trying to drag you down. Some gain homing abilities!
• Seedslingers (Shooters): Stationary threats that charge up and fire projectiles at you. More appear as you climb higher.
• David: Appears in later levels (Level 20+). Homes aggressively and executes a fast, unpredictable dash attack. Cannot be slowed easily!

---

🌎 The Tower Worlds (Levels 1-100)

1. Earth World (1-9): A relatively peaceful start.
2. Fire World (10-20): Fiery visuals, introduces Shooters.
3. Water World (21-30): Aquatic themes.
4. Frost World (31-40): Icy challenges, potential for snow.
5. Underworld (41-50): A dark and dangerous realm.
6. Desert World (51-60): Sandy terrains.
7. Jungle World (61-70): Lush but perilous.
8. Space World (71-80): Zero-G racing (visually!).
9. Cyber World (81-90): Digital domain, high-tech hazards.
10. Mystic World (91-94): INVERSE CONTROLS! A true test of adaptation.
11. Superseed World (95-100): The chaotic, flashing final stretch to Mainnet!

---

🌦️ Weather Effects

Prepare for unpredictable conditions:

Weather	Effect
Clear ☀️	No effect
Rain 🌧️	−20% acceleration
Wind 💨	Strong horizontal drift
Snow ❄️	−50% acceleration

---

🛒 Upgrades & Currencies

• Seeds 🌱: Primary currency collected during runs. Used in the In-Game Shop (Click "Shop" button top-right during gameplay):
  • Speed: +5% Max Speed per level (Scaling Cost).
  • Seed/Enemy: +1 Seed Drop & +1 Enemy Spawn per level (Max 10, Scaling Cost).
  • Shield: One-hit protection (Cost scales with level).
  • Enemy Slow: -5% Enemy Speed per level (Scaling Cost).
  • Checkpoint: Buy +1 Checkpoint use for the current run (Fixed Cost).
• SuperCollateral Coins (SCC) ⭐: Earned by unlocking Achievements. Used in the Repayment Vault (Main Menu) for permanent upgrades:
  • Node Speed Boost: +4% Base Speed per Lvl (Max 2).
  • Respawn Node: +1 Starting Max Checkpoint per Lvl (Max 2).
  • Seed Multiplier: Seeds collected count as 2x (Max 1).
  • Seed Pickup Radius: +5px Pickup Radius per Lvl (Max 10).
  • Ability CDR: Reduce ability cooldown by 20% (Max 1).
  • Start With Shield: Begin each run with a shield (Max 1).
  • Enemy Slow Aura: Passive aura slows nearby enemies by 7% per Lvl (Max 2).
  • Blessing of Superseed: Increase power-up spawn chance by +10% (Max 1).

---

🎮 Minigames

Randomly encountered after winning levels (5% chance), offering bonus rewards:

• Seed Harvest Frenzy: Collect as many Seeds as possible before time runs out! (Reward: Seeds)
• David's Revenge: Survive David's relentless attacks for 30 seconds! (Reward: 1 SCC)
• Inverse Gauntlet: Reach the exit portal while dodging enemies and shooters with reversed controls! (Reward: 2 SCC)

---

📖 Story & Achievements

• Story Video: Watch the intro cinematic explaining the fall of the Superseed and David's wrath (Requires moviepy and numpy). Plays automatically on first start after selecting character. Can be skipped with 'K'.
• Hall of Seeds: Track your unlocked Achievements (Bronze, Silver, Gold), view total stats (Seeds, Magnets collected), and see your current SUPR balance. Earn SUPR for each tier unlocked!

---

⌨️ Controls

• Movement: Arrow Keys / WASD
• Ability: SPACE
• Pause/Resume: P
• Checkpoint: Click Button Top-Right (If available)
• Shop: Click Button Top-Right
• Skip: K (Skips tutorials/video)
• Save Score: S (On Game Over / Win screen after entering name)
• UI Interaction: Mouse Click (Shop, Checkpoint Button, Menus)
• Quit/Back: Escape

---

🚀 How to Play

1. Download/Clone:

   • Download the project files (e.g., as a ZIP and extract it) OR clone the repository using Git:

     git clone https://github.com/Danielkis97/Superspeed-Seeds-Racing-Royale/

2. Navigate to Project Folder:

   • Open your terminal or command prompt.
   • Use the cd command to go into the main project folder (the one containing main.py, Assets, media, etc.).

     cd path/to/Superspeed-Seeds-Racing-Royale  

     or

     cd Superspeed-Seeds-Racing-Royale

3. Create & Activate Virtual Environment (Recommended):

   • It's best practice to create an isolated environment for the project's dependencies.
   • Create:

     python -m venv .venv

     (If python doesn't work, try python3). This creates a .venv folder in your project directory.
   • Activate:
     • Windows (Command Prompt): .venv\Scripts\activate.bat
     • Windows (PowerShell): .venv\Scripts\Activate.ps1 (You might need to adjust execution policy: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process)
     • macOS/Linux (Bash/Zsh): source .venv/bin/activate
   • You'll know it's active when you see (.venv) at the beginning of your terminal prompt.

4. Install Requirements:

   • With the virtual environment active, install the necessary libraries:

     pip install pygame numpy moviepy

     (If pip doesn't work, try pip3). Note: numpy and moviepy are only needed for the optional intro video.

5. Run the Game:

   • Make sure your virtual environment is still active.
   • Run the main script:

     python main.py

     (If python doesn't work, try python3).

6. Enjoy! Use the main menu options to start, view leaderboards, manage permanent upgrades (Vault), or see achievements.

7. (Optional) Deactivate Environment: When you're done playing, you can deactivate the virtual environment by simply typing deactivate in the terminal and pressing Enter.

---

🏆 Contest Submission

This game is submitted for the SuperSeed Tesla Contest.

---

📜 License

This project is licensed under the MIT License.

---

👥 Credits

Developed by FarmingLegendX

🌱 Race your way to the Mainnet and share your scores! Good luck, Superseed! ⭐