Installation — ns-scenes

1. Copy the ns-scenes folder into your server's resources.

2. server.cfg, after oxmysql (and ox_lib if you use it):

   ensure ns-scenes
   add_ace group.admin ns-scenes.admin allow
   

   Copy

3. Optional Discord log: set Config.Features.Logs = true and add the webhook as a server convar (it never reaches clients):

   set ns_scenes_webhook "https://discord.com/api/webhooks/..."
   

   Copy

4. Start the server. The table ns_scenes is created automatically (Config.Database.autoMigrate = true). With autoMigrate = false, import sql/ns-scenes.sql first.

Updating from 0.x

Replace the folder and keep your config.lua changes; add the new Config.Scenes.separateBuckets, Config.Moderation and Config.Features.OwnerInfo entries from the new config.lua. With autoMigrate = true the new bucket column is added on start (existing scenes go to bucket 0, the normal world). With autoMigrate = false run this once:

ALTER TABLE `ns_scenes` ADD COLUMN `bucket` INT NOT NULL DEFAULT 0 AFTER `mode`;
UPDATE `ns_scenes_meta` SET `value` = '2' WHERE `key` = 'schema_version';

Verify

• Console: [ns-scenes:SV] N scenes loaded and ready (framework=...).
• In game: /scene, aim at a wall, the laser turns orange and a ghost "YOUR TEXT" appears. Press E, type, Place.
• Walk away: the text fades out at its view distance and comes back when you return.

Troubleshooting