Jixryo Cameras

Jixryo Cameras puts security camera networks anywhere on the map. Techno Unlimited technicians install home and business networks for customers, and each police department has a city network that goes up from the MDT or by officers with the camera unit. Owners, the people they share with, and officers for their department's cameras watch them live on the Jixryo Tablet, and the police inside the MDT's Cameras page too.

#What players get

• A network is a router, its cameras and the people who may watch them. Home and business networks have an owner, who can share them with up to 10 people, and run through a router. A police department has one city network with no router.
• Three camera styles, each its own model and all the same Security Camera unit from Techno Unlimited: Outdoor bullet (walls and poles, 30 m, fixed view, night vision), Corner dome (walls and corners, 20 m, turns 55° and tilts 20°, night vision) and Ceiling dome (indoors, flat on the ceiling, 14 m, wide, turns 70° and tilts 25°).
• Routers in three tiers: Basic $250, Secure $600, Pro $1,200. Cameras further than 85 m from their router are offline. GTA has no router model, so a small CCTV controller stands in.
• Offline, and why. The camera is damaged, the power is cut where it stands, it is out of the router's range, the router is damaged, or there is no router. A shot or rammed camera or router goes offline at once, its prop shows the damage, and the owner is told.
• Activity. People walking past and vehicles driving past a camera are logged per network, with the vehicle's make, plus damage and install notes. The last 200 lines per network are kept.
• Live view. The tablet goes away and the camera's feed takes the screen: scanlines, the camera's own direction, the mouse to turn on the styles that turn, scroll to zoom, right mouse for night vision (on by itself at night on the styles that have it), the arrow keys to the network's other cameras, Esc to leave. "Signal lost" if the camera goes offline while you watch. Not while you are driving, and taking damage ends the feed.
• The Cameras app on the tablet, for everyone: your networks, a grid of each one's cameras with live or offline and why, go live, the activity feed (everything, or only people, vehicles or damage; Watch jumps to that camera), rename a network or a camera, alerts on or off per network, share with someone standing next to you or stop sharing. Police see their department's network in it while on duty.
• Installs, for Techno Unlimited staff, as a page of the Techno Unlimited app (Work › Installs). New package: pick the customer standing with you (within 12 m), a router tier and up to 8 cameras; they see the offer on their own screen for 30 seconds and pay from their bank if they agree. The company account gets it and the technician their commission. Networks: put the router in (or move it, or take it out), mount cameras by style within its range (each takes one unit from your pockets) until the package is used, sell the owner more cameras, GPS to the router.
• Installing a camera (technician): sell the package with the customer next to you; put the router in (a see-through router follows your aim on any flat surface within 4 m, E places it); mount a camera (pick the style, aim at a wall, or a ceiling for the dome; the panel on the right shows the direction, tilt, height, distance to the router and what is left in the package; scroll turns it, the arrow keys tilt it, V looks through its lens, E walks up and mounts it over a 7-second progress bar). At a camera, the third eye offers Take the camera down (the unit comes back when it is intact and the package gets the slot back) and Swap in a new unit (fixes a damaged one).
• Police cameras. While Config.police.officersMount is on (the default), an on-duty officer uses the Security Camera unit, picks the style and places it the same way; it joins the department's network as PD-01, PD-02 and so on, up to 60. Police take down and repair their department's cameras at the camera. In the MDT, officers on duty see their department's cameras, watch one (Esc brings the MDT back), rename them and follow the activity; damage to one goes on every officer's bell.

#What staff get

• Department cameras from the MDT. Staff with group.god, group.admin or jixryo.security.admin open the MDT's Cameras page, pick a police department and a style, and Put one up. The tablet goes away, they aim and place it the same way, and it joins that department's network. No unit is needed, and they may watch every department's cameras.
• Officers' mounting is a switch. Set Config.police.officersMount = false and only staff put department cameras up; the unit then tells officers to ask staff.
• An audit trail in the suite's audit log through Jixryo Core: sales with their commission, extra cameras sold, router installs and moves, mounts, staff installs, take-downs, repairs and sharing.
• Power cuts for your scripts. SetBlackout cuts the power over a circle for a time; every camera inside, the department's included, is offline until it ends. Jixryo Prison uses it when its generator is killed.
• Nothing runs idle. Cameras and routers exist on a client only within 60 m of a player, spawned from points. Motion is checked by the clients near a camera every 1.5 seconds, and only while one is in range.

#Install

1. What it replaces. Nothing. It is new ground, and it takes over no stock camera resource.

2. Order. Start it after Jixryo Core, the tablet and the Techno Unlimited resources. Without jixryo_technounlimited_apps there are no installs (the Cameras app and police cameras still work); without the tablet there is no Cameras app. Neither Techno Unlimited resource is in the store today.

   ensure jixryo_core
   ensure jixryo_tablet
   ensure jixryo_technounlimited
   ensure jixryo_technounlimited_apps
   ensure jixryo_security

   Copy

   Its manifest also depends on ox_lib, oxmysql, qbx_core, ox_inventory and ox_target.

3. Items. The camera unit is Techno Unlimited's tu_security_cam; it must be in ox_inventory's items (it is in jixryo_technounlimited's README item list). Techno Unlimited makes it at its camera bench and sells it in its showroom.

4. Database. The tables jixryo_sec_networks, jixryo_sec_cameras and jixryo_sec_events are created on the first start, as a numbered Jixryo Core migration step.

5. The pages are prebuilt in web/build: index.html for the live view and the placement overlay, cameras.html for the Cameras app.

6. Restart the whole server, not just the resource.

#How other scripts' calls behave

• It answers as itself only. Its exports live under jixryo_security; it answers no other camera script's names.
• The MDT (Jixryo MDT 2.0 or later) builds its Cameras page from MdtCameras, MdtCameraSummary and MdtRenameCamera on the server and WatchCamera, InstallDepartmentCamera and PlaceName on the client, and hears a damaged department camera through the server event jixryo_security:server:deptTamper.
• The Techno Unlimited app (jixryo_technounlimited_apps) hands its Installs page's calls to the client export InstallCall and listens for jixryo_security:client:networkChanged to refresh. This resource asks that app for RequireStaff (who is TU staff), Payout (the company account and the technician's commission) and GetJob.
• The prison cuts the power with SetBlackout and ClearBlackout.
• It uses the tablet's AddApp, Notify, Open, Close, IsOpen, GetCurrentApp, SendAppMessage and SoundsOn; qbx_core's GetJobs and CreateUseableItem; ox_target's local entity options on the props; and Jixryo Core's HUD (notifications, sounds, progress bars, the customer's confirm), inventory, player money (from the bank, reason technounlimited-install), rate limits, validation and audit.
• Jobs. Police are the qbx_core jobs of type leo (Config.police.jobTypes), on duty. Techno Unlimited's job name comes from its apps resource.

#Its own API

Exports:

Events:

The app's own calls are jixryo_security:server:<name> callbacks and the net events jixryo_security:server:motion and jixryo_security:server:damaged. They are not an API, and the server checks every one.

#Commands and keybinds

There are no commands. The keys below work only while placing a camera or watching one; the Cameras app's keys are the tablet's.

#Configuration

config.lua holds every value the server decides with.

#Security

• Identity, ownership, sharing, the police department and TU staff are checked on the server for every call, from source. TU staff are checked through the Techno Unlimited app's RequireStaff.
• Placement. The client sends a spot and a direction; the server checks the coordinates, the reach (4 m plus a margin), the spacing to other cameras (1.5 m, counting spots being written), the router's range, what is left in the package or the department's 60, and that the unit is in your pockets. It takes the unit before it writes the camera, and gives it back if the write fails. A staff install from the MDT is checked the same way with no unit, plus staff and a real police department, and it is audited.
• The MDT exports re-check the player on every call: an on-duty officer sees only their own department's network, staff any.
• Installs. The customer's own answer, on their own screen, is the only yes; the price is worked out on the server and the customer is charged there, and refunded if writing the network fails. A customer answers one offer at a time.
• Motion is spotted by the clients near a camera (players only). The server checks the camera exists and is online, that the reporter is near it (84 m), the 30-second cooldown, and names what was seen itself; nothing a client writes is stored. Damage reports are checked the same way, and a damaged camera or router can be reported once until it is fixed.
• What clients learn about the world (where cameras and routers are, within 450 m) never carries an owner.
• The in-memory copy is the authority, loaded at start and written through on every change. Anything that removes something leaves memory before the database is waited on, so two requests never both succeed.
• Rate limits on every call. Sales with the commission (security.install.sell), extra cameras (security.install.add), router installs and moves (security.install.router), mounts (security.camera.mount), staff installs (security.camera.staff_install), take-downs (security.camera.remove), repairs (security.camera.repair) and sharing (security.share) go to the suite's audit log.
• The live view is granted by the server: the player must be allowed to watch the network, the camera must be online, and not while driving.

#Tests

Jixryo Cameras has no automated suite of its own. The MDT's suite (dev-tools/luarun/tests/jixryo_mdt.lua) checks the MDT's side of the camera exports through stand-ins that answer with this resource's real shapes, and that camera damage reaches the bell only when this resource fired the event. Its README asks for the live view to be checked in game: the lens positions of the three vanilla models are estimates.

#Check it in game

1. As a Techno Unlimited technician on duty, open Work › Installs with a customer standing next to you. Sell a Basic package with two cameras: the customer sees the offer on their screen and pays from their bank, and the network shows under Networks.
2. Put the router in: a see-through router follows your aim; E places it. The tablet comes back on Installs.
3. Mount a camera: pick Corner dome and aim at a wall. The panel shows the direction, tilt, height and the distance to the router. Scroll turns it, the arrows tilt it, V looks through the lens, E mounts it. It shows up and online.
4. As the customer, open Cameras on the tablet: the network, its cameras, go live. The feed takes the screen; the mouse turns the dome, scroll zooms, right mouse switches night vision, Esc brings the tablet back on Cameras.
5. Walk past the camera as another player: the activity logs a person and the owner is told. Drive past: a vehicle, with its make.
6. Share the network with someone standing next to you: they see it in their Cameras app. Stop sharing and it goes.
7. Shoot the camera: it goes offline (damaged), its prop hangs at an angle, and the owner is told. At the camera, third eye, Swap in a new unit: it is back online.
8. As an on-duty officer, use the Security Camera unit: pick a style, aim and mount. It joins the department network as PD-01. In the MDT's Cameras page, watch it; Esc brings the MDT back.
9. As staff, from the MDT's Cameras page, pick a department and a style and Put one up: no unit is needed.
10. Kill the prison generator (Jixryo Prison): cameras in the area go offline ("no power") and come back when the power does.