FVS-Tablet

🧭 Überblick – der komplette Ablauf

• SQL einspielen.
• Ressource kopieren + in der server.cfg eintragen.
• Inventar-Items tablet (+ optional tablet_charger) anlegen.
• Config prüfen (Inventar, Item, ACE-Rechte, Identifier).
• Lizenz-Key anfragen und setzen.
• Prüfen mit tabletfvs status / showurls.

⚙️ Voraussetzungen

🗄️ 0 · Build.BAT / build.sh ausführen

Einmalig die Build-Dateien ausführen. Damit werden die benötigten Node.js-Abhängigkeiten installiert.

🗄️ 1 · SQL installieren

mysql -u DEIN_USER -p DEINE_DB < sh_fvs_tablet/sql/tablet.sql

📄 2 · server.cfg

oxmysql und das Inventar müssen vor sh_fvs_tablet geladen werden.

ensure oxmysql
ensure ox_inventory      # ODER: ensure core_inventory

ensure sh_fvs_tablet

# NUI-DevTools nur auf Test-Servern:
setr ui_useNuiDevTools "true"

# ----- Admin-Rechte (ACE) -----
add_ace group.admin fvs.tablet.admin allow

🎒 3 · Inventar-Item anlegen

Bei Config.RequireItem = true muss das Item tablet im Inventar existieren. Lege es je nach deinem Inventar-System an. Das Tablet erkennt das System automatisch (Config.Inventory = 'auto').

🟦 ox_inventory — data/items.lua

['tablet'] = {
    label = 'Tablet',
    weight = 500,
    stack = false,   -- WICHTIG: sonst teilen sich mehrere Tablets eine device_id
    close = true,
    consume = 0,
    client = { export = 'sh_fvs_tablet.tablet' }
},
['tablet_charger'] = {
    label = 'Tablet Power-Bank',
    weight = 300,
    stack = true,
    close = true,
    client = { export = 'sh_fvs_tablet.tablet_charger' }
},

🟩 core_inventory

Trage die Items in deiner core_inventory-Item-Konfiguration ein. Wichtig: unique = true, damit jedes Tablet seine eigene Metadata (device_id) behält und nicht stapelt.

['tablet'] = {
    name = 'tablet',
    label = 'Tablet',
    weight = 500,
    type = 'item',
    unique = true,        -- jedes Tablet eigenständig (eigene device_id)
    useable = true,
    shouldClose = true,
    description = 'FVS Tablet',
},
['tablet_charger'] = {
    name = 'tablet_charger',
    label = 'Tablet Power-Bank',
    weight = 300,
    type = 'item',
    useable = true,
    shouldClose = true,
    description = 'Lädt den Tablet-Akku auf',
},

Inventar fest setzen (optional)

Schlägt die Auto-Erkennung fehl, in sh_fvs_tablet/shared/config.lua erzwingen:

Config.Inventory = 'ox'   -- 'auto' | 'ox' | 'core' | 'qb' | 'ps' | 'generic'

🔧 4 · Wichtige Config-Werte

In sh_fvs_tablet/shared/config.lua:

License-Endpunkte (bereits vorkonfiguriert, normalerweise nicht ändern):

licenseVerifyUrl  = 'https://tablet-license.devhive.app/ucp/licensen'
defaultApiBaseUrl = 'https://tablet-api.devhive.app'
fvsSocketUrl      = 'https://fvs-socket.devhive.app'

🔑 5 · Lizenz-Key anfragen & setzen

curl -X POST https://tablet-license.devhive.app/admin/licenses \
  -H "Authorization: Bearer <ADMIN_API_KEY_AUS_DER_.ENV>" \
  -H "Content-Type: application/json" \
  -d '{ "server_name": "[FVS-OS]-Socket", "prefix": "FVSOS" }'

tabletfvs setlicense FVSOS:Ab12Cd34Ef56Gh78Ij90

✅ 6 · Prüfen

tabletfvs status
tabletfvs showurls

Der Status muss aktiv zeigen; showurls listet die geladenen URLs (api / socket / banking / akten).

🛰️ Leitstelle / LiveMap (optional)

Die Leitstelle ist eine neue App (Leaflet-Karte), die alle Dienstfahrzeuge der eigenen Fraktion live auf einer Karte zeigt. Sie wird über den DevStore installiert und ist job- & dienst-gated. Für die Einrichtung sind zwei zusätzliche Schritte nötig: OneSync und ein GTA-V-Tileset.

sh_fvs_tablet/web/public/map/{z}/{x}/{y}.png

cd sh_fvs_tablet/web
npm install      # zieht u.a. leaflet
npm run build    # schreibt nach web/dist/

/leitstelle      # abonnieren (Test ohne UI)
/fvsunits        # Einheiten-Liste

Config Config.Leitstelle

📹 CCTV-App

Das Tablet zeigt die CCTV-App zum Live-Beobachten der Kameras. Die gesamte Ingame-Logik (Kamera-Items, Platzieren, Map-Import, Blackout, Alarm) läuft jedoch im PC-Script sh_fvs_pc.

⌨️ Befehlsliste

Spieler / Client

Admin – Tablet-Verwaltung

Admin – Lizenz / FVS (tabletfvs)

🛠️ Troubleshooting