> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Despawn Mob

> Despawns BTCMobs entities.

The `despawn_btcmobs_mob` action removes BTCMobs entities from the world. You can target specific mob types and control the scope of removal.

## Configuration

<ResponseField name="despawn_btcmobs_mob" type="Map" required>
  Configuration for the despawn mob action.

  <Expandable title="Properties">
    <ResponseField name="mobName" type="String" required>
      The internal name of the BTCMob type to despawn.
    </ResponseField>

    <ResponseField name="despawnAll" type="Boolean">
      If `true`, despawns all instances of this mob type in the context (e.g., near the player). If `false`, behavior depends on implementation (often removes the most recent or nearest).
    </ResponseField>
  </Expandable>
</ResponseField>

## Examples

```yaml theme={null}
# Remove all "Rat" mobs
despawn_btcmobs_mob:
  mobName: "Rat"
  despawnAll: true
```