Installation

This page covers what nx_computer needs beyond the generic installation guide: its dependency set, the inventory items, admin access, and the banking backend choice.

Dependencies

Start order

nx-3d must start before nx_computer, and both after the ox stack:

ensure ox_lib
ensure oxmysql
ensure ox_inventory
ensure ox_target

ensure nx-3d
ensure nx_computer

Database: no import required

Every table is created and updated automatically the first time the resource starts. Each server module runs an idempotent schema check on boot and stamps a version marker into nx_computer_meta. The bundled nx_computer.sql is a reference index of the tables for DBAs, not an import script.

The database user configured in oxmysql must be allowed to CREATE TABLE and ALTER TABLE.

Inventory items

Add these to ox_inventory/data/items.lua. The item names must match their keys in config.lua (Config.LaptopItem, Config.Projector.Item, Config.Camera.ItemName, Config.Darknet.AccessItem). QB and QBox servers running ox_inventory register items in the same file, so the snippets apply on every framework.

-- Required: the laptop itself (Config.LaptopItem = 'laptop').
["laptop"] = {
    label = "Laptop",
    weight = 1000,
    stack = false,           -- each laptop is its own computer; never stack
    close = true,
    description = "A personal computer. Invest, message, browse, and more.",
    client = { event = 'nx_computer:client:useLaptop' }
},

-- Optional: ceiling-mounted projector, a third display
-- (Config.Projector.Item = 'projector').
["projector"] = {
    label = "Projector",
    weight = 2000,
    stack = true,
    close = true,
    description = "Mounts to a ceiling and casts your laptop onto the wall.",
    client = { event = 'nx_computer:client:useProjector' }
},

-- Optional: in-world camera (Config.Camera.ItemName = 'camera').
-- Uses an export, not an event. Requires the screencapture resource.
["camera"] = {
    label = "Camera",
    weight = 500,
    stack = false,
    close = true,
    description = "Take photos that sync to your laptop's Photos app.",
    client = { export = 'nx_computer.useCamera' }
},

Darknet access item. The Darknet app requires the player to carry Config.Darknet.AccessItem (default 'usb'). It is a presence check only, so no client hook is needed. If your server has no usb item, register one, point AccessItem at an existing item, or set Config.Darknet.Enabled = false.

First configuration

Confirm two settings in config.lua before first start:

• Config.Framework: 'esx', 'qbcore', or 'qbox' ('qbx' is accepted as an alias). The framework core must start before nx_computer.
• Config.Locale: one of en, fi, de, fr, pt-br, es, tr, nl, it, pl. Unknown values fall back to English.

Both files survive updates: config.lua and config_server.lua are excluded from escrow.

Image uploads (Photos, avatars, site images). Uploads relay through FiveManage using a server-side token. Create an Images token in the FiveManage dashboard and set Config.Media.FiveManageToken in config_server.lua. Leave it empty to keep uploads disabled; the rest of the laptop works regardless. Keep the token in config_server.lua only. It is a secret, and config.lua downloads to every client.

Admin access (ACE)

The admin Console app and admin actions (remote PIN reset, device wipe and lock, policy overrides) require the nx_computer.admin ACE:

# Grant to your admin group...
add_ace group.admin nx_computer.admin allow

# ...or to a specific person:
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.admin

The broad command ACE is not accepted by default because it is often granted to non-admin console principals. Set Config.AllowCommandAceAdmin = true only if you intentionally want command-ACE holders to be nx_computer admins.

Banking backend

Config.Banking.Backend selects how the Banking app moves money:

• 'auto' (default): use nx_realbanking automatically when that resource is started, otherwise fall back to native framework banking.
• 'framework': your framework's own cash and bank accounts. Transfers are addressed by @handle. No external dependency.
• 'realbanking': bridge to nx_realbanking (per-character accounts, invoices, credit). Requires nx_realbanking to be started; without it the app shows a clean "not configured" state and the boot self-check warns.

Servers on a custom framework (Config.Framework = 'custom') supply a money adapter via Config.Banking.Adapter instead. See Configuration for the adapter shape.

Troubleshooting

On start, nx_computer prints a configuration self-check to the server console. Each warning names the exact Config key at fault.

External calls

Fonts are self-hosted; there are no runtime CDN font dependencies. The only optional outbound call is the Exchange chart widget. If your server blocks egress, the chart degrades gracefully and the rest of the app, including the price data behind it, continues to work locally. The optional Satellite and Grid map styles stay off unless you set Config.MapTileCDN.