
## 🚗 Clic and Drive — The Ultimate Community Driving Bot

Clic and Drive is a collaborative Discord bot where your **entire server works together** to drive a car as far as possible. Every member clicks the ⛽ Gas Up button to add +1 km to the trip. Work as a team to unlock new vehicles, travel through 4 seasonal zones, survive random road events, and collect powerful items along the way. The further you go, the more chaotic and exciting it gets!

The game runs continuously in a dedicated channel with a **live visual embed** showing the car, zone background, HP bar, fuel bar, vehicle progression and a real-time leaderboard — all updated on every click.

---

## 🔐 Required Permissions

- **Send Messages** — to post and update the game embed
- **Embed Links** — to display rich visual game information
- **Read Message History** — to edit and refresh the live embed
- **Manage Messages** — to keep the game channel clean
- **Use External Emojis** — for items and event display
- **View Channels** — to access the configured game channel
- **Mention Roles** — to ping the alert role during critical events

---

## ⚙️ Admin Commands *(Requires Administrator permission)*

**`/start`**
Launches the Clic and Drive trip in the configured channel. Before starting, the bot displays a full configuration checklist showing the game channel, language, cooldown setting and alert role status. All required fields must be set before the trip can begin. Once launched, the live game embed is posted and the event timer starts automatically.

**`/setchannel #channel`**
Defines the dedicated text channel where the live game embed will be posted and where players click to drive. This is the only required setup step before running `/start`.

**`/setcooldown <seconds>`**
Sets the cooldown between each click, from a minimum of 5 seconds to a maximum of 300 seconds. The default is 30 seconds. Use a lower value for very active servers and a higher value to slow down the pace and make the game last longer.

**`/setlanguage`**
Sets the bot language for your entire server. Choose between 🇬🇧 English and 🇫🇷 French. All embeds, events, item descriptions, command responses and notifications will display in the chosen language.

**`/setping @role`**
Assigns a role to be pinged when a critical in-game alert occurs, such as a low fuel warning before a breakdown. Leave the option empty to disable pings entirely. Useful for keeping your community engaged and preventing the car from breaking down due to inactivity.

**`/reset`**
Resets the current trip. When used, the bot displays a confirmation menu with three options: reset and restart the trip immediately, close the game entirely and clean up the channel, or cancel and do nothing. All current km and session stats are wiped on reset, but all-time leaderboard data and earned badges are permanently preserved.

---

## 👥 Member Commands *(Available to everyone)*

**`/help`**
Displays a complete in-bot guide split across three embeds covering how to play, all vehicles and their unlock thresholds, the 4 seasonal zones, the HP and fuel systems, all items with descriptions, all positive and negative events, all commands, and all badges with their unlock conditions.

**`/stats`**
Shows the current server-wide trip statistics in a clean embed: total km driven, current vehicle, active zone and cycle number, total clicks since the trip started, number of participants, and any currently active event.

**`/trip`**
Displays a detailed summary of the ongoing trip including the current vehicle stage out of 6, the active seasonal zone and cycle, total km, km remaining until the next vehicle unlock, and visual progress bars for both HP and fuel.

**`/mystats`**
Shows your personal statistics for the current trip and all time: your current session click count, your all-time click count across all trips, your current rank on the server, total km you have personally contributed, number of items you have used, which seasonal zones you have visited, all badges you have earned, and the date of your very first click.

**`/leaderboard`**
Displays the Top 10 players on the server ranked by km contributed during the current trip. The top 3 receive gold, silver and bronze medals. Each player's earned badges are displayed as emoji icons next to their name.

**`/inventory`**
Opens your personal inventory showing all items you currently hold, grouped by type with quantity counts and descriptions. Each item has its own interactive button directly in the embed — click it to activate the item instantly without any extra commands. The inventory refreshes automatically after each use.

---

## ⚡ Random Events *(Trigger automatically every 5 minutes)*

Events fire automatically on a timer while the trip is running. They are split into positive events that help the server and negative events that create obstacles. A 🛡️ Shield item can block any incoming negative event before it applies.

### ✅ Positive Events

**🍀 Tailwind**
A favorable wind pushes the car forward. Every click counts double for 5 minutes, effectively giving the entire server x2 km per click during that window. Stack this with a Nitro or Race Tires for massive distance gains.

**🛣️ Clear Road**
The road ahead is completely clear. The click cooldown is removed entirely for 2 minutes, allowing every member to click as fast as they want with no waiting. One of the best events for covering large distances quickly.

**🎁 Surprise Package**
A mystery package is found on the road. Three of the most recently active members each receive a random item added directly to their inventory. This is the only way to get items outside of the normal ~50 click drop rate.

### ❌ Negative Events

**🕳️ Pothole**
The car hits a pothole and loses 20% HP instantly. The car enters a damaged state. To repair it, the server must collectively click 20 times using the 🔧 Repair button that appears on the embed, or any player can use a Repair Kit item to fix it instantly.

**💥 Flat Tire**
A tire blows out and the car is completely stuck — no km can be gained until it is repaired. The 🔧 Repair button appears on the embed and requires 20 collective clicks from any members to fix. A Repair Kit also resolves this instantly. This is the most disruptive event as it fully halts progress.

**🌩️ Storm**
A storm hits and visibility drops. Every click only counts for half a kilometer (x0.5) for 5 minutes. Progress continues but at half the normal rate. A 🛡️ Shield can block this event before it triggers.

**🚧 Roadworks**
Construction ahead forces a slowdown. The click cooldown is doubled for 3 minutes, meaning players must wait twice as long between each click. On servers with a low cooldown this is a moderate setback; on servers with a higher cooldown it can significantly slow things down.

**⛽ Low Fuel Warning**
The fuel tank is critically low. This is a warning event that gives the server 10 minutes to react before a breakdown occurs. Keep clicking to trigger fuel replenishment, or use a 🔧 Repair Kit to instantly refill the tank.

**💀 Breakdown**
The fuel has hit 0% and the car breaks down. The trip immediately loses 50 km as a penalty and the car stalls. Any click after the breakdown restarts the engine and the trip continues. Fuel drains automatically at 1% per minute, so inactivity is the main cause of this event.

---

## 🎒 Items *(Drop randomly every ~50 clicks)*

Items drop randomly as the server clicks and are added directly to the inventory of the player who triggered the drop. Use them via `/inventory` or the interactive buttons.

**⚡ Nitro** — Activates a x2 km multiplier for every click across the entire server for 10 minutes. Stacks with Race Tires for individual boosts.

**🏎️ Race Tires** — Gives the player who uses it a personal +50% km bonus per click for 5 minutes. Only applies to that player's clicks, not the whole server.

**🔧 Repair Kit** — Instantly restores the car's HP to 100% and refills the fuel tank to 100%. Also clears active Pothole and Flat Tire events immediately. The player who uses it during a critical event earns the 🆘 Savior badge.

**🗺️ Shortcut** — Skips ahead and adds +200 km to the trip instantly. Can trigger vehicle unlocks and zone transitions if the km threshold is crossed.

**🛡️ Shield** — Places a protective shield on the car. The next negative event that would trigger is completely blocked and has no effect. The shield is consumed after blocking one event.

**☕ Coffee** — Reduces the personal click cooldown for the player who uses it to a flat 10 seconds for 3 minutes, regardless of the server's configured cooldown. Ideal for a fast clicking burst.

**🎲 Lucky Wheel** — Spins a wheel with a 50/50 chance. On a good roll, the trip gains +100 km and the player earns the 🎲 Lucky badge. On a bad roll, the trip loses 50 km. High risk, high reward.

---

## 🏅 Badges *(Permanent — survive all resets)*

Badges are earned permanently and are never lost when the trip is reset. They carry over across all trips and are visible in `/mystats` and `/leaderboard`.

- 🚀 **Early Bird** — Awarded for making the very first click of a trip
- 💯 **Centurion** — Reach 100 total clicks in a single trip
- 🔥 **On Fire** — Reach 500 total clicks in a single trip
- 👑 **Road King** — Be the #1 ranked player at the moment a trip is reset
- 🆘 **Savior** — Use a Repair Kit while a Pothole or Flat Tire event is active
- 🌍 **Globetrotter** — Participate in all 4 seasonal zones across any trips
- 🏎️ **Speed Demon** — Make 50 clicks in a single calendar day
- ⚡ **Boost Master** — Use 10 items total across any trips
- 🎲 **Lucky** — Get the bonus outcome from the Lucky Wheel item

---

## 🚗 Vehicles *(Unlock by reaching km thresholds)*

- 🛵 **Scooter** — Starting vehicle (0 km)
- 🚗 **Family Car** — Unlocks at 100 km
- 🛻 **Pickup** — Unlocks at 500 km
- 💪 **Muscle Car** — Unlocks at 850 km
- 🏎️ **Sports Car** — Unlocks at 1500 km
- 🏁 **Formula 1** — Unlocks at 2500 km — the trip continues infinitely after this!

---

## 🗺️ Seasonal Zones *(Loop infinitely)*

- 🌸 **Spring** — 0 to 500 km
- ☀️ **Summer** — 501 to 850 km
- 🍂 **Autumn** — 851 to 1500 km
- ❄️ **Winter** — 1501 to 2500 km

After Winter, the zones loop back to Spring and the cycle counter increases. The game never ends!

---

*Clic and Drive supports both 🇬🇧 English and 🇫🇷 French. The language can be changed at any time by an admin using `/setlanguage`.*

Clic and Drive

🚗 Collaborative driving bot! Click together to travel, unlock vehicles, survive events & collect items!

Votando em Clic and Drive

Quer nos ajudar?