# DevX RP Framework v0.4.3

Eigenständiges FiveM-RP-Framework für txAdmin ohne ESX, QBCore oder QBox.
`oxmysql` wird ausschließlich als Datenbanktreiber verwendet.

## Schwerpunkt v0.4.3

- entfernt globale Apartment-/Warehouse-IPL-Wechsel, die Weltteile oder
  Kollisionen nach einem Interiorwechsel beschädigen konnten
- neuer Streaming-Guard in `devx_ipl` und `/fixworld`
- Bankraub-Vorbereitungen in einem immer verfügbaren GTA-Online-Garageninterior
  mit Missionsdekoration, Fahrzeugen, NPCs und Planungsdialog
- Apartmentflure in einer stabilen virtuellen Korridorszene statt in einem
  fehlerhaften Apartment-IPL
- nur tatsächlich bewohnte Wohnungen bekommen Namensschild und Türaktion
- verwaiste Eigentümer von gelöschten Charakteren werden automatisch bereinigt
- pro Charakter weiterhin maximal ein Apartment
- Eigentümer können an der Wohnungstür mit `G` eine Spielerliste öffnen
- eingeladene Spieler müssen die Einladung mit `E` annehmen; erst danach erfolgt
  der Teleport in die gemeinsame Wohnungsinstanz
- Klingeln und Klopfen bleiben für Bewohner anderer Apartments erhalten

## Update eines bestehenden Servers

1. Server und FiveM stoppen.
2. `release/devx-rp-hotfix-v0.4.3.zip` im Server-Datenordner entpacken.
3. Vorhandene Dateien überschreiben.
4. Startreihenfolge prüfen: `devx_ipl` vor `devx_housing` und `devx_crime`.
5. Server und FiveM vollständig neu starten.

Eine Schemaänderung ist nicht erforderlich. Die optionale Datei
`sql/migrations/v0.4.3.sql` bereinigt ausschließlich Eigentümerzeilen, deren
Charakter fehlt oder bereits gelöscht wurde.

## Gitea / txAdmin

Repository-Inhalt in den `main`-Branch hochladen. Danach ein Gitea-Release mit
Tag `v0.4.3` erstellen und `release/devx-rp-server-v0.4.3.zip` als Asset
anhängen. txAdmin erhält die Raw-URL der `recipe.yaml`.

## Wichtige Befehle

- `/fixworld` – Weltfokus und Kollision neu aufbauen
- `/world` – in die öffentliche Routing-Welt zurückkehren
- `/phone` – Smartphone umschalten
- `/admin` – DevX-Administration, nur mit `devx.admin`
- `/inviteapartment` – in der eigenen Wohnung Spielerliste öffnen
- `/acceptapartment` – Fallback für eine offene Einladung

## Entwicklungsstand

Dies ist ein eigener Test- und Entwicklungsstand. Syntax, JavaScript, YAML und
Archive werden beim Build geprüft. Ein vollständiger GTA/FiveM-Praxistest mit
allen Game-Builds, Interiors und NPC-Pfaden ist außerhalb eines laufenden
FXServers nicht möglich.