Nitro-V3/docs/secure-runtime-modes.en.md

Secure runtime modes

This document summarizes all values you may need to configure for:

• dist bundle obfuscation (app.js / app.css → .dat)
• secure runtime assets (renderer-config.json, ui-config.json, gamedata)
• secure runtime API (/api/*)
• plain fallbacks when you want to disable the secure layer without removing the code

1. Nitro-V3/public/client-mode.json

This file controls everything at runtime.

{
    "distObfuscationEnabled": true,
    "secureAssetsEnabled": true,
    "secureApiEnabled": true,
    "apiBaseUrl": "https://nitro.slogga.it:2096",
    "plainConfigBaseUrl": "https://hotel.slogga.it/",
    "plainGamedataBaseUrl": "https://hotel.slogga.it/client/nitro/gamedata/"
}

Fields

• distObfuscationEnabled

  • true: asset-loader.js loads app.css.dat and app.js.dat
  • false: it loads plain assets/app.css and assets/app.js

• secureAssetsEnabled

  • true: bootstrap.ts and secure-assets.ts use /nitro-sec/file
  • false: renderer-config.json, ui-config.json, and gamedata are loaded in plain mode

• secureApiEnabled

  • true: the fetch wrapper encrypts /api/* requests
  • false: /api/* requests stay plain

• apiBaseUrl

  • Nitro emulator / API base URL
  • example: https://nitro.slogga.it:2096
  • it is best to always set this explicitly, so you do not depend on the hardcoded fallback

• plainConfigBaseUrl

  • base URL for plain config files
  • usually: https://hotel.slogga.it/

• plainGamedataBaseUrl

  • base URL for plain gamedata files
  • usually: https://hotel.slogga.it/client/nitro/gamedata/

2. Nitro-V3/src/bootstrap.ts

bootstrap.ts:

• installs the secure fetch wrapper
• reads window.__nitroClientMode
• builds NitroConfig['config.urls']

Current behavior

• if secureAssetsEnabled=true

  • it uses secureUrl('config', 'renderer-config.json', true)
  • it uses secureUrl('config', 'ui-config.json', true)

• if secureAssetsEnabled=false

  • it uses plain files with cache busting (?v=...)

Important note

The current fallback is:

(window as any).NitroSecureApiUrl = clientMode.apiBaseUrl || 'http://192.168.1.52:2096/';

So in production it is better to always set apiBaseUrl inside client-mode.json.

3. Nitro-V3/src/secure-assets.ts

This file contains the runtime logic for:

• ECDH bootstrap
• asset decrypt/encrypt
• secure /api/*
• plain fallback when the toggles are disabled

In practice

• it reads flags from window.__nitroClientMode
• if secureAssetsEnabled=false
  • it automatically rewrites /nitro-sec/file?... into plain URLs
• if secureApiEnabled=false
  • it does not encrypt /api/*

Normally you should not need to touch it unless you want to change the secure protocol itself.

4. Nitro-V3/public/renderer-config.json

This file still defines the paths used by the renderer.

Things to check

• api.url
• socket.url
• gamedata.url
• external.texts.url
• external.texts.translation.url
• furnidata.url
• furnidata.translation.url

With secure assets enabled

You can use:

"gamedata.url": "https://nitro.slogga.it:2096/nitro-sec/file?kind=gamedata&file="

and the equivalent secure URLs for the other gamedata resources.

With secure assets disabled

You can use plain classic paths, for example:

"gamedata.url": "https://hotel.slogga.it/client/nitro/gamedata"

or you can keep the renderer config as-is and let secure-assets.ts handle the fallback conversion.

5. Nitro-V3/public/ui-config.json

There is no secure logic here, but it is one of the files loaded through config.urls.

If secureAssetsEnabled=true, it is served from /nitro-sec/file. If secureAssetsEnabled=false, it is loaded from the static file with ?v=....

So you only need to maintain the content itself correctly.

6. Nitro-V3/scripts/write-asset-loader.mjs

This script generates public/asset-loader.js.

What it does now

• renders the initial shell
• reads client-mode.json
• decides whether to load:
  • app.css.dat / app.js.dat
  • or assets/app.css / assets/app.js

Important

If you modify this script, the updated loader is regenerated on the next:

yarn build

because package.json already contains:

"prebuild": "node scripts/write-asset-loader.mjs"

7. Nitro-V3/scripts/minify-dist.mjs

This script now:

• generates the .dat files
• keeps the original app.css and app.js files too

This is required, otherwise distObfuscationEnabled=false would not have a working fallback.

8. Arcturus-Morningstar-Extended/Latest_Compiled_Version/config.ini.example

The current backend flags are:

nitro.secure.assets.enabled=true
nitro.secure.api.enabled=true
nitro.secure.config.root=
nitro.secure.gamedata.root=
nitro.secure.master_key=change-me-to-a-long-random-secret

Meaning

• nitro.secure.assets.enabled

  • enables /nitro-sec/bootstrap and /nitro-sec/file

• nitro.secure.api.enabled

  • enables the secure layer for /api/*

• nitro.secure.config.root

  • folder used to read renderer-config.json and ui-config.json

• nitro.secure.gamedata.root

  • folder used to read live gamedata

• nitro.secure.master_key

  • persistent server-side secret
  • especially important when running behind Cloudflare / multiple backend requests

9. Example setups

Everything enabled

client-mode.json

{
    "distObfuscationEnabled": true,
    "secureAssetsEnabled": true,
    "secureApiEnabled": true,
    "apiBaseUrl": "https://nitro.slogga.it:2096",
    "plainConfigBaseUrl": "https://hotel.slogga.it/",
    "plainGamedataBaseUrl": "https://hotel.slogga.it/client/nitro/gamedata/"
}

config.ini

nitro.secure.assets.enabled=true
nitro.secure.api.enabled=true
nitro.secure.config.root=C:/inetpub/wwwroot/paxxo/nitro
nitro.secure.gamedata.root=C:/inetpub/wwwroot/paxxo/nitro/client/nitro/gamedata
nitro.secure.master_key=a-long-random-secret

.dat only, no secure assets/API

client-mode.json

{
    "distObfuscationEnabled": true,
    "secureAssetsEnabled": false,
    "secureApiEnabled": false,
    "apiBaseUrl": "https://nitro.slogga.it:2096",
    "plainConfigBaseUrl": "https://hotel.slogga.it/",
    "plainGamedataBaseUrl": "https://hotel.slogga.it/client/nitro/gamedata/"
}

config.ini

nitro.secure.assets.enabled=false
nitro.secure.api.enabled=false

Everything plain

client-mode.json

{
    "distObfuscationEnabled": false,
    "secureAssetsEnabled": false,
    "secureApiEnabled": false,
    "apiBaseUrl": "https://nitro.slogga.it:2096",
    "plainConfigBaseUrl": "https://hotel.slogga.it/",
    "plainGamedataBaseUrl": "https://hotel.slogga.it/client/nitro/gamedata/"
}

10. When rebuild is required

No rebuild required

For changes to:

• client-mode.json
• renderer-config.json
• ui-config.json
• live gamedata
• config.ini

Rebuild required

For changes to:

• src/bootstrap.ts
• src/secure-assets.ts
• scripts/write-asset-loader.mjs
• scripts/minify-dist.mjs

11. Deployment note

To make the toggles work properly:

• always deploy both plain files and .dat files
• make sure IIS / your host serves the .dat MIME type
• if you disable secure mode on the client, disable it on the backend too for consistency

12. Quick checklist

• client-mode.json configured
• apiBaseUrl correct
• nitro.secure.master_key set
• nitro.secure.config.root correct
• nitro.secure.gamedata.root correct
• both .dat and plain files deployed
• .dat MIME type configured on the web server