Systems Overview

Architecture, config flags, pharmacies, insurance, supplies, bans, and records

Architecture and escrow

Open files handle most integration work.

Key files:

• shared/config.lua covers jobs, meds, pharmacies, insurance, supplies, bans, permissions, notify, and TextUI.

• shared/lang.lua stores UI strings and metadata description templates.

• client/client_open.lua handles animations, overdose, lean, panic hooks, shoplifting hooks, and client-side vehicle keys.

• server/server_open.lua handles Discord logging, metadata building, medication helpers, and server-side vehicle keys.

• server/insurance.lua and client/insurance.lua handle plans, payments, claims, and self-service insurance UI.

• server/insurance_broker.lua and client/insurance_broker.lua handle broker sales, commissions, and insurance bans.

• server/pharmacy_supplies.lua and client/pharmacy_supplies.lua handle stock, restocks, and supply reduction.

• server/prescription_records.lua manages DB prescription records and flagging.

• server/employee_computer.lua and client/employee_computer.lua power the staff computer.

• server/shoplifting.lua and client/shoplifting.lua handle shelf loot, detection, and bans.

Escrow keeps the core flow files protected.

The main open integration files are still available for your server-specific hooks.

Critical config flags

These values change behavior fast:

• Config.TestMode

• Config.Debug

• Config.PayIntoSociety

• Config.PayIntoInsuranceSociety

• Config.Target

• Config.ServerSidePeds

Leave Config.TestMode off on live servers.

It changes how writing and test commands behave.

Database

Representative tables used by the system:

• prescription_records

• pharmacy_supplies

• medical_insurance

• medical_insurance_claims

• pharmacy_bans

• med_insurance_commissions

• med_insurance_bans

Config.DatabaseCleanup handles retention for claims, adjuster activity, and inactive bans.

Config.MaxPrescriptionRecords caps how many records are kept per doctor.

Prescriptions and medications

Authoring depends on:

• Config.Job

• Config.MinimumGrade

• Config.ItemUse with Config.ItemName

• or Config.CommandName

The prescription item uses metadata for patient details, doctor signature, medication, and dose tracking.

Config.Medications defines each medication entry.

Each entry can include:

• item

• label

• optional total

• effects

• sideEffects

• anim

• costPerDose

Pricing comes from the base medication cost plus the dose cost, then insurance modifies that total.

Pharmacies

Each Config.Pharmacies entry can include:

• ped model and spawn

• blip

• customer interaction radius

• walk-to-counter behavior

• employee counter

• drug collection location

• restock location

• robbery shelves and loot

Staff permissions come from Config.PharmacyPermissions.

That controls records, flagging, unflagging, unbans, and history clearing.

Insurance

Config.InsuranceSystem is the master insurance switch.

It also handles claim retention, payment cycle days, and medication rejection chance.

Config.InsurancePlans defines the plan list, fees, discount, down payment, and medication eligibility.

Config.InsuranceJob defines broker access, minimum grade, boss grade, commission, and self-service availability.

Supplies and restock

Config.SuppliesSystem controls stock levels, low-stock checks, restock reward, and the supply box model.

Config.RestockMission and Config.PharmacyRestockMissionLocations control the delivery mission flow.

The server export reducePharmacySupplies(pharmacyId) returns whether stock was actually reduced.

Shoplifting, bans, and records

Config.Bans controls ban history, repeat multipliers, and permanent ban thresholds.

Detection uses shelf chances and pharmacist busy-state style rolls.

The employee computer supports:

• prescription search

• flagged prescription review

• panic integration

• patient targeting for staff flows

Lean, overdose, and hooks

Lean-related items:

• Config.CoughSyrupItem

• Config.LeanCupItem

• Config.SprunkItem

• Config.LeanItem

• Config.LeanItems

Overdose and narcan related values:

• Config.NarcanItem

• DrugTaken(amount)

• StartOverdose()

• StopOverdose()

Open integration points include dispatch, vehicle keys, notify, TextUI, and Discord logging.