# playCinematic (Client)

> Plays the cinematic: the actors as local clones, plus the camera, weather, hour, fade, sounds and captions.

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

## Syntax

```lua
bool playCinematic(cinematic cinematic [, int from = 0])
```

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `cinematic` | `cinematic` | The cinematic. |
| `from` | `int` | Cinematic time, in ms, to start from. *(default: `0`)* |

## Returns

`true` if it started, `false` if the cinematic is recording, already playing or empty.

Each actor is a local ped or vehicle that stands where its take puts it on every frame. When it ends, the weather, hour and fade go back to what the world had, and `onClientCinematicFinish` fires.

## Example

```lua
local intro = createCinematic("cinematics/intro.cine")

addCommandHandler("intro", function()
    playCinematic(intro)
end)
```

## See also

- [stopCinematic (Client)](https://wiki.mymp.gg/en/stopCinematic.md): Stops the cinematic's playback. The clones go away and the weather, hour and fade go back to what the world had.
- [setCinematicPaused (Client)](https://wiki.mymp.gg/en/setCinematicPaused.md): Pauses or resumes the cinematic's playback. While paused, the clones hold their animations, vehicles freeze and sounds pause.
- [setCinematicPosition (Client)](https://wiki.mymp.gg/en/setCinematicPosition.md): Jumps the playback to another time of the cinematic. The clones are kept; each is set back on its sample and in or out of its vehicle as its take has it.
- [onClientCinematicFinish (Client)](https://wiki.mymp.gg/en/onClientCinematicFinish.md): Fired when a cinematic's playback reaches its end by itself.