# Home
URL: /en/docs

Welcome to Thunder Store Documentation!

## Our scripts

<Cards>
  <Card title="thunder-antibump" href="/docs/thunder-antibump" />

  <Card title="thunder-delprops" href="/docs/thunder-delprops" />

  <Card title="thunder-passengerlite" href="/docs/thunder-passengerlite" />

  <Card title="thunder-speedlimiter" href="/docs/thunder-speedlimiter" />

  <Card title="thunder-stall" href="/docs/thunder-stall" />
</Cards>


# LLMs.txt
URL: /en/docs/llms

Thunder Store exposes an `LLMs.txt` that helps AI models understand how to integrate and interact with yours scripts.

See it at [https://thunderstore.site/en/llms.txt](https://thunderstore.site/en/llms.txt).


# Application
URL: /en/docs/thunder-antibump/application

## Important

For the **AntiBump** system to work properly on a vehicle,
the subHandling block must contain the <br />`<Item type="CCarHandlingData">`.
Without the `<Item type="CCarHandlingData">` in subHandling, AntiBump will not be applied.

### Lowrider Vehicles

Vehicles with special suspension (lowriders) cannot use **AntiBump**.
In this case, remove the <br />`<Item type="CCarHandlingData">` from subHandling,
because AntiBump interferes with the physics of the special suspension.

### Downforce and AntiBump

Any handling that uses **downforce** (aerodynamic downward force) cannot have **AntiBump** enabled.
In other words, if there is downforce, disable **AntiBump**.


# Configuration
URL: /en/docs/thunder-antibump/config

## Configurations

#### TimeThread

If you are facing any type of conflict with another script<br />
Test and reduce the time to at least 1, this will have a direct impact on performance.

```lua title="config.lua"
TimeThread = 1000
```

#### Types

<TypeTable
  type={{
  TimeThread: {
    description:
      'Used to wait before continuing the code.',
    type: 'float',
    required: true,
    default: '1000 ms',
  },
}}
/>


# Overview
URL: /en/docs/thunder-antibump

<YouTube id="7BRBa0wGYTY" title="Thunder-AntiBump [STANDALONE]" />

No more abuse with bumps!<br />
With the Anti-Bump System, you maintain more realistic gameplay<br />
and improve the dynamics of vehicle interactions.

<br />

✅ Smart impact detection;<br />
✅ Automatic blocking of abusive bumps;<br />
✅ Works on any server (standalone);<br />
✅ Break Boost blocking to prevent irregular acceleration;<br />
✅ Improved player experience;<br />
✅ config.lua available for adjustments;<br />


# Configuration
URL: /en/docs/thunder-delprops/config

## Configurations

#### TimeToRemove

This parameter is the time the script takes after contact to remove the prop.<br />
The longer it takes to remove the prop, the greater the penalty to the player.

```lua title="config.lua"
TimeToRemove = 50
```

#### PropsToRemove

This is the list of pre-selected props made by our team.<br />

```lua title="config.lua"
PropsToRemove = {
	"-655644382",
	"862871082",
	"865627822",
    "-1426008804",
    "-1063472968",
	"1363150739",
	"1211559620",
    "-1186769817",
    "-756152956",
	"1043035044",
	"1437508529",
	"431612653",
	"-2007495856",
	"-2008643115",
	"200846641",
	"2108567945",
	"1821241621",
	"1614656839", 
	"940495467",
	"-97646180",
	"1388308576", 
	"729253480",
	"-628719744",
	"1518466392",
	"-2138350253",
	"-2103798695",
	"589548997",
	"-228596739",
	"-58485588",
	"-1096777189",
	"218085040",
	"1948359883",
	"-1386777370",
	"1387151245",
	"-2008643115",
	"393527760",
	"1923262137",
	"-1620823304",
	"267702115",
	"720581693",
	"1381105889",
	"917457845",
	"-1940238623",
	"1419852836",
	"1419852836",
	"-838860344",
	"1329570871",
	"491238953",
	"1287257122",
	"666561306",
	"1805980844",
	"681787797",
}
```

#### Types

<TypeTable
  type={{
   PropsToRemove: {
    description:
      "Props ID'S",
    type: 'table',
    required: true,
  },
  TimeToRemove: {
    description:
      'Used to determine how long it takes for the prop to disappear.',
    type: 'float',
    required: true,
    default: '50',
  }
}}
/>


# Overview
URL: /en/docs/thunder-delprops

<YouTube id="pHH7mfFE1Sk" title="Thunder-delprops [STANDALONE]" />

⚡ Thunder-DelProps | Enhancing RP for P1, Chases, and Races ⚡<br />
Thunder-DelProps keeps the scene clean by automatically removing props hit by vehicles.<br />
This ensures smoother chases, organized streets, and a more immersive RP environment.

✅ Improves fluidity in chase and race RP;<br />
✅ Creates a more competitive scene, free of unnecessary obstacles;<br />
✅ Works on any server (standalone);<br />
✅ Customizable prop list and removal time;<br />
✅ Keeps the environment clean and realistic;<br />
✅ config.lua is open for adjustments;<br />


# Overview
URL: /en/docs/thunder-passengerlite

<YouTube id="5rLS2uQITxA" title="Thunder-Passengerlite [STANDALONE]" />

A new script has arrived to further optimize your FiveM experience!<br />

✅ Passengers have no impact on vehicle performance;<br />
✅ Fully optimized, 0.0 resmon usage;<br />
✅ Works on any server (standalone);<br />
✅ Simple, efficient, and essential for any server<br />


# Configuration
URL: /en/docs/thunder-speedlimiter/config

## Important

Before starting, it’s essential to understand how the speed limit priority works. The script follows this hierarchical order to determine which limit will be applied to each vehicle:

1. **LimitedModels**: If the vehicle is listed here, this value will always be used, ignoring the other settings.
2. **LimitedClasses**: If the vehicle is not listed in LimitedModels, the limit set for its class will be applied, if available.
3. **LimitGlobal**: If the vehicle is not in any of the options above, the global limit will be applied, except for the classes listed in ClassesForbiddenGlobal.

In other words, the value of LimitedModels has the highest priority, followed by LimitedClasses, and lastly, LimitGlobal.

## Settings

#### SpeedUnit

Set the speed unit to <b>km/h</b> or <b>mph</b>.<br />
We use FiveM's official calculation to define the speed limit, meaning km/h is `speed * 3.6` and mph is `speed * 2.236936`.

```lua title="config.lua"
Config.SpeedUnit = "kmh" -- kmh or mph
```

#### MaxSpeed

Set the default maximum speed that will be used when no custom speed is specified for a class or vehicle.

```lua title="config.lua"
Config.MaxSpeed = 177.0
```

#### LimitGlobal

Set a global limit for all classes, except those listed in [ClassesForbiddenGlobal](/docs/thunder-speedlimiter/config#classesforbiddenglobal).

```lua title="config.lua"
Config.LimitGlobal = true
```

#### ClassesForbiddenGlobal

Specify here the classes that will be ignored by <b>LimitGlobal</b>. Some are already set by default, such as <b>Helicopters</b> and others.

```lua title="config.lua"
Config.ClassesForbiddenGlobal = {
    [15] = true, -- Helicopters
    [16] = true, -- Planes
    [19] = true, -- Military
}
```

#### LimitedClasses

Control the speed by class easily. For example, set a custom speed like `270.0`,
or just use `true` to apply the value from [MaxSpeed](/docs/thunder-speedlimiter/config#maxspeed).

```lua title="config.lua"
Config.LimitedClasses = {
    [7] = 270.0, -- Super - 270.0
    [8] = true, -- Motorcycles - Config.MaxSpeed
}
```

#### CustomClasses

Create as many custom classes as you want and use them in [LimitedModels](/docs/thunder-speedlimiter/config#limitedmodels).<br />
Set a custom speed like `270.0`, or just use `true` to apply the value from [MaxSpeed](/docs/thunder-speedlimiter/config#maxspeed).

```lua title="config.lua"
Config.CustomClasses = {
    ["S++"] = 290.0,
    ["S+"] = true, -- Config.MaxSpeed
    ["PoliceSpeed"] = 300.0,
}
```

#### LimitedModels

A granular control of speed limit per vehicle.<br />
Set a custom speed like `270.0`, a [CustomClass](/docs/thunder-speedlimiter/config#customclasses)
you created like `PoliceSpeed`, or simply use `true` to apply the value from [MaxSpeed](/docs/thunder-speedlimiter/config#maxspeed).

```lua title="config.lua"
Config.LimitedModels = {
    ["comet7"] = 180.0, -- 180.0
    ["prototipo"] = "S", -- Config.CustomClasses
    ["cyclone"] = true, -- Config.MaxSpeed
}
```

#### Types

<TypeTable
  type={{
  SpeedUnit: {
    description:
      'Speed measurement unit',
    type: 'kmh | mph',
    required: true,
    default: 'kmh',
  },
  MaxSpeed: {
    description:
      'Default maximum speed',
    type: 'float',
    required: true,
    default: '177.0',
  },
  LimitGlobal: {
    description:
      'Enable the global limit for all classes except those in ClassesForbiddenGlobal',
    type: 'boolean',
    required: true,
    default: 'true',
  },
  ClassesForbiddenGlobal: {
    description:
      'Classes that will be ignored by LimitGlobal',
    type: 'table',
    required: true,  
  },
  LimitedClasses: {
    description:
      'Control speed by class',
    type: 'table',
    required: true,  
  },
  CustomClasses: {
    description:
      'Create custom classes',
    type: 'table',
    required: true,  
  },
  LimitedModels: {
    description:
      'Control speed by vehicle model',
    type: 'table',
    required: true,  
  }
}}
/>


# Overview
URL: /en/docs/thunder-speedlimiter

<YouTube id="DlGRu6olqY4" title="Thunder-SpeedLimiter [STANDALONE]" />

Control the maximum speed of vehicles on your server!<br />
Define which models or classes (like motorcycles or cars) will have a speed limit.<br />
Fully customizable.<br />

✅ Granular control globally, by class, and by model;<br />
✅ Create custom speed classes;<br />
✅ Works on any server (standalone);<br />
✅ Optimized code;<br />
✅ config.lua fully open for adjustments;<br />

## Next steps

<Cards>
  <Card title="Configuration" href="/docs/thunder-speedlimiter/config" />
</Cards>


# Configuration
URL: /en/docs/thunder-stall/config

## Important

This script controls the vehicle stall, meaning when the engine automatically shuts off after collisions and low speed. Configure carefully to avoid unwanted issues.

#### DebugMode

Enable or disable debug mode. Useful for testing the script without actual effects.

```lua title="config.lua"
DebugMode = false -- true to enable debug
```

#### MaxCollisions

Maximum number of collisions the vehicle can take before triggering a stall.

```lua title="config.lua"
MaxCollisions = 5 -- Maximum stalls
```

#### StallDuration

Time in milliseconds that the engine will stay off after reaching the collision limit.

```lua title="config.lua"
StallDuration = 3000 -- Engine off time (ms)
```

#### SpeedDrop

Minimum speed required for the stall to activate. If the vehicle is above this speed, the stall will not occur.

```lua title="config.lua"
SpeedDrop = 130.0 -- Minimum speed to activate the stall
```

#### SoundEffect

Name of the sound effect that will be played when the stall occurs.

```lua title="config.lua"
SoundEffect = "TIMER_STOP"
```

#### SoundBank

Sound bank from which the effect will be played.

```lua title="config.lua"
SoundBank = "HUD_MINI_GAME_SOUNDSET"
```

#### Notify

Enable or disable client notifications when a stall occurs.

```lua title="config.lua"
Notify = true
```

#### SendNotify

Function responsible for sending the notification. Modify according to your notification system.

```lua title="config.lua"
function SendNotify(Message)
    -- Implement the call to your notification script.
    -- Attention: this is called by the client, use only TriggerEvent.
    TriggerEvent("Notify", 'yellow', Message, "Stall", 3000)
end
```

#### Types

<TypeTable
  type={{
  DebugMode: {
    description: 'Enable or disable debug mode',
    type: 'boolean',
    required: true,
    default: false,
  },
  MaxCollisions: {
    description: 'Maximum number of collisions before triggering a stall',
    type: 'integer',
    required: true,
    default: 5,
  },
  StallDuration: {
    description: 'Time in milliseconds that the engine will stay off',
    type: 'integer',
    required: true,
    default: 3000,
  },
  SpeedDrop: {
    description: 'Minimum speed to activate the stall',
    type: 'float',
    required: true,
    default: 130.0,
  },
  SoundEffect: {
    description: 'Sound effect played during the stall',
    type: 'string',
    required: true,
    default: 'TIMER_STOP',
  },
  SoundBank: {
    description: 'Sound bank from which the effect will be played',
    type: 'string',
    required: true,
    default: 'HUD_MINI_GAME_SOUNDSET',
  },
  Notify: {
    description: 'Enable or disable client notifications',
    type: 'boolean',
    required: true,
    default: true,
  },
  SendNotify: {
    description: 'Function to send custom notifications',
    type: 'function',
    required: true,
  },
}}
/>


# Overview
URL: /en/docs/thunder-stall

<YouTube id="Y4VVrxOOlXs" title="Thunder-Stall [STANDALONE]" />

Add realism to collisions! Thunder-Stall is a standalone, optimized, and customizable script that simulates engine failures after impacts above a defined speed!<br />

✅ Flexible configuration (minimum speed, number of failures, shutdown time);<br />
✅ Compatible with fix, mechanics, and any HUD;<br />
✅ Lightweight and high-performance code;<br />
✅ Works on any framework (standalone);<br />
✅ Support for modern builds (v2843+);<br />

## Next steps

<Cards>
  <Card title="Configuration" href="/docs/thunder-stall/config" />
</Cards>


# Client Exports
URL: /en/docs/thunder-speedlimiter/exports/client-exports

#### Nitro

Inform the script when nitro is activated so the maximum speed limit is ignored.<br />
When the vehicle slows down and drops below its speed limit, the limiter is reapplied until the next nitro activation.<br />
We recommend adding a cooldown time before the next nitro activation to prevent abuse.<br />

```lua
-- true: boolean - true or false
exports["thunder-speedlimiter"]:ToggleNitro(true)
```


# Exports and Events
URL: /en/docs/thunder-speedlimiter/exports

## Next steps

<Cards>
  <Card title="Client Exports" href="/docs/thunder-speedlimiter/exports/client-exports" />
</Cards>


# Client Events
URL: /en/docs/thunder-stall/exports/client-events

You can adapt your HUD to display the number of collisions the vehicle has. It is updated whenever a player enters the vehicle and whenever the value is updated.

### thunder-stall:hud

This event receives a parameter containing the number of collisions.

Example implementation in your HUD:

```lua
-- param: int collisions
RegisterNetEvent("thunder-stall:hud")
AddEventHandler("thunder-stall:hud",function(collisions)
	SendNUIMessage({ Action = "UpdateStall", Collisions = collisions })
end)
```

### thunder-stall:forceUpdateHud

When executing a ResetStall, for optimization purposes the command will not update the HUD collision counter for those inside the vehicle. Therefore, you should trigger this event through a fixed command, for example on the server-side.

The "thunder-stall:hud" is always triggered when entering a vehicle or changing seats, updating the HUD. Use the force event carefully if needed.

```lua
-- param: number -- source -- source of player in server-side
TriggerClientEvent("thunder-stall:forceUpdateHud", source)
```


# Client Exports
URL: /en/docs/thunder-stall/exports/client-exports

### GetCollisions

Gets the number of collisions of the current vehicle.

```lua
-- return: int -- The number of collisions
local colissions = exports["thunder-stall"]:GetCollisions()
```

### GetCollisionsByPlate

Gets the number of collisions of a vehicle by its plate.

```lua
-- param: string -- Plate -- Vehicle's plate
-- return: int -- The number of collisions
local colissions = exports["thunder-stall"]:GetCollisionsByPlate(Plate)
```


# Exports and Events
URL: /en/docs/thunder-stall/exports

## Next steps

<Cards>
  <Card title="Client Exports" href="/docs/thunder-stall/exports/client-exports" />

  <Card title="Server Exports" href="/docs/thunder-stall/exports/server-exports" />

  <Card title="Client Events" href="/docs/thunder-stall/exports/client-events" />

  <Card title="Server Events" href="/docs/thunder-stall/exports/server-events" />
</Cards>


# Server Events
URL: /en/docs/thunder-stall/exports/server-events

## thunder-stall:resetStall

Every time you repair the vehicle or use fix, for example, you should notify the script to reset the number of collisions.

```lua
-- param: string -- Plate -- Plate of vehicle
TriggerEvent("thunder-stall:resetStall", Plate)
```


# Server Exports
URL: /en/docs/thunder-stall/exports/server-exports

### GetCollisionsByPlate

Gets the number of collisions of a vehicle by its plate.

```lua
-- param: string -- Plate -- Vehicle's plate
-- return: int -- The number of collisions
local colissions = exports["thunder-stall"]:GetCollisionsByPlate(Plate)
```

### ResetStall

Every time you repair the vehicle or use fix, for example, you should notify the script to reset the number of collisions.

```lua
-- param: string -- Plate -- Plate of vehicle
exports["thunder-stall"]:ResetStall(Plate)
```


# Inicio
URL: /br/docs

Seja bem-vindo(a) aos Documentos da Thunder Store!

## Nossos scripts

<Cards>
  <Card title="thunder-antibump" href="/docs/thunder-antibump" />

  <Card title="thunder-delprops" href="/docs/thunder-delprops" />

  <Card title="thunder-passengerlite" href="/docs/thunder-passengerlite" />

  <Card title="thunder-speedlimiter" href="/docs/thunder-speedlimiter" />

  <Card title="thunder-stall" href="/docs/thunder-stall" />
</Cards>


# LLMs.txt
URL: /br/docs/llms

A Thunder Store expõe um `LLMs.txt` que ajuda modelos de IA a entender como integrar e interagir com seus scripts.

Veja em [https://thunderstore.site/br/llms.txt](https://thunderstore.site/br/llms.txt).


# Aplicação
URL: /br/docs/thunder-antibump/application

## Importante

Para que o sistema **AntiBump** funcione corretamente em um veículo,
o bloco subHandling precisa conter o <br />`<Item type="CCarHandlingData">`.
Sem o `<Item type="CCarHandlingData">` no subHandling, o AntiBump não será aplicado.

### Veículos Lowrider

Veículos com suspensão especial (lowrider) não podem usar **AntiBump**.
Nesse caso, remova o <br />`<Item type="CCarHandlingData">` do subHandling,
pois o AntiBump interfere com a física da suspensão especial.

### Downforce e AntiBump

Qualquer handling que utilize **downforce** (força aerodinâmica para baixo)
não pode ter **AntiBump** ativo.
Ou seja, se há downforce, desative o **AntiBump**.


# Configuração
URL: /br/docs/thunder-antibump/config

## Configurações

#### TimeThread

Caso você esteja enfrentando algum tipo de conflito com outro script<br />
Faça testes e diminua o tempo para até no mínimo 1, isso terá impacto diretamente na performance.

```lua title="config.lua"
TimeThread = 1000
```

#### Tipos

<TypeTable
  type={{
  TimeThread: {
    description:
      'Usado para aguardar antes de continuar o código.',
    type: 'float',
    required: true,
    default: '1000 ms',
  },
}}
/>


# Apresentação
URL: /br/docs/thunder-antibump

<YouTube id="7BRBa0wGYTY" title="Thunder-AntiBump [STANDALONE]" />

Chega de abusos com bumps!<br />
Com o Sistema AntiBump, você mantém a jogabilidade mais realista<br />
e melhora a dinâmica das interações entre os veículos.

<br />

✅ Detecção inteligente de impactos;<br />
✅ Bloqueio automático de bumps abusivos;<br />
✅ Funciona em qualquer servidor (standalone);<br />
✅ Bloqueio de Break Boosts para evitar acelerações irregulares;<br />
✅ Melhoria na experiência dos jogadores;<br />
✅ config.lua liberado para ajustes;<br />


# Configuração
URL: /br/docs/thunder-delprops/config

## Configurações

#### TimeToRemove

Esse parâmetro é o tempo que o script leva depois do contato para remover o prop.<br />
Quanto mais tempo para remover o prop, mais penalidade ao player.

```lua title="config.lua"
TimeToRemove = 50
```

#### PropsToRemove

Essa é a lista de props pré-selecionados pela nossa curadoria.<br />

```lua title="config.lua"
PropsToRemove = {
	"-655644382",
	"862871082",
	"865627822",
    "-1426008804",
    "-1063472968",
	"1363150739",
	"1211559620",
    "-1186769817",
    "-756152956",
	"1043035044",
	"1437508529",
	"431612653",
	"-2007495856",
	"-2008643115",
	"200846641",
	"2108567945",
	"1821241621",
	"1614656839", 
	"940495467",
	"-97646180",
	"1388308576", 
	"729253480",
	"-628719744",
	"1518466392",
	"-2138350253",
	"-2103798695",
	"589548997",
	"-228596739",
	"-58485588",
	"-1096777189",
	"218085040",
	"1948359883",
	"-1386777370",
	"1387151245",
	"-2008643115",
	"393527760",
	"1923262137",
	"-1620823304",
	"267702115",
	"720581693",
	"1381105889",
	"917457845",
	"-1940238623",
	"1419852836",
	"1419852836",
	"-838860344",
	"1329570871",
	"491238953",
	"1287257122",
	"666561306",
	"1805980844",
	"681787797",
}
```

#### Tipos

<TypeTable
  type={{
   PropsToRemove: {
    description:
      'ID dos props.',
    type: 'table',
    required: true,
  },
  TimeToRemove: {
    description:
      'Usado para determinar em quanto tempo o prop vai desaparecer.',
    type: 'float',
    required: true,
    default: '50',
  }
}}
/>


# Apresentação
URL: /br/docs/thunder-delprops

<YouTube id="pHH7mfFE1Sk" title="Thunder-delprops [STANDALONE]" />

⚡ Thunder-DelProps | Melhorando o RP de P1, Perseguições e Corridas ⚡<br />
O Thunder-DelProps mantém o cenário sempre limpo ao remover automaticamente props atingidos por veículos.<br />
Isso garante perseguições mais fluidas, ruas organizadas e um ambiente mais imersivo para o RP.

✅ Melhora a fluidez no RP de perseguições e corridas;<br />
✅ Cria um cenário mais competitivo, sem obstáculos desnecessários;<br />
✅ Funciona em qualquer servidor (standalone);<br />
✅ Lista de props e tempo de remoção personalizáveis;<br />
✅ Mantém o ambiente limpo e realista;<br />
✅ config.lua liberado para ajustes;<br />


# Apresentação
URL: /br/docs/thunder-passengerlite

<YouTube id="5rLS2uQITxA" title="Thunder-Passengerlite [STANDALONE]" />

Chegou um novo script para otimizar ainda mais a sua experiência no FiveM!<br />

✅ Passageiros sem impacto no desempenho do veículo;<br />
✅ Totalmente otimizado, consumo de 0,0 resmon;<br />
✅ Funciona em qualquer servidor (standalone);<br />
✅ Simples, eficiente e essencial para qualquer servidor<br />


# Configuração
URL: /br/docs/thunder-speedlimiter/config

## Importante

Antes de começar, é fundamental entender como funciona a prioridade das configurações de limite de velocidade. O script segue a seguinte ordem hierárquica para definir qual limite será aplicado a cada veículo:

1. **LimitedModels**: Se o veículo estiver listado aqui, este valor sempre será utilizado, ignorando as demais configurações.
2. **LimitedClasses**: Caso o veículo não esteja em LimitedModels, será aplicado o limite definido para a classe dele, se houver.
3. **LimitGlobal**: Se o veículo não estiver em nenhuma das opções acima, será aplicado o limite global, exceto para as classes listadas em ClassesForbiddenGlobal.

Ou seja, o valor de LimitedModels tem prioridade máxima, seguido por LimitedClasses e, por último, LimitGlobal.

## Configurações

#### SpeedUnit

Defina a unidade de medida da velocidade em <b>km/h</b> ou <b>mph</b>.<br />
Usamos o calculo oficial do FiveM para definir o limite de velocidade, ou seja km/h é definido `velocidade * 3.6` e mph é `velocidade * 2.236936`.

```lua title="config.lua"
Config.SpeedUnit = "kmh" -- kmh or mph
```

#### MaxSpeed

Defina a velocidade máxima padrão que será utilizada, quando você não informar nenhuma velocidade personalizada para uma classe ou veículo.

```lua title="config.lua"
Config.MaxSpeed = 177.0
```

#### LimitGlobal

Defina um limite global para todas as classes, exceto as presentes em [ClassesForbiddenGlobal](/docs/thunder-speedlimiter/config#classesforbiddenglobal).

```lua title="config.lua"
Config.LimitGlobal = true
```

#### ClassesForbiddenGlobal

Informe nessa configuração as classes que serão ignoradas pelo <b>LimitGlobal</b>, já deixamos algumas por padrão, como por exemplo <b>Helicópteros</b> e outras.

```lua title="config.lua"
Config.ClassesForbiddenGlobal = {
    [15] = true, -- Helicópteros
    [16] = true, -- Aviões
    [19] = true, -- Militar
}
```

#### LimitedClasses

Controle aqui a velocidade por classe, de forma muito simples, por exemplo insira uma velocidade personalizada como `270.0`
ou deixe apenas `true` que usaremos o valor da configuração [MaxSpeed](/docs/thunder-speedlimiter/config#maxspeed).

```lua title="config.lua"
Config.LimitedClasses = {
    [7] = 270.0, -- Super - 270.0
    [8] = true, -- Motos - Config.MaxSpeed
}
```

#### CustomClasses

Crie quantas classes customizadas você quiser, e use-as em [LimitedModels](/docs/thunder-speedlimiter/config#limitedmodels).<br />
Insira uma velocidade personalizada como `270.0` ou deixe apenas `true` que usaremos o valor da configuração [MaxSpeed](/docs/thunder-speedlimiter/config#maxspeed)

```lua title="config.lua"
Config.CustomClasses = {
    ["S++"] = 290.0,
    ["S+"] = true, -- Config.MaxSpeed
    ["PoliceSpeed"] = 300.0,
}
```

#### LimitedModels

Um controle granular de limite de velocidade por veículo.<br />
Insira uma velocidade personalizada como `270.0`, uma [CustomClass](/docs/thunder-speedlimiter/config#customclasses) que
você criou como `PoliceSpeed` ou deixe apenas `true` que usaremos o valor da configuração [MaxSpeed](/docs/thunder-speedlimiter/config#maxspeed).

```lua title="config.lua"
Config.LimitedModels = {
    ["comet7"] = 180.0, -- 180.0
    ["prototipo"] = "S", -- Config.CustomClasses
    ["cyclone"] = true, -- Config.MaxSpeed
}
```

#### Tipos

<TypeTable
  type={{
  SpeedUnit: {
    description:
      'Unidade de medida de velocidade',
    type: 'kmh | mph',
    required: true,
    default: 'kmh',
  },
  MaxSpeed: {
    description:
      'Velocidade máxima padrão',
    type: 'float',
    required: true,
    default: '177.0',
  },
  LimitGlobal: {
    description:
      'Ativar o limite global para todas as classes, exceto as presentes em ClassesForbiddenGlobal',
    type: 'boolean',
    required: true,
    default: 'true',
  },
  ClassesForbiddenGlobal: {
    description:
      'Classes que serão ignoradas pelo LimitGlobal',
    type: 'table',
    required: true,  
  },
  LimitedClasses: {
    description:
      'Controle a velocidade por classe',
    type: 'table',
    required: true,  
  },
  CustomClasses: {
    description:
      'Crie classes personalizadas',
    type: 'table',
    required: true,  
  },
  LimitedModels: {
    description:
      'Controle a velocidade por Modelo',
    type: 'table',
    required: true,  
  }
}}
/>


# Apresentação
URL: /br/docs/thunder-speedlimiter

<YouTube id="DlGRu6olqY4" title="Thunder-SpeedLimiter [STANDALONE]" />

Controle a velocidade máxima de veículos no seu servidor!<br />
Defina quais modelos ou classes (como motos ou carros) terão limite de velocidade.<br />
Totalmente configurável.<br />

✅ Controle granular global, por classe e modelo;<br />
✅ Crie classes customizadas de velocidades;<br />
✅ Funciona em qualquer servidor (standalone);<br />
✅ Código otimizado;<br />
✅ config.lua liberado para ajustes;<br />

## Próximos passos

<Cards>
  <Card title="Configuração" href="/docs/thunder-speedlimiter/config" />
</Cards>


# Configuração
URL: /br/docs/thunder-stall/config

## Importante

Este script controla o stall do veículo, ou seja, quando o motor desliga automaticamente após colisões e baixa velocidade. Configure com atenção para evitar travamentos indesejados.

#### DebugMode

Ative ou desative o modo de debug. Útil para testar o script sem efeitos reais.

```lua title="config.lua"
DebugMode = false -- true para ativar debug
```

#### MaxCollisions

Número máximo de colisões que o veículo pode sofrer antes de ativar o stall.

```lua title="config.lua"
MaxCollisions = 5 -- Número máximo de stalls
```

#### StallDuration

Tempo em milissegundos que o motor ficará desligado após atingir o limite de colisões.

```lua title="config.lua"
StallDuration = 3000 -- Tempo de motor desligado (ms)
```

#### SpeedDrop

Velocidade mínima necessária para que o stall seja ativado. Se o veículo estiver acima dessa velocidade, o stall não ocorrerá.

```lua title="config.lua"
SpeedDrop = 130.0 -- Velocidade mínima para ativar o stall
```

#### SoundEffect

Nome do efeito sonoro que será reproduzido quando o stall ocorrer.

```lua title="config.lua"
SoundEffect = "TIMER_STOP"
```

#### SoundBank

Banco de sons de onde o efeito será reproduzido.

```lua title="config.lua"
SoundBank = "HUD_MINI_GAME_SOUNDSET"
```

#### Notify

Ativa ou desativa notificações do cliente quando ocorre um stall.

```lua title="config.lua"
Notify = true
```

#### SendNotify

Função responsável por enviar a notificação. Modifique conforme seu sistema de notificações.

```lua title="config.lua"
function SendNotify(Message)
    -- Implemente a chamada para o seu script de notificações.
    -- Atenção: ele é chamado pelo cliente, use apenas TriggerEvent.
    TriggerEvent("Notify", 'amarelo', Message, "Stall", 3000)
end
```

#### Tipos

<TypeTable
  type={{
  DebugMode: {
    description: 'Ativa ou desativa o modo de debug',
    type: 'boolean',
    required: true,
    default: false,
  },
  MaxCollisions: {
    description: 'Número máximo de colisões antes de ativar o stall',
    type: 'integer',
    required: true,
    default: 5,
  },
  StallDuration: {
    description: 'Tempo em milissegundos que o motor ficará desligado',
    type: 'integer',
    required: true,
    default: 3000,
  },
  SpeedDrop: {
    description: 'Velocidade mínima para ativar o stall',
    type: 'float',
    required: true,
    default: 130.0,
  },
  SoundEffect: {
    description: 'Efeito sonoro reproduzido durante o stall',
    type: 'string',
    required: true,
    default: 'TIMER_STOP',
  },
  SoundBank: {
    description: 'Banco de sons de onde o efeito será reproduzido',
    type: 'string',
    required: true,
    default: 'HUD_MINI_GAME_SOUNDSET',
  },
  Notify: {
    description: 'Ativa ou desativa notificações do cliente',
    type: 'boolean',
    required: true,
    default: true,
  },
  SendNotify: {
    description: 'Função para enviar notificações personalizadas',
    type: 'function',
    required: true,
  },
}}
/>


# Apresentação
URL: /br/docs/thunder-stall

<YouTube id="Y4VVrxOOlXs" title="Thunder-Stall [STANDALONE]" />

Adicione realismo às colisões! O Thunder-Stall é um script standalone, otimizado e personalizável, que simula falhas no motor após impactos acima de uma velocidade definida!<br />

✅ Configuração flexível (velocidade mínima, número de falhas, tempo de desligamento);<br />
✅ Compatível com fix, mecânicos e qualquer HUD;<br />
✅ Código leve e de alto desempenho;<br />
✅ Funciona em qualquer framework (standalone);<br />
✅ Suporte a builds modernas (v2843+);<br />

## Próximos passos

<Cards>
  <Card title="Configuração" href="/docs/thunder-stall/config" />
</Cards>


# Client Exports
URL: /br/docs/thunder-speedlimiter/exports/client-exports

#### Nitro

Informe ao script quando o nitro está ativado para a velocidade máxima ser ignorada.<br />
Quando o carro diminuir a velocidade e ficar menor que o limite do veículo o limite é restabelecido até a próxima ativação do nitro.<br />
Recomendamos a ativação do nitro ter um tempo antes da próxima ativação para evitar abusos.<br />

```lua
-- true: boolean - true or false
exports["thunder-speedlimiter"]:ToggleNitro(true)
```


# Exports e Eventos
URL: /br/docs/thunder-speedlimiter/exports

## Próximos passos

<Cards>
  <Card title="Client Exports" href="/docs/thunder-speedlimiter/exports/client-exports" />
</Cards>


# Client Events
URL: /br/docs/thunder-stall/exports/client-events

Você pode adaptar sua HUD para exibir quantas colisões o veículo possuí, ele é atualizado sempre que um player entra no veículo e sempre que o valor é atualizado.

### thunder-stall:hud

Esse evento recebe um parâmetro que contem os números de colisões.

Exemplo de implementação em sua HUD:

```lua
-- param: int collisions
RegisterNetEvent("thunder-stall:hud")
AddEventHandler("thunder-stall:hud",function(collisions)
	SendNUIMessage({ Action = "UpdateStall", Collisions = collisions })
end)
```

### thunder-stall:forceUpdateHud

Ao executar um ResetStall, por fim de otimização o comando não atualizará para quem está dentro do carro o contador de colisões da HUD, com isso você deve executar o evento em um comando fix por exemplo no server-side.

O "thunder-stall:hud" sempre é chamado ao entrar em um veículo ou ao trocar de assento atualizando a HUD, ao contrario use o evento force de maneira cuidadosa.

```lua
-- param: number -- source -- source of player in server-side
TriggerClientEvent("thunder-stall:forceUpdateHud", source)
```


# Client Exports
URL: /br/docs/thunder-stall/exports/client-exports

### GetCollisions

Obtém a quantidade de colisões do veículo atual.

```lua
-- return: int -- The number of collisions
local colissions = exports["thunder-stall"]:GetCollisions()
```

### GetCollisionsByPlate

Obtém a quantidade de colisões do veículo por Placa.

```lua
-- param: string -- Plate -- Plate of vehicle
-- return: int -- The number of collisions
local colissions = exports["thunder-stall"]:GetCollisionsByPlate(Plate)
```


# Exports and Events
URL: /br/docs/thunder-stall/exports

## Next steps

<Cards>
  <Card title="Client Exports" href="/docs/thunder-stall/exports/client-exports" />

  <Card title="Server Exports" href="/docs/thunder-stall/exports/server-exports" />

  <Card title="Client Events" href="/docs/thunder-stall/exports/client-events" />

  <Card title="Server Events" href="/docs/thunder-stall/exports/server-events" />
</Cards>


# Server Events
URL: /br/docs/thunder-stall/exports/server-events

## thunder-stall:resetStall

Toda vez que você reparar o veículo ou dar fix por exemplo, você deve avisar o script para ele reiniciar a quantidade de colisões.

```lua
-- param: string -- Plate -- Plate of vehicle
TriggerEvent("thunder-stall:resetStall", Plate)
```


# Server Exports
URL: /br/docs/thunder-stall/exports/server-exports

### GetCollisionsByPlate

Obtém a quantidade de colisões do veículo por Placa.

```lua
-- param: string -- Plate -- Plate of vehicle
-- return: int -- The number of collisions
local colissions = exports["thunder-stall"]:GetCollisionsByPlate(Plate)
```

### ResetStall

Toda vez que você reparar o veículo ou dar fix por exemplo, você deve avisar o script para ele reiniciar a quantidade de colisões.

```lua
-- param: string -- Plate -- Plate of vehicle
exports["thunder-stall"]:ResetStall(Plate)
```