> 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/features/raid-and-lockpick.md).

# Raid and Lockpick

Two pathways exist for getting into a locked property: a player breaking in with a lockpick, and a police raid using a battering ram.

## 🗝️ Player Lockpicking

A player on duty with a `lockpick` item in inventory can attempt to lockpick a property door:

1. Walk up to the door's lock interaction.
2. The lockpick minigame opens with a difficulty that scales by the property's Anti-Burglary Door upgrade level.
3. Succeed → the door unlocks for a short window. Fail → the alarm event fires (see [Alarm System](/paid-resources/rcore_housing/features/alarm-system.md)).

Lockpick rules live in [raid configuration](/paid-resources/rcore_housing/configuration/raid.md):

```lua
Config.Raid.Lockpick = {
    RequireItem        = true,
    Item               = 'lockpick',
    RemoveItemAfterUse = false,
}
```

Set `RemoveItemAfterUse = true` to consume the lockpick on success.

## 🚓 Police Raid

A police officer (job in `Config.Raid.PoliceJobs`) can initiate a raid:

1. Walk to the property's entry.
2. Trigger the raid action from your dispatch tool of choice (target / context menu).
3. If `Config.Warrant.Enable = true`, the officer must carry a `warrant` item.
4. If `Config.Raid.RequiredPolice > 0`, enough officers must be on duty.
5. A lockdown barrier (`prop_barrier_work05`) spawns at the entry while the raid is active.

## 🔨 Breach

If the door is locked, the officer breaches with the battering ram:

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

The breach minigame has fixed difficulty - it doesn't scale with door level (the door upgrade only affects player lockpicking).

## ⚠️ Owner-Online Requirement

```lua
Config.Raid.RequirePropertyOwnerOnline = false
```

Set to `true` to block raids when the owner is offline. Useful if you want to ensure raids only happen in active RP situations.

## 🚧 Lockdown

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

The barrier prop is removed automatically when the raid ends.