Copnet Docs

Übersicht

Copnet läuft zentral unter https://cop.nexuscase.de – du musst nichts installieren oder hosten. Für deinen Server bekommst du ein eigenes System: eigene Benutzer, Gruppen, Akten, eigener API-Key und ein eigenes Dienstnummern-Präfix (z. B. 0001-2101). Andere Systeme sehen deine Daten nicht.

Erste Schritte

1. Zugangsdaten bereitlegen: Dienstnummer des System-Admins (z. B. 0001-0000) und das zugehörige Passwort.
2. Anmelden unter https://cop.nexuscase.de.
3. API-Key kopieren: App System › API.
4. FiveM-Ressourcen installieren und den API-Key eintragen (siehe unten und FiveM-Ressourcen).
5. Gruppen & Benutzer anlegen: Gruppen & Rechte, dann Benutzer.
6. Optional einrichten: Fivemanage-Key für Beweisfotos, E-Mail-Domain, Abgleich mit deiner FiveM-Datenbank, eigenes Gesetzbuch (Systemeinstellungen).

API-Key eintragen

Der Key kommt in diese drei Dateien – alle werden nur auf dem Server geladen:

Config.ApiKey = "DEIN_API_KEY"

api_key = "DEIN_API_KEY",

Dein Zugang

• Der System-Admin (…-0000) hat immer alle Rechte und sieht alle Geheimhaltungsstufen. Er kann nicht gesperrt oder in eine andere Gruppe gesetzt werden.
• Passwort des System-Admins vergessen oder ändern? Melde dich beim Copnet-Team.
• Passwörter aller anderen Benutzer setzt du selbst in der App Benutzer (Recht „Benutzer verwalten“).
• Lege für die Leitung eigene Konten mit einer Admin-Gruppe an, statt den System-Admin-Zugang zu teilen.
• Beim Aktualisieren der FiveM-Ressourcen deinen API-Key wieder in die neuen Dateien eintragen.
• Erscheint beim Login „Dieses System ist derzeit gesperrt“, melde dich beim Copnet-Team.

Gruppen & Rechte

Gruppen (Ränge) legst du in der App Benutzer an. Rechte werden pro App vergeben – insgesamt 39 einzelne Rechte.

• Voraussetzungen werden automatisch gesetzt: „Einträge schreiben“ setzt „Akten ansehen“ mit. Entfernst du „Akten ansehen“, fallen alle Akten-Rechte weg, die darauf aufbauen.
• Vorlage: Über „Rechte von Gruppe übernehmen …“ kopierst du die Rechte einer anderen Gruppe und passt sie danach frei an.
• Schnellauswahl: „Nur Lesen“, „Alle“, „Keine“ und ein Schalter pro App.
• Admin-Gruppen haben automatisch alle Rechte und sehen alle Geheimhaltungsstufen.
• Wer selbst kein Admin ist, kann nur Gruppen mit Rechten anlegen, die er selbst besitzt.

Rechte nach App

Benutzer & Dienstnummern

Benutzer legst du in der App Benutzer an: Name, Nummer, Gruppe, Geheimhaltungsstufe und Passwort (ein sicheres Passwort kann generiert werden).

• Die Dienstnummer besteht aus System-Präfix und Nummer: Präfix 0001 + Nummer 2101 ergibt 0001-2101. Damit melden sich Benutzer an.
• Sperren beendet sofort alle Anmeldungen des Benutzers.
• „Auf diesem Gerät angemeldet bleiben“ speichert nur ein widerrufbares Token, nie das Passwort.

Geheimhaltungsstufen

Stufen aufsteigend: OFFEN → VS-NfD → VS-VERTRAULICH → GEHEIM → STRENG GEHEIM. Jeder Benutzer hat eine Stufe.

• Ermittlungen und Akten-Einträge bekommen beim Erstellen eine Stufe – höchstens die eigene.
• Ermittlungen über der eigenen Stufe sind unsichtbar (auch ihre Beweisfotos).
• Akten-Einträge über der eigenen Stufe erscheinen als „Verschlusssache“. Titel, Text, Paragrafen und Fotos bleiben verborgen, die Fahndung bleibt sichtbar.
• Admins sehen alles.

Systemeinstellungen

In der App System (nur für den System-Admin):

Ingame-Verknüpfung

Damit Dispatch-Routen, Dienststatus und Kamera-Fotos beim richtigen Benutzer landen, muss der Spieler mit seinem Copnet-Konto verknüpft sein.

1. Ingame das Tablet öffnen (Standard F6).
2. Mit Dienstnummer und Passwort anmelden.
3. Copnet verknüpft den Spieler automatisch über seine FiveM-Lizenz. Die Kachel „Dienststatus“ zeigt danach Job und Dienst an.

Wer das Recht „Benutzer verwalten“ hat, kann Benutzer auch in der App Benutzer mit einem Spieler verknüpfen, der gerade online ist.

FiveM-Ressourcen

server.cfg

# Framework/Inventar zuerst (z. B. es_extended oder qb-core, ox_inventory)
ensure screenshot-basic
ensure pol-tablet
ensure copnet-dispatch
ensure copnet-camera
ensure pol-radar

Gemeinsame Einstellungen

• API-Key steht immer in einer serverseitigen Datei (config_server.lua bzw. sv_copnet_config.lua) und wird nie an Spieler ausgeliefert. Die Adresse von Copnet ist dort bereits eingetragen.
• Polizei-Jobs (Standard { "police" }) steuern, wer Dispatches bekommt und die Kamera nutzen darf. Erkannt werden ESX- und QBCore-Jobs inkl. onduty.

pol-tablet

Öffnet Copnet ingame als Tablet (NUI mit eingebetteter Webseite), spielt eine Tablet-Animation ab und übergibt Dienststatus und Spielerliste an Copnet.

Config config.lua

Befehle & Tasten

Events

Tablet als Item öffnen

local QBCore = exports['qb-core']:GetCoreObject()

QBCore.Functions.CreateUseableItem('police_tablet', function(source)
    TriggerClientEvent('copnet:tabletOpen', source)
end)

ESX.RegisterUsableItem('police_tablet', function(source)
    TriggerClientEvent('copnet:tabletOpen', source)
end)

TriggerEvent('copnet:tabletToggle')

Nachrichten zwischen Tablet und Copnet (NUI)

Nur relevant, wenn du das Tablet selbst anpasst. Die Copnet-Seite kommuniziert per postMessage mit dem Tablet-Rahmen:

copnet-dispatch

Schickt Dispatches an Copnet, alarmiert Polizisten im Dienst, synchronisiert Online-Spieler und setzt Routen, die in Copnet angenommen wurden.

Ablauf

1. Ein Script meldet einen Einsatz (Export oder Event).
2. Copnet speichert den Dispatch. Alle Polizisten im Dienst bekommen eine Meldung und haben 7 Sekunden, um mit ENTER anzunehmen (setzt Wegpunkt).
3. In der App Dispatch sehen Beamte alle offenen Einsätze. „Route setzen“ legt den Wegpunkt ingame beim verknüpften Beamten.
4. Beim Archivieren wird die Route bei allen Beteiligten entfernt.

Config

Dispatch senden

Export Server

exports['copnet-dispatch']:SendDispatch(payload)

Event vom Client oder Server

-- Client: Absender wird automatisch auf den Spielernamen gesetzt, Cooldown aktiv
TriggerServerEvent('copnet:dispatch', payload)

-- Server: ohne Cooldown, created_by frei wählbar
TriggerEvent('copnet:dispatch', payload)

Payload

Events an Polizisten Client

Eigene Scripts können auf diese Events hören, z. B. für ein eigenes HUD:

AddEventHandler('copnet:dispatchAlert', function(data)
    print(('Neuer Einsatz: %s (%s)'):format(data.title, data.street or '?'))
end)

Befehle & Tasten

Interne Server-Events

Werden von Tablet und Client genutzt und prüfen selbst, ob der Spieler Polizist im Dienst ist:

• copnet:ackDispatch – Dispatch als angenommen markieren ({ id })
• copnet:requestPlayerList – Online-Spielerliste für das Tablet
• copnet:linkOfficer – Spieler mit Copnet-Konto verknüpfen (nur mit Link-Token)

Dispatch-Beispiele

Ladenraub (Server-Script)

-- z. B. im Raub-Script, wenn der Überfall startet
local function alarmPolice(src, storeName)
    local coords = GetEntityCoords(GetPlayerPed(src))
    exports['copnet-dispatch']:SendDispatch({
        title = 'Ladenraub',
        message = ('Stiller Alarm ausgelöst: %s'):format(storeName),
        code = '10-90',
        street = storeName,
        coords = coords,
        created_by = 'Alarmanlage'
    })
end

Schüsse gemeldet (Client-Script)

local function reportShots()
    local coords = GetEntityCoords(PlayerPedId())
    local streetHash = GetStreetNameAtCoord(coords.x, coords.y, coords.z)
    TriggerServerEvent('copnet:dispatch', {
        title = 'Schüsse gemeldet',
        message = 'Anwohner melden Schüsse in der Umgebung.',
        code = '10-71',
        street = GetStreetNameFromHashKey(streetHash),
        coords = { x = coords.x, y = coords.y, z = coords.z }
    })
end

Notruf-Befehl /911

RegisterCommand('911', function(source, args)
    local text = table.concat(args, ' ')
    if text == '' then return end
    exports['copnet-dispatch']:SendDispatch({
        title = 'Notruf 911',
        message = text,
        code = '911',
        created_by = GetPlayerName(source),
        coords = GetEntityCoords(GetPlayerPed(source))
    })
end, false)

Anderes Dispatch-System weiterleiten

Wenn schon ein anderes Dispatch-Script läuft, leite dessen Meldungen serverseitig zusätzlich an Copnet weiter – dort, wo das Script seinen Alarm erzeugt:

-- Beispiel: vorhandene Funktion, die einen Alarm erzeugt
local function onAlert(alert)
    -- … bisheriger Code des Dispatch-Scripts …
    exports['copnet-dispatch']:SendDispatch({
        title = alert.title,
        message = alert.description,
        code = alert.code,
        street = alert.street,
        coords = alert.coords
    })
end

copnet-camera

Polizeikamera für Beweisfotos. Fotos werden über den Server an Copnet geschickt, bei Fivemanage gespeichert und erscheinen in der App Beweise des verknüpften Beamten.

Config

Item anlegen

['police_camera'] = {
    label = 'Polizeikamera',
    weight = 800,
    stack = false,
    consume = 0,
    server = { export = 'copnet-camera.useCamera' }
},

police_camera = { name = 'police_camera', label = 'Polizeikamera', weight = 800, type = 'item', image = 'police_camera.png', unique = true, useable = true, shouldClose = true, description = 'Kamera für Beweisfotos' },

INSERT INTO items (name, label, weight) VALUES ('police_camera', 'Polizeikamera', 1);

-- serverseitig beim Benutzen des Items
exports['copnet-camera']:OpenCamera(source)
-- oder
TriggerEvent('copnet-camera:use', source)

Exports & Events

Bedienung

Als Beschreibung wird automatisch die Straße gespeichert. In Copnet lassen sich Fotos danach beschreiben, freigeben und in Akten oder Ermittlungen auswählen. Standardmäßig zeigt die App die letzten 2 Stunden.

pol-radar

Radar und Kennzeichenleser (basiert auf Wraith ARS 2X). Copnet liefert eine BOLO-Liste: Fahrzeuge, die gestohlen gemeldet sind oder deren Halter zur Fahndung steht. Der Kennzeichenleser sperrt bei einem Treffer automatisch.

Copnet-Anbindung sv_copnet_config.lua

COPNET_RADAR = {
    enabled = true,
    api_url = 'https://cop.nexuscase.de/api.php?action=vehicleList&flagged=1', -- nicht ändern
    api_key = 'DEIN_API_KEY',
    interval = 120000 -- alle 2 Minuten abrufen
}

Tasten (Standard)

Events

• wk:copnet:updateBolos Client – der Server verteilt die BOLO-Liste an alle.
• wk:copnet:requestBolos Server – Client fordert die aktuelle Liste an.
• TogglePlateLock(clientId, cam, beepAudio, boloAudio) Server-Export – Kennzeichenleser sperren (cam = "front" oder "rear").

Alle Exports & Events

API für Server-Scripts

Eigene Server-Scripts können Copnet direkt ansprechen – mit dem System-API-Key. Alle Antworten sind JSON: { "ok": true, … } bzw. { "ok": false, "error": "…" }.

local API_BASE = 'https://cop.nexuscase.de/api.php'
local API_KEY  = 'DEIN_API_KEY' -- nur serverseitig!

local function copnet(action, payload, cb)
    PerformHttpRequest(API_BASE .. '?action=' .. action, function(status, body)
        local ok, data = pcall(json.decode, body or '')
        if cb then cb(status, ok and data or nil) end
    end, 'POST', json.encode(payload or {}), {
        ['Content-Type'] = 'application/json',
        ['X-API-Key'] = API_KEY
    })
end

copnet('dispatchStats', {}, function(status, data)
    if data and data.ok then print('Offene Dispatches: ' .. data.count) end
end)

Aktionen mit API-Key

* Pflichtfeld

Fehlerbehebung

Sicherheit

• API-Key nur in serverseitigen Dateien, nie in client_script, shared_script oder NUI und nie öffentlich teilen. Wurde er geleakt: in Copnet › System › API neu erzeugen und in allen Ressourcen ersetzen.
• System-Admin-Zugang nicht teilen – für die Leitung eigene Admin-Konten anlegen.
• Rechte sparsam vergeben: „Benutzer verwalten“ und „Gruppen & Rechte verwalten“ nur für die Leitung.
• Ausgeschiedene Mitglieder sperren (App Benutzer) – das beendet sofort alle ihre Anmeldungen.
• Eigene Web-Tools, die mit einer Copnet-Anmeldung arbeiten, müssen den Header X-Requested-With mitschicken (Schutz gegen fremde Seiten). FiveM-Scripts mit API-Key betrifft das nicht.
• Copnet ist für Roleplay gedacht – keine echten personenbezogenen Daten eintragen.