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) |
OwnerInfo | true | admins aiming the laser at a scene see who placed it (name, identifier) and how long ago |
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 |
separateBuckets | true | a scene belongs to the routing bucket it was placed in; false: every bucket sees every scene |
With separateBuckets on, players only receive the scenes of their own bucket, and a player whose bucket changes
(entering an instance, apartment or character selection) gets the new set within about 2 seconds. Your own list
("My scenes") shows the scenes of your current bucket; scenes in other buckets still count toward your limit and
expire as usual. /scenepurge only removes scenes of the admin's bucket.
Moderation (Config.Moderation)
| Key | Default | Meaning |
|---|---|---|
blockedWords | {} | text that may not be placed or saved by edit, admins included |
Each entry is matched anywhere in the text, ignoring case (Turkish capitals and ı / i included), so 'ass' also
blocks 'class': list whole words or phrases. The editor shows the error before anything is sent; the server checks
again on every create and edit.
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 in your routing bucket (default 10 m, max 200) |
Config.Keybind: default key for /scene ('' = none; players bind it under Settings > Key Bindings > FiveM).