> For the complete documentation index, see [llms.txt](https://documentation.rcore.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.rcore.cz/paid-resources/rcore_housing/configuration/raid.md).

# Raid

Edit `rcore_housing/configs/config.raid.lua` to control police raid rules, breach and lockpick minigame difficulty, and lockdown barriers.

## 🚓 Raid Rules

```lua
Config.Raid.Enable                     = true
Config.Raid.PoliceJobs                 = { 'police', 'sheriff' }
Config.Raid.RequirePropertyOwnerOnline = false
Config.Raid.RequiredPolice             = 0
```

| Option                       | Description                                                         |
| ---------------------------- | ------------------------------------------------------------------- |
| `Enable`                     | Master switch for the whole raid system.                            |
| `PoliceJobs`                 | Job names allowed to initiate a raid.                               |
| `RequirePropertyOwnerOnline` | Block raids when the owner is offline.                              |
| `RequiredPolice`             | Minimum officers on duty before a raid is allowed (`0` = disabled). |

## 🚧 Lockdown

```lua
Config.Raid.Lockdown = {
    Enable = true,
    Object = 'prop_barrier_work05',
}
```

The lockdown barrier prop is placed at the property entry while a raid is active.

## 🔨 Breach

```lua
Config.Raid.Breach = {
    RequireItem        = true,
    Item               = 'battering_ram',
    RemoveItemAfterUse = false,
    Minigame           = 'Breach',
    MinigameConfig = {
        Speed       = 7,
        MaxRevs     = 2,
        NeededPicks = 3,
        MaxFails    = 2,
    },
}
```

| Option               | Description                                    |
| -------------------- | ---------------------------------------------- |
| `RequireItem`        | Officer must carry `Item` to breach.           |
| `Item`               | Inventory item name (default `battering_ram`). |
| `RemoveItemAfterUse` | Consume the item on success.                   |
| `Minigame`           | Minigame identifier (default `Breach`).        |
| `Speed`              | Lockpick pointer speed (1–10).                 |
| `MaxRevs`            | Full revolutions before the target resets.     |
| `NeededPicks`        | Successful picks required.                     |
| `MaxFails`           | Failed attempts allowed before failure.        |

Breach animation and prop attachment (`rds_breach_tool` to bone `28422`) are also configured here.

## 🗝️ Lockpick

```lua
Config.Raid.Lockpick = {
    RequireItem        = true,
    Item               = 'lockpick',
    RemoveItemAfterUse = false,
    Minigame           = 'Lockpicking',
    MinigameConfig = {
        [0] = { Speed = 5, MaxRevs = 3, NeededPicks = 2, MaxFails = 3 },
        [1] = { Speed = 6, MaxRevs = 3, NeededPicks = 3, MaxFails = 2 },
        [2] = { Speed = 7, MaxRevs = 2, NeededPicks = 4, MaxFails = 2 },
        [3] = { Speed = 9, MaxRevs = 2, NeededPicks = 5, MaxFails = 1 },
    },
}
```

The minigame difficulty scales with the **Anti-Burglary Door** upgrade level on the target property:

| Door Level | Description                      |
| ---------- | -------------------------------- |
| `[0]`      | No upgrade - easiest.            |
| `[1]`      | Basic reinforced door.           |
| `[2]`      | Advanced security door.          |
| `[3]`      | Maximum security door - hardest. |

See [upgrades configuration](/paid-resources/rcore_housing/configuration/upgrades.md) for the matching door prices.

Lockpick animation and prop attachment (`prop_tool_screwdvr03` to bone `28422`) are also configured here.