Configuration

All options live in config.lua. Everything ships with working defaults.

General

Option	Default	What it does
Config.Debug	false	F8 debug logging.
Config.CommandName	'cutscenes'	The chat command that opens the browser.
Config.MenuTitle	'Cutscene Browser'	UI header text.
Config.MenuSubtitle	'Developer Tools - DZR Development'	UI subheader text.

Permissions

Option	Default	What it does
Config.RequireAce	false	Require the ACE to OPEN the browser.
Config.SharedWritesRequireAce	true	Require the ACE for server-wide writes (compatibility flags, renames, resets). Anyone can still browse and play.
Config.AcePermission	'cutscenes.use'	The ACE name used by both checks.

Browser

Option	Default	What it does
Config.PageSize	20	Results per page.
Config.RecentLimit	10	Recents kept per player.

Playback

Option	Default	What it does
Config.UseFades	true	Fade the screen around playback to hide load pop-in and the cut.
Config.FadeTime	250	Fade duration in milliseconds.
Config.OverrideTimecycle	true	Clear any active timecycle modifier before the cutscene.
Config.ForceHighLOD	true	Force high level-of-detail during playback.
Config.CutsceneLoadTimeout	15000	Give up loading a cutscene after this many milliseconds.
Config.CutsceneStartTimeout	3000	Give up if a loaded cutscene does not start within this window.
Config.StopControlCodes	{177, 178}	Control codes that stop playback (177 = Backspace, 178 = Delete).
Config.ResourceCutsceneFile	'data/cutscenes_List.json'	The catalogued cutscene list.

Display names

Option	Default	What it does
Config.DisplayNames.Enabled	true	Master toggle for renaming.
Config.DisplayNames.MaxLength	32	Maximum characters per name.
Config.DisplayNames.ValidationPattern	"^[A-Za-z0-9 _'-]+$"	Allowed characters.
Config.DisplayNames.ThrottleCooldown	750	Minimum milliseconds between renames per player.

Data storage

State is stored as JSON in the resource's data/ folder, created on first run. No database and no telemetry.

File	Contents
cutscenes_List.json	The catalogued cutscene list (shipped).
cutscenes_PlayerData.json	Per-player favorites and recents, keyed by license.
cutscenes_Compatibility.json	Server-wide working/broken flags.
cutscenes_DisplayNames.json	Server-wide custom names.

Everything persists across restarts. Deleting a file resets that piece of state on the next start.