🎞️dzr-cutscenes

Usage

After installation, join your server and type:

/cutscenes

This opens the full cutscene browser. Cutscenes start immediately when selected, and you can stop them at any time using the controls below.

If a cutscene does nothing, it may require a specific location or be one of the broken or unsupported sequences. Use the compatibility markers to track them.

---

Controls

Action	Key / Command
Open menu	/cutscenes
Stop cutscene	Backspace or Delete
Close menu	ESC or X button
Emergency stop	/stopcutscene

Note: ESC is disabled while a cutscene is playing.

---

Features

• Browse 750+ cutscenes

• Favorites list

• Recents history

• Random cutscene option

• Manual name entry

• Custom display names

• Compatibility tracking (working/broken)

---

ACE Permissions (Optional)

By default, everyone can use the menu (Config.RequireAce = false).

To restrict access:

1. Edit config.lua:

   Config.RequireAce = true
   Config.AcePermission = 'cutscenes.use'

2. In server.cfg, allow access:

   add_ace group.admin cutscenes.use allow

Replace group.admin with your server’s admin group.

---

Data Storage

All data is stored in the resource’s data/ folder:

File	Purpose
cutscenes_PlayerData.json	Favorites & recents (per player)
cutscenes_Compatibility.json	Working/broken status
cutscenes_DisplayNames.json	Custom display names
cutscenes_List.json	Master cutscene catalog

---

Troubleshooting

Problem	Fix
Menu won’t open	Check F8/server console errors; confirm ensure dzr-cutscenes
Cutscene won’t play	Some require specific map positions; try another
Data not saving	Check file permissions for data/
ACE not working	Make sure your identifier is in the correct group

---

Exports (Developer API)

-- Play a cutscene
exports['dzr-cutscenes']:PlayCutscene('family_1_int')

-- Stop the current cutscene
exports['dzr-cutscenes']:StopCutscene()

-- Get all cutscene names
local list = exports['dzr-cutscenes']:GetCutsceneList()

-- Check if a cutscene is active
local active = exports['dzr-cutscenes']:IsCutsceneActive()

-- Get the name of the active cutscene
local name = exports['dzr-cutscenes']:GetCurrentCutscene()

---

Support

• Website: https://dzrdevelopment.com

• Store: https://dzrdevelopment.tebex.io

© 2025 DZR Development