# removeCinematicActor (Client)

> Takes an actor, with its take, out of the cinematic.

- **Platform**: MY Multiplayer (MYMP)
- **Kind**: Lua Function
- **Side**: Client
- **Category**: Cinematics
- **URL**: https://wiki.mymp.gg/en/removeCinematicActor

## Syntax

```lua
bool removeCinematicActor(cinematic cinematic, string slot)
```

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `cinematic` | `cinematic` | The cinematic. |
| `slot` | `string` | The actor's name. |

## Returns

`true` if it was removed. `false` if the actor does not exist, the cinematic is recording or something still refers to it, with a warning saying why.

An actor is not removed while a camera shot follows or looks at it, a sound is spoken by it or another actor gets into it (a vehicle) in its take.

## Example

```lua
local intro = createCinematic("cinematics/intro.cine")
if not removeCinematicActor(intro, "extra") then
    outputDebugString("the extra is still in a shot or a sound")
end
```

## See also

- [getCinematicActors (Client)](https://wiki.mymp.gg/en/getCinematicActors.md): Lists the cinematic's actors: the recorded ones and the placed ones.
- [setCinematicProp (Client)](https://wiki.mymp.gg/en/setCinematicProp.md): Places a vehicle or object that stands still over a part of the cinematic, or changes one already placed.
- [setCinematicCamera (Client)](https://wiki.mymp.gg/en/setCinematicCamera.md): Sets the camera shots the cinematic directs during playback. It replaces the earlier shots.
