# PoliceRaidDoor

{% code title="Usage" %}

```lua
exports.nolag_properties:PoliceRaidDoor()
```

{% endcode %}

## Returns

* `boolean` - Returns `true` if the raid process has been successfully triggered on a valid MLO door, or `false` if no valid target was found or the action could not be started.

## Usage Example

{% code title="example.lua" %}

```lua
local success = exports.nolag_properties:PoliceRaidDoor()

if success then
    print("Raid started with stormram.")
else
    print("No valid MLO door found or raid could not be initiated.")
end
```

{% endcode %}

## Description

This export is used to trigger a forced police raid on an MLO property door handled by **nolag\_properties**.

It should be called when a player uses a `stormram` item (for example, inside your inventory usable item callback). Once executed, the system will:

{% stepper %}
{% step %}

### Check proximity

Verify if the player is near a valid MLO property door.
{% endstep %}

{% step %}

### Verify lock state

Ensure the door is currently locked.
{% endstep %}

{% step %}

### Trigger raid logic

Start the configured raid/breach logic (animation, progress, sound, etc., depending on your setup).
{% endstep %}
{% endstepper %}

If all conditions are met, the door breaching process will begin. If the player is not targeting a valid MLO door, the export will return `false` and no action will be triggered.

{% hint style="warning" %}
This export is intended for law enforcement jobs and should be restricted accordingly within your framework (e.g., job checks, grade requirements, or permission validation before allowing the item usage).
{% endhint %}