Configuration — ns-scenes
Everything is in config.lua (stays editable under escrow).
General
| Key | Default | Meaning |
|---|
Config.Framework | 'auto' | qbox, qbcore, esx or standalone |
Config.Locale | 'en' | en / tr (add locales/<code>.lua for more) |
Config.Debug | false | debug log in the console |
Features (Config.Features)
| Key | Default | Meaning |
|---|
FreeMode | true | 3D text standing in the air, turned / tilted freely, readable from both sides |
FloatMode | true | free-standing text that turns to the viewer |
Effects | true | pulse / flicker (off: stored as still) |
Editing | true | change text, look or position of a placed scene |
Logs | false | Discord log (webhook in the ns_scenes_webhook convar) |
Who may place (Config.Permission)
| Key | Meaning |
|---|
mode | everyone, ace (needs ace) or job (job name = minimum grade in jobs) |
ace | e.g. add_ace group.user ns-scenes.create allow |
jobs | { police = 0, ambulance = 0 } |
Admins (Config.Admin.ace, default ns-scenes.admin, or framework admin) always may and have no limit or cooldown.
Rules (Config.Scenes)
| Key | Default | Meaning |
|---|
maxPerPlayer | 5 | active scenes per character |
maxTotal | 600 | active scenes on the server |
maxLines / maxLineLength | 3 / 40 | text limits (characters, Turkish letters count as one) |
placeDistance | 8.0 | metres from the player the laser may place |
createCooldown | 10 | seconds between two new scenes of one character |
durations / defaultDuration | {1,3,6,12,24} / 6 | hours offered |
adminPermanent | true | admins may choose "always" |
size | 0.2–1.2, 0.4 | metres: height of the text block |
viewDistance | 3–30, 12 | metres the scene is seen from |
Look (Config.Style)
fonts, backgrounds, effects: remove an entry to take it out of the editor (the server refuses it too).
A scene saved with a font you removed later is shown with default. palette: the colour swatches (any #rrggbb
is also allowed through the custom colour picker).
Drawing (Config.Render)
| Key | Default | Meaning |
|---|
maxVisible | 15 | scenes drawn at once (closest first, at most 15) |
scanInterval | 1000 | ms between "what is near" checks when nothing is near |
fadeShare | 0.25 | last share of the view distance used to fade out |
releaseAfter | 30 | seconds without a near scene before the texture is freed |
Laser (Config.Laser)
Colours (color, blocked), rotateStep (degrees per wheel step), sizeStep, floatHeight range,
freeReach (3D mode: min / max / default metres in front of you, step per Alt + wheel step).
Commands (Config.Commands)
| Command | Who | Does |
|---|
/scene | everyone | laser: place, edit (E), delete (DEL twice), leave (Backspace / right mouse / ESC) |
/scenehide | everyone | hide / show all scenes for yourself (remembered) |
/scenepurge [radius] | admin | remove every scene within radius (default 10 m, max 200) |
Config.Keybind: default key for /scene ('' = none; players bind it under Settings > Key Bindings > FiveM).
