# Superpowers User Guide

### ⚙️ How It Works

#### 🧪 Unlocking Powers

Use special items (e.g. `pill_fly`, `pill_lasereyes`) to unlock superpowers.

* First use = unlocks power
* Repeat use = adds XP (up to 100), enhancing the ability

#### 📈 XP Progression

```lua
Config.Multipliers.xpOnItem = 5
```

* Each use of a power item grants +5 XP
* XP caps at 100
* Powers improve at certain XP milestones

#### ⚡ Stamina System

```lua
Config.staminaRecharge = 1
```

* Powers drain stamina when used
* Stamina regenerates at 1% per second (2% if not using powers)
* Use `pill_stamina` to increase total stamina permanently

#### 🔁 Boosts & Resets

```lua
Config.Items = {
  boostPower = "pill_temppower",
  resetPowers = "pill_cure"
}
```

* **Temporary Boost**: Doubles stamina and power effect for 10 seconds
* **Reset**: Removes all powers from the player

***

### 🧬 Power List

Each power is unlocked via a corresponding item. XP enhances performance, lowers stamina cost, or adds new effects.

#### ✈️ Flight

```lua
pill_fly
```

* Stamina: 1
* XP: Improves control and speed

***

#### 💪 Super Strength

```lua
pill_superstrength
```

* Stamina: 2 (melee), 15 (throw)
* XP: Increases strength and throw range
* Combines with `superSpeed` for impact resistance

***

#### 🔥 Laser Eyes

```lua
pill_lasereyes
```

* Stamina: 20
* XP: Stronger beams

***

#### 👻 Invisibility

```lua
pill_invisibility
```

* Stamina: 3
* XP: Becomes more invisible
* Max XP: Becomes full invisible

***

#### 🌌 Teleport

```lua
pill_teleport
```

* Stamina: 1 per meter
* XP: N/A

***

#### 🛡️ Invincibility

```lua
pill_invincibility
```

* Stamina: 5
* XP Effects:
  * 10: Steam
  * 20: Melee
  * 30: Impact
  * 40: Explosions
  * 50: Fire
  * 60: Bullets

***

#### 🎭 Shapeshift

```lua
pill_shapeshift
```

* Stamina: 3
* XP:
  * 10: NPCs
  * 20: Players
  * 30: Animals

***

#### 🩹 Super Heal

```lua
pill_superheal
```

* Stamina: 0.5
* XP: Faster healing, reduces revive timer

***

#### 🌋 Flame Projection

```lua
pill_flame
```

* Stamina: 1.0
* XP: Increases flame range and damage

***

#### 💣 Self-Explode

```lua
pill_selfexplode
```

* Stamina: 30
* XP: Larger explosion radius and more damage
* Combo: Combine with `pill_energy` to emit an EMP that drains other players' stamina

***

#### ⚡ Super Speed

```lua
pill_superspeed
```

* Stamina: 0.5
* XP: Moving faster

***

#### 🧠 Telekinesis

```lua
pill_telekinesis
```

* Stamina: 5.0
* XP: Range, force increase

***

#### 🌊 Underwater Power

```lua
pill_underwaterpower
```

* Stamina: 0.5
* XP: Enhances breath control and faster swimming

***

#### 🧲 Shockwave

```lua
pill_shockwave
```

* Stamina: 10
* XP: Greater area of effect, knockback

***

#### 🔋 Energy

```lua
pill_energy
```

* Stamina: 1.0
* XP: Stronger electrified melee, improves `selfExplode` into EMP
* Combo: Combine with `pill_selfexplode` to emit an EMP that drains other players' stamina

***

#### 🔥 Fire Resistance

```lua
pill_fire
```

* Passive
* XP: N/A

***

### ⚡ Boost Items

* `pill_stamina` — Permanently increases stamina by **+50**
* `pill_temppower` — Doubles power strength & stamina for superheroes for limited time

&#x20;                                      — Gives normal people two random superpowers for limited time

* `pill_cure` — Resets all active powers

***

### 💡 Gameplay Tips

* Combo `superStrength` + `superSpeed` for tank-like brawling
* Use `energy` + `selfExplode` for anti-super EMP attacks
* Level up `invisibility` early for stealth plays
* Time your boosts for PvP fights or clutch escapes

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://enyo-scripts.gitbook.io/documentations/fivem-scripts/superpowers/superpowers-user-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
