Electus Computers Guides

Admin panel

/computersadmin opens the admin panel for players with the electus_computers.admin ACE or a framework group in Config.Admin.groups. Admins can manage computers, computer presets and businesses, find a computer by aiming at its prop, and remove a computer's password.

-- config/system/admin.lua
Config.Admin = {
    enabled = true, -- false removes the admin command and denies every admin action
    command = "computersadmin",
    ace = "electus_computers.admin",
    groups = { "admin", "superadmin" },
}

add_ace group.admin electus_computers.admin allow

Computers and devices

Every computer carries a serial number and keeps its own files, apps and settings. A new computer starts with a short setup where players name it and pick a wallpaper. Default apps and settings for new laptops are in config/laptop.lua.

Screens are replicated to nearby players, so others can watch someone use a computer. Tune distance, update rate and how many screens render at once in Config.Computer.replication (config/computer.lua).

Networking

Network apps such as the Browser, Mail, Cloud Drive, wallet and App Store only open while the computer is connected.

Set Config.Wifi.requireConnectionForApps = false to give every computer an always-on connection. Routers, SIM cards and laptop wifi cards then have no purpose.

USB devices and cables

Players plug USB drives, antennas and SIM cards into a computer, and connect computers, printers and card terminals with cables through Manage ports. Cables stay plugged in for everyone, across restarts, until someone unplugs them.

Drive sizes and cable lengths are in config/devices/usb.lua. Antenna ranges are in config/hacking/call_intercept.lua and config/hacking/radio_intercept.lua.

Software store

Players buy apps in the in-game App Store and install them on the computer they are using. Every app takes disk space, and the server refuses installs that don't fit.

Prices are set in config/apps/software.lua in C-coin (Config.Crypto.asset). 0 is free.

Config.Software = {
    apps = {
        ["port-breacher"] = { title = L("lua.software.port_breacher"), price = 9, storageGb = 3 },
        ["vpn"] = { title = L("lua.software.vpn"), price = 14, storageGb = 1.5 },
    },
}

To add your own app to the store, see Desktop apps.

Businesses and card terminals

Business presets in Config.Business.presets (config/apps/business.lua) give a job a Business app with a catalog, orders, bookings and a Checkout page. Each catalog item has a supplier price and a customer sellPrice (0 means not for sale).

To take a payment:

1. An employee rings up the sale on the Business app's Checkout page.
2. The customer pays on a card terminal cabled to that computer. Payment methods are in Config.CardTerminal.methods.
3. The money is paid into the business's account through Electus Core's company money system.

The customer can ask for a paper receipt on the approved screen. It prints and goes into their inventory.

With storefrontEnabled = true, a business also gets a public website in the Browser app where customers place orders and book services. Requests land in the Business app as pending. No money changes hands online.

Shop clerks

Config.Stores (config/apps/stores.lua) places NPC clerks with their own shop screen. A clerk tied to a business sells its stock first, at its sell prices times markup, paid into that business.

Digital Den without the map

The Digital Den business, counter computer, card terminal, shop clerk and repair bench are positioned for the electus_digital_den map. Without that map, remove or move:

Laptop hardware and repair

Laptops have parts that wear down, break and can be repaired or upgraded at a repair bench. Desktops, TVs and world screens have none. Everything is in config/laptop_hardware.lua, and every section can be turned off. With Config.LaptopHardware.enabled = false, laptops behave as if the feature did not exist.

Parts lose condition while the laptop is on, and accidents damage them: water, drops and failed hacks. A broken processor, drive or display stops the laptop from booting, and a dead battery needs a plug. Placed laptops count as plugged in and charge.

Technicians with the bench's job open the laptop at a repair bench and swap parts. With repair.selfService.enabled, customers can restore worn parts themselves for a price while no employee is on duty. Broken parts and upgrades always need a technician.

Hacking and heat

Hacking programs are bought in the App Store and installed on a specific computer. Each one runs its own minigame, configured in Config.HackingApps (config/hacking/hacking.lua).

The server only accepts a result for a hack it started, finished by the same player after a plausible time. Config.HackSessions sets the minimum solve time and how long a result stays valid.

Heat

Heat builds up on a computer as players hack (Config.Heat in config/hacking/heat.lua) and cools down over time. Computers at or above policeThreshold show on the police terminal and trigger a dispatch alert through Config.DispatchSystem. Without a dispatch script, every on-duty player in Config.Police.jobs gets a notification and a blip.

A VPN reduces the heat a computer gains by Config.Heat.vpn.reductionPercent.

Police tools

The police app, its tracking map, phone lookups and the evidence board are limited to the jobs and minimum grades in Config.Police.jobs (config/hacking/police.lua).

Config.Police = {
    jobs = {
        police = 0,
        sheriff = 0,
    },
}

The vehicle finder reads owned vehicles from Config.Police.vehicleTables. ESX (owned_vehicles) and QBCore (player_vehicles) tables are both listed, and missing tables are skipped.

Phone integration

Set Config.PhoneSystem to "lb-phone", "roadphone", "yseries" or "none", and Config.PhoneSystemResource to the phone's resource name. Restart electus_computers after changing it.

RoadPhone and YSeries pair with a six-digit code texted from Config.PhoneServiceNumber. Keep that number shorter than player numbers so it can never be a real phone. Their texts are copied into a message log for history and SMS Dump, starting when Electus Computers is installed.

Logs

Set the log service in config/system/logs_admin.lua:

Config.Logs = {
    Enabled = true,
    Service = "discord", -- "discord", "ox_lib", "fivemanage"
    categories = {
        admin = true,
        purchase = true,
        money = true,
        hacking = true,
        police = true,
        security = true,
        hardware = true,
    },
}

For Discord, set the webhook in server.cfg, never in the config:

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

Data retention

Expired Cloud Drive sessions and share links, uncollected prints, police vehicle sightings, cooled-down heat and old copied phone texts are cleaned up in the background. Player computers, files, notes, mail and accounts are never removed for being old.

Tune each category in config/system/retention.lua, or set false to keep it forever. abandonedComputers can remove player-placed computers nobody has opened for a number of days. It is off by default.

Translations

All text is in config/locales/en.lua. Copy it, translate it and set Config.Locale in config/config.lua. Missing keys fall back to English.