pc-live/INSTALL.md

58 lines
1.8 KiB
Markdown
Raw Permalink Normal View History

IC-Computer: Schreibtisch, Fenster und Apps Ein Computer im Spiel. Man tritt an ein Terminal, drueckt E, und bekommt eine Oberflaeche mit Mail, Browser, Adressbuch, Kalender und weiteren Anwendungen. Andere Resources haengen sich als App ein. Auf ESX umgestellt: - Fuenf harte Abhaengigkeiten zeigten auf Resources, die es hier nicht gibt. Eine fehlende Abhaengigkeit verhindert den Start vollstaendig - die Resource waere nie hochgekommen. - Die Bruecke zum Framework neu geschrieben; Charakterdaten, Aktenverwaltung und Immobilien ausgebaut, weil die zugehoerigen Systeme fehlen. - pc_live_devices fehlte im Schema, wird vom Code aber gelesen. Ohne die Tabelle ist kein fester PC ansprechbar. Ein PC braucht ausserdem zwei Eintraege mit derselben Kennung: Standort in der Datenbank, Kamerafahrt in der config.lua. Mail ueberarbeitet: - Postfaecher haengen an einer Anmeldung statt an der Person. Mehrere Leute koennen dasselbe Firmenpostfach gleichzeitig offen haben. - Ordner gehoeren zum Postfach, nicht zur Person. Eine Mail an ein geteiltes Postfach wird je Empfaenger einmal gespeichert; damit das Einsortieren trotzdem fuer alle gilt, tragen alle Kopien einer Zustellung dieselbe Kennung. Gelesen und geloescht bleibt persoenlich - das ist keine Eigenschaft der Nachricht, sondern der Person. - Signaturen gehoeren ebenfalls zum Postfach. - Kalender koennen privat, geteilt oder oeffentlich sein. Ein oeffentlicher Termin haengt bewusst auch an einem Postfach, sonst koennte ihn spaeter niemand mehr aendern oder absagen. Neue Apps: Webhosting, Bleeter und dessen Verwaltung. Behoben: - prompt(), confirm() und alert() froren das NUI ein. FiveMs CEF hat keinen Handler fuer die eingebauten Browserdialoge - der Aufruf oeffnet nichts und kehrt nie zurueck. Ersetzt durch eigene Dialoge. - Die Fenster tragen data-wid, keine id. Wer sie mit getElementById sucht, schreibt ins Leere und das Fenster bleibt leer. Enthaelt README.md mit Einrichtung und PLUGINS.md: eine Anleitung, wie man eine eigene App baut und einhaengt, mit vollstaendigem Beispiel von der Tabelle bis zum Schreibtischsymbol.
2026-08-09 12:02:11 +00:00
# pc-live v1.1.0
## Funktion
Vollständiges IC-PC-System: Desktop-Umgebung, Software-Store, Mail-Client,
Adressbuch, Kalender, Browser (IC-Seiten), externe Apps via iframe.
## SQL ausführen
```bash
mysql -u USER -p DB < sql/pc_live.sql
```
## Tabellen
| Tabelle | Beschreibung |
|---------|-------------|
| `pc_live_users` | PC-Benutzerkonten (verknüpft mit ic_players) |
| `pc_live_devices` | Registrierte Geräte |
| `pc_live_installs` | Installierte Apps pro Gerät |
| `pc_live_mail` | E-Mails |
| `pc_live_mail_folders` | Mail-Ordner |
| `pc_live_contacts` | Adressbuch-Einträge |
| `pc_live_calendar` | Kalender-Einträge |
## Konfiguration (config.lua)
| Option | Standard | Beschreibung |
|--------|---------|-------------|
| `Config.Framework` | `standalone` | `qbcore`, `esx` oder `standalone` |
| `Config.AccentColor` | `#00aaff` | PC-UI Akzentfarbe |
| `Config.BootDuration` | `2500` | Boot-Animation in ms |
| `Config.FreezeOnOpen` | `true` | Spieler beim PC-Nutzen einfrieren |
| `Config.InteractKey` | `38` (E) | Interaktionstaste |
| `Config.InteractRange` | `1.8` | Interaktionsreichweite in Metern |
| `Config.PCs` | `{...}` | PC-Standorte (Koordinaten, Typ, Job-Lock) |
| `Config.ICPages` | `{...}` | Interne Browser-Seiten |
## Apps registrieren (andere Ressourcen)
```lua
exports['pc-live']:RegisterApp({
app_id = 'meine.app',
name = 'Meine App',
icon = '📦',
version = '1.0.0',
category = 'utility',
permissions = {}, -- {} = für alle, { job = 'police' } = job-locked
price = 0,
})
```
## Abhängigkeiten
- `ic_players` (Benutzer-Verknüpfung)
- `ic_persons` (Anzeigename)
- `ic_bank_accounts` (Geld-Anzeige im HUD)
- `ic_jobs` (für Job-basierte App-Permissions)
## server.cfg
```
ensure pc-live
```