first commit

README.md

@@ -0,0 +1,55 @@
+# 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.