samp.directory
← Betikler ve kütüphaneler

Nexus-Core-Mesh/Nexus-Core-Gamemode

Nexus-Core SA:MP Gamemode

Gamemode★ 1evvelsi gün güncellendiMITPawn
GitHub’da aç

README.md

GTA:SA Reallife Modular Gamemode

Dieses Projekt ist ein vollständig modular aufgebautes SA:MP-Reallife-Gamemode mit den folgenden Kernmerkmalen:

  • 3-Staaten-System: Los Santos, San Fierro, Las Venturas
  • eigener Staatskasse pro Staat und eigener Finanz-/Steuerlogik
  • eigenem Verwaltungssystem pro Staat
  • globalem Admin- und Support-System
  • SQLite-First-Design mit sauberer Backend-Abstraktion für späteres MySQL 4.1
  • modularem Aufbau, damit einzelne Systeme separat erweitert werden können
  • Textdraw-basiertem Login-/Registrierungssystem
  • Heimatstadt-, Tutorial- und Intro-Flow
  • moderner Camera-/Intro-Szene und zustandsbasierter Spawnlogik
  • staatlicher Regierungs-/Budget-Logik
  • dynamischem Haussystem, Bize- und Fraktionssystem
  • staatlich angepassten Jobs, Wirtschaft und Verwaltung
  • eigenem 3x/1Admin-System mit globaler und staatlicher Verwaltung
  • erweitertem Fraktions- und Gangmanagement mit per-State-Kassen
  • modernen Event-, Social- und RP-Kommandos
  • staatlichen Garagen, Polizei-/EMS-Stationen und Waffenläden
  • modularen Basisstrukturen für spätere Missionen, Fahrzeuge, Jobs, Regierung und Logistik
  • External Control Panel mit eigener API und SQLite-Datenbankzugriff
  • Haus-Safes, Inventar- und Lagerlogik für pers. Besitz und Accessoires
  • UBB-/Portal-Fahrzeugsystem mit Besitz-, Lock- und Tankstatus
  • sauberer state-aware Erweiterungspfad für safe, accessory, storage und ownership-Module
  • zusätzliches State-/City-Infrastrukturmodell mit Rathäusern, Ammu-Nations, Landmarken, Lebenszyklus- und Wirtschaftssystemen pro Staat

Aktueller Entwicklungsstand

Die Codebasis wurde zu einem deutlich fortgeschrittenen modularen RP-Framework erweitert. Aktuell enthalten sind:

  • zentrale Core-Player- und State-Modelle
  • DB-Abstraktionsschicht mit SQLite-Backend und MySQL-Adapter-Design
  • per-State-Kassen, Verwaltung und Steuerlogik
  • Textdraw-Login, Heimatstadt-Auswahl und Intro-/Tutorial-Fluss
  • staatliche Karrierelogik, Jobs und Progression
  • Häuser, Bize, Fraktionen, Gangs, Jobs und verteilte Wirtschaft
  • Polizei-/EMS-/Justiz-/Knast-Systeme mit State-Bindung
  • Inventar-, Telefon-, Werbe-, Event-, Gym-, Fishing- und Casino-Systeme
  • eigenständiges Web-Control-Panel, das dieselbe SQLite-Datenbank nutzt
  • Haus-Safes, Accessoires, Tankstellen, Fahrzeugbesitz und UBB-/Portal-Integration
  • vollständige Modularisierung mit klaren Abhängigkeiten und erweiterten Ownership-/Inventory-/State-Prozessen
  • zusätzlich: robustere Player-Validierung, erweiterte State-API, bessere Faction-/Business- und Gangwar-Statuslogik, konsistente Treasury-Transfers und zentrale Validierung der State-IDs
  • neue Sicherheits-/Architekturverbesserungen in Core-, Faction-, Business- und Job-Layern, inklusive State-Checks, State-Validierungen und konsistenter, modulübergreifender Kassenlogik
  • klar definierte Eigentums-, Erwerbs- und State-zuordnungsregeln für Häuser, Bize, Fahrzeuge, Factions und Hauslager
  • konsistente Erweiterbarkeit für spätere UCP-, Admin-, Wirtschafts- und Job-Workflows
  • neu: staatliche Rathäuser/City Halls, Ammu Nations je Staat und Landmarken-/Stadtmarker-Subsysteme für LS/SF/LV
  • neu: eigene staatliche Infrastruktur im RP-Loop (Stadtverwaltung, Waffenverkauf, Stadtgrößen- und Wahrzeichen-Systeme)
  • neu: erfassbare RP-Umgebung durch Landmarken, Regierungsgebäude, Waffenläden und lokale Staats-Identitäten pro Stadt
  • neu: konsolidiertes Bank-/Treasury-Modell mit Matching zwischen Player-Bank, State-Government, DB-Transfers und UI-Anzeige
  • neu: zentrale Single-Source-of-Truth für Staatskassen, Regierungshaushalt und Spielerbank, mit Synchronisierung über Core-, State-, Government- und DB-APIs
  • neu: vollständiges Fraktions-, Gangwar- und Gangfight-Framework mit staatlicher Kassen- und Reward-Logik
  • neu: statebindendes Faction-/Gang-Governance mit Leader-, Rank- und Strukturlogik je LS/SF/LV
  • neu: erweitertes staatsspezifisches Jobframework mit staatlicher Bindung, Bord-/Pay-Logik und dynamischer Jobzuweisung pro Bundesstaat

Vollständiger Systemüberblick

Das RP-Framework ist jetzt auf einen echten, lückenlosen Lebenszyklus ausgelegt:

  • Auth & Login: Textdraw-Login, Registrierung, Heimatstadt-Auswahl, Tutorial, Intro-Camera
  • Staatliche Struktur: LS/SF/LV mit eigener Kasse, Verwaltung, Steuerlogik, Geldfluss und Roles
  • Wirtschaft: Jobs, Businesses, Autohäuser, Tuning, Logistik, Tankstellen, Staatskasse, Steuern
  • Eigentum: Häuser, Kassen, Lager, Accessoires, Fahrzeugbesitz, UBB-Register, Web-Bridge
  • Justiz: Wanted, Strafakte, Bail, Kaution, Knast, Court, Staatsgerichtsbarkeit
  • Soziales Leben: RP-Kommandos, Phone, Kontakte, Events, Freizeit, Casino, Gym, Angeln
  • Verwaltung: Admin-System, State-Admin, Mapping, Web-CP, UCP-/Forum-Synchronisation
  • Fraktions-/Gang-Ökonomie: Kassen, Mitglieder, Leadership, Zuständigkeit pro Staat und staatliche Einnahmen aus Fraktions- und Bizzusammenhängen
  • Job- und Progressionslogik: Jobtypen je Staat, XP-/Karriere-Flow, Logistik- und Business-Jobs, Verknüpfung mit Staatskassen und Wirtschaft
  • Auto-/Fahrzeugökonomie: Fahrzeugbesitz, Tuning, UBB-Daten und Steuer-/Value-Flow an die Staaten
  • Infrastruktur: Rathäuser, Ammo-Shops, Landmarken, Gebietsmarker und lokale Visualisierung der Staatseinheiten

Fraktions- und Wirtschaftsarchitektur

Das System wurde mit einem klaren, kompatiblen Logikmodell erweitert:

  • Factions/Gangs: pro Staat definiert, eigene Kasse, Mitgliederliste, Rangvergabe, Besitz-/Kassenfluss
  • Businesses: per State, Eigentümer, Umsatzmodell, staatliche Beteiligung, Kauf- und Auszahlungslogik
  • Jobs: State-abhängig, einheitlich über JobsCore_*, StateJobs_*, DynamicJobSystem_*
  • Logistik: Business- und Transportjobs als separater Layer mit staatlicher Verknüpfung, ohne die Fraktions-/Job-Logik zu zerstören
  • State-Flow: Einnahmen aus Bizen, Faction-Gründungen, Job-Auszahlungen und Fahrzeug-/Vehicle-Transaktionen laufen in die Staatskasse des jeweiligen Bundesstaats
  • Treasury-Flow: Bank-/Cash-/Wirtschaftslogik ist in Core_*, StateSystem_*, GovernmentSystem_* und DB_* konsistent angeschlossen, damit keine parallelen Geldquellen entstehen

Architektur-Regeln für jede Erweiterung

  1. core.inc bleibt die einzige Quelle der Wahrheit für spielerbezogene Daten.
  2. Jeder neue Zustand, Staat, Admin-/Fraktions-/Business-/House-Status muss auf Core_* und StateSystem_* zurückgreifen.
  3. Das Datenbankschema wird über DB_Initialize() und DB_Ensure*Schema() idempotent sichergestellt.
  4. Alle monetären Transaktionen laufen über State-/Bank-/DB-APIs und nicht über lokale Variablen.
  5. Fahrzeug-, Inventar- und Hauslogik müssen dem zentralen Ownership-/State-Modell folgen, damit kein Modul eigene Besitzwahrheiten bildet.
  6. Include-Reihenfolge in gamemode.pwn ist bindend: Core → DB → State → Admin → Auth → Economy → Jobs → Laws → Housing/Vehicle → Leisure/Web.
  7. Neue Module müssen die README-/Dokumentationspflicht erfüllen und in die Struktur/Arbeitsschritte eingepflegt werden.

Abgeschlossenes Modul-Spektrum

  • core/core.inc – zentrale PlayerData-Struktur, validierte Staaten, Admin- und State-Profile
  • db/db_interface.inc – zentrale SQL-Abstraktionsschicht, Schema-Management, State-/Vehicle-/Property-/Inventory-APIs
  • state/state_system.inc – 3-Staaten-Logik, Staatskassen, Spawns, Treasury-Transfer
  • admin/* – Admin-/Support-/State-Admin-/Mapping-System
  • auth/login_system.inc – Login, Register, Heimatstadt und Tutorial-Flow
  • camera/camera_system.inc – Intro-/State-Kamera-Szenen
  • government/government_system.inc – Staatsregierungen und Budgetverwaltung
  • economy/* – Bank, Tax, City-Economy, Autohäuser, Logistik, Tankstellen, Ammu Nations
  • government/* – Rathäuser, Staatsregierungen, Budgetverwaltung, Bürgermeister-/Staats-UI
  • jobs/* – Staatsjobs, dynamische Jobs, Rolle und Progression
  • housing/* – Häuser, Hauslager, Safes, Accessoires, Besitzlogik
  • vehicles/* – Fahrzeuge, Garagen, Tuning, UBB-Fahrzeugbesitz, Tankstellen
  • world/* – Landmarken, Stadt- und Gebietsmuster, lokale Identität je Staat
  • inventory/inventory_system.inc – Items, Slots, Stacks, Metadaten, Persistenz
  • law/*, justice/*, crime/* – Wanted, Knast, Kautionen, Court, Rechtssystem
  • communication/*, marketing/*, medical/* – Telefon, Werbung, EMS, Krankenhäuser
  • events/*, social/*, leisure/* – Events, RP-Kommandos, Gym, Fishing, Casino
  • web/web_bridge.inc – Brücke zu UCP/Web-Integration und account sync
  • control-panel/* – separater SQLite-Read-Only Dashboard-Server

Finaler Status und Validierung

Das Projekt ist als modularer Entwurf und Framework-Architektur deutlich ausgereift. Die Systemverbände sind logisch miteinander verkettet, alle Kernelemente des 3-Staaten-Reallife-Modells sind vorhanden und die Dokumentation wurde nach jedem Durchlauf erweitert.

Die jüngste Konsolidierungsphase schließt die wichtigsten Brücken zwischen Spielerprofil, Staatskasse und Wirtschaft wieder. Die zentrale Geldquelle ist nun das Core-Player-Profile (E_PLAYER_BANK), das überall dort verwendet wird, wo Banktransfers, Hauskäufe, Waffenkäufe, Bize, Fraktionen und Staatseinnahmen durchlaufen. Zusätzlich wurde die doppelte State-/Treasury-Logik in den relevanten Systemen auf die gemeinsame Schnittstelle StateSystem_ApplyTreasuryDelta() + DB_AddStateTreasuryFunds() zurückgeführt. Dadurch werden gPlayerBank-Nebenvarianten, State-Delta- und UI-Anzeige nicht mehr als getrennte Wahrheiten geführt.

Die jüngste Erweiterung schließt explizit die infrastrukturelle Lücke zwischen Staat, Verwaltung und Weltgefühl: Rathäuser und Regierungsgebäude, Waffenläden je Staat und Landmarken für Los Santos, San Fierro und Las Venturas sind jetzt Bestandteil der modularen Struktur und in gamemode.pwn eingebunden.

Zusätzlich wurden die zentralen Geld- und Staatskassen-Links zwischen Initiative, Bank, Fraktion, Waren- und Shopsystemen konsolidiert. Die Logik setzt auf Core_ChangePlayerBank(), Core_GetPlayerBank(), StateSystem_ApplyTreasuryDelta() und DB_AddStateTreasuryFunds() als gemeinsame Schnittstellen. Dadurch entstehen keine parallelen Geld-/Bankquellen mehr zwischen gPlayerBank, GetPlayerMoney(), per-State-Treasuries und UI-Anzeigen. Die modularen Subsysteme greifen jetzt auf denselben Datenfluss zu, wodurch die Wirtschaft im RP-Loop konsistenter und verlässlicher bleibt.

Ein echter Pawn-/SA:MP-Compile in dieser Umgebung ist nicht möglich, da die entsprechende Toolchain für Pawn/SA:MP nicht installiert ist. Die Verifikation hier war deshalb: strukturelle Konsistenz, Dateibindung, laufendes Control Panel (HTTP 200 auf localhost:3001), SQLite-Schema-Check und Code-/Logik-Review-Passung. Zusätzlich wurde die zentrale Player-Bank-Logik mit Core_* konsolidiert, sodass mehrere Module dieselbe Geldquelle verwenden und keine parallel geführten Bankwerte mehr auseinanderlaufen.

Letzte Integrations- und Konsistenzprüfung

  • core.inc ist die Single Source of Truth für Spielerstatus, Bank, Home-State und Admin-Status.
  • state_system.inc initialisiert drei Staaten mit eigener Kasse, Sprungpunkten und Treasury-Transfers.
  • government_system.inc, business_system.inc, house_system.inc, weapon_shop_system.inc und state_bank_system.inc nutzen denselben Treasury-/Bank-Pfad.
  • DB_Initialize() und DB_Ensure*Schema() bilden den idempotenten Einstieg für per-State- und per-Player-Daten.
  • gamemode.pwn hält die Include-Reihenfolge und Startup-Initialisierung auf einem konsistenten, modularen Pfad.
  • Das Control Panel liest dieselbe SQLite-Datenbank und ist damit für spätere Betriebs- und Admin-Workflows greifbar.

Projektstruktur

gtasa_reallife/
├── README.md
├── TO-DO.md
├── LICENSE
├── server.cfg
├── sql.cfg
├── config/
│   ├── database.ini
│   └── server.cfg
├── data/
│   ├── db/
│   │   └── gtasa_reallife.db
│   └── sql/
│       └── schema.sql
├── gamemodes/
│   ├── gamemode.pwn
│   └── modules/
│       ├── admin/
│       │   ├── admin_config_system.inc
│       │   ├── admin_mapping_system.inc
│       │   ├── admin_system.inc
│       │   └── state_admin_system.inc
│       ├── auth/
│       │   └── login_system.inc
│       ├── business/
│       │   └── business_system.inc
│       ├── camera/
│       │   └── camera_system.inc
│       ├── communication/
│       │   └── phone_system.inc
│       ├── core/
│       │   └── core.inc
│       ├── crime/
│       │   └── crime_system.inc
│       ├── db/
│       │   ├── db_interface.inc
│       │   ├── db_mysql.inc
│       │   └── db_sqlite.inc
│       ├── drugs/
│       │   └── drug_system.inc
│       ├── economy/
│       │   ├── city_economy_system.inc
│       │   ├── dealership_system.inc
│       │   └── state_bank_system.inc
│       ├── emergency/
│       │   └── emergency_system.inc
│       ├── events/
│       │   ├── event_system.inc
│       │   └── state_event_system.inc
│       ├── factions/
│       │   ├── faction_system.inc
│       │   ├── gang_fight_system.inc
│       │   └── gangwar_system.inc
│       ├── government/
│       │   └── government_system.inc
│       ├── housing/
│       │   └── house_system.inc
│       ├── inventory/
│       │   └── inventory_system.inc
│       ├── jobs/
│       │   ├── dynamic_job_system.inc
│       │   ├── jobs_core.inc
│       │   └── state_jobs.inc
│       ├── justice/
│       │   ├── court_system.inc
│       │   └── prison_system.inc
│       ├── law/
│       │   ├── jail_system.inc
│       │   └── law_system.inc
│       ├── leisure/
│       │   ├── casino_system.inc
│       │   ├── fishing_system.inc
│       │   └── gym_system.inc
│       ├── logistics/
│       │   └── trade_logistics.inc
│       ├── marketing/
│       │   └── ad_system.inc
│       ├── medical/
│       │   └── ems_hospital.inc
│       ├── missions/
│       │   └── mission_system.inc
│       ├── progression/
│       │   └── progression_system.inc
│       ├── shops/
│       │   ├── shop_system.inc
│       │   └── weapon_shop_system.inc
│       ├── social/
│       │   └── social_system.inc
│       ├── state/
│       │   └── state_system.inc
│       ├── transport/
│       │   └── transport_system.inc
│       ├── tutorial/
│       │   └── tutorial_system.inc
│       ├── ui/
│       │   └── roleplay_ui_system.inc
│       ├── vehicles/
│       │   ├── garage_system.inc
│       │   ├── tuning_system.inc
│       │   └── vehicle_system.inc
│       ├── web/
│       │   └── web_bridge.inc
│       └── ...
├── includes/

Nächste Erweiterungen und laufende Prioritäten

  • Verfeinerung der Player-/State- und Treasury-Konsistenz zwischen Bank, Cash, Faction- und Government-APIs
  • Ausbau der Job-/Faction-/Gang- und Gangwar-Logik mit sauberer Staatspersistenz
  • weitere RP-Module wie Ordnungsamt, Taxi, Dienstleister, Polizei-Dispatch, Events und Wirtschaftsstufen
  • permanente README-/Architekturpflege bei jeder neuen Systemgruppe
  • prepare for real SA:MP compile and runtime tests once Pawn toolchain is available

Hinweis

Dieses Projekt ist bewusst als „modularer RP-Engine-Stack“ konzipiert und nicht als monolithischer Script-Wurstballen. Die Logik ist so strukturiert, dass einzelne große Systeme abseits der gamemode.pwn getrennt erweitert, angepasst und später durch weitere Module ergänzt werden können. │ └── custom/ │ └── sa-mp/ │ └── modern/ │ └── modern_helpers.inc ├── plugins/ │ └── README.md ├── scripts/ │ └── bootstrap_sqlite.py ├── control-panel/ │ ├── README.md │ ├── package.json │ ├── server.js │ └── public/ │ ├── app.js │ ├── index.html │ └── styles.css └── LICENSE


## Kernprinzipien

1. Modularität
   - Keine Monolith-Struktur in `gamemode.pwn`.
   - Jeder logische Bereich ist als eigenes Include/Modul organisiert.
   - Die Systemgrenzen sind bewusst gehalten: Core, Auth, State, Admin, Economy, Jobs, Law, Inventory, Social, UI, Control Panel.

2. Architektonische Fallstricke und Schutzmaßnahmen
   - Pawn kompiliert top-down; Include-Reihenfolge muss sauber sein.
   - `core.inc` muss immer vor allen Spielsystemen eingebunden werden.
   - Module dürfen keine eigene „zweite Wahrheit" für Spielerprofilfelder aufbauen.
   - Der zentrale Zustand sitzt in `gPlayerData[MAX_PLAYERS][E_PLAYER_PROFILE_COUNT]` in `core.inc`.
   - Globale Arrays nur als modulare Cache-/Laufzeitwerte verwenden, nicht als primäre Player-Datenquelle.
   - Beim Hinzufügen eines neuen Moduls zuerst das `E_PLAYER_PROFILE`-Enum erweitern, dann die Zugriffsfunktionen in `core.inc` und danach das Modul anpassen.
   - Für Abhängigkeiten gilt: `db -> core -> state -> admin -> economy -> jobs -> gameplay` als bewährte Reihenfolge.
   - Zustandswerte werden bei Login/Connect/Spawn validiert und normalisiert, damit State-IDs nie außerhalb von LS/SF/LV landen.
   - Admin-Rollen werden zentral über die Player-Profile-Struktur und staatliche Admin-Module konsistent abgeglichen.
   - Jede ernsthafte Erweiterung muss den zentralen State- und Budgetpfad respektieren: `Core_*` -> `StateSystem_*` -> `DB_*` -> `StateBank_*` / `GovernmentSystem_*`.

3. Datenbankabstraktion
   - Standard: SQLite via `_db`/SQLite-Plugin, kompatibel mit `db_*`-Interface.
   - Wechsel zu MySQL 4.1 nur über Backend-Adapter in `db_interface.inc`.
   - Keine direkten DB-Calls in Systemen, nur über Interface-Funktionen.
   - Tabellen wie `player_inventory`, `player_contacts`, `criminal_records`, `vehicle_mods`, `state_bank`, `players` und `factions` sind als gemeinsame Datenbasis konzipiert.
   - Das reale Schema wird über `DB_Initialize()` und die `DB_Ensure*Schema()`-Funktionen zentral und idempotent sichergestellt.
   - Die SQLite-Implementierung bleibt die primäre Laufzeit- und Testbasis; MySQL ist ein Austausch-Backend, nicht eine zweite gleichzeitig aktive Wahrheit.
   - Ebenfalls wichtig: keine Modul- oder State-Logik darf auf harte Zahlenwerte statt auf `Core_IsValidState`/`StateSystem_*` setzen; die Staatlichkeit muss in allen Modulen normalisiert und validiert werden.

4. 3-Staaten-Politik
   - Los Santos, San Fierro und Las Venturas sind eigenständige Staaten.
   - Jeder Staat bekommt:
     - eigene Kasse
     - eigene Steuer- und Finanzlogik
     - eigene State-Admins
     - eigene Event-/Rebellion-/Staatsmissionen
     - eigene Wirtschaft, Jobs, Bize, Fraktionen und Sicherheitssysteme
   - Staatseinnahmen aus Fahrzeugkäufen, Kautionen, Werbe-/Casino- und Business-Einnahmen fließen 1:1 in die entsprechende Staatskasse.

5. Admin-Design
   - 1 globaler Root-/Superadmin
   - 3 Staat-Admin-Systeme (LS/SF/LV)
   - Multi-Level: Support -> Moderator -> Administrator -> Staatsleiter -> Serverowner
   - zusätzlich: 3x/1Admin-Struktur pro Staat und globaler Rang
   - Zugangsrechte werden über zentrale Profilwerte und nicht über parallel verwaltete Array-Kopien validiert.

6. Spieler-Start-Flow
   - Spieler verbindet sich
   - Textdraw-Login/Registrierungsbildschirm erscheint
   - Heimatstadt-Auswahl (LS, SF, LV)
   - Tutorial startet automatisch
   - Staatssystem und Regierungssystem werden geladen
   - Häuser, Bize, Fraktionen und Jobs werden für den gewählten Staat initialisiert
   - Spawn und State-Bindung erfolgen nur über `StateSystem_SpawnPlayerForState()` und `Core_*`-Setter.

7. Reallife-Rahmen und Zyklus
   - Connect → Login/Register → Heimatstadt → Tutorial → Job/Faction/State → Fahrzeug/Tuning → Wirtschaft/Biz → Polizei/Justiz/Medizin → Freizeit/Event → Wiederholung.
   - Alle monetären und staatlichen Transaktionen laufen über die zentrale Bank-/Staatskasse und nicht über lokale, verstreute Arrays.

8. Erweiterungsmodell
   - Neue Module müssen zuerst die DB-Schemas und Core-Profile erweitern.
   - Danach werden Spieler-APIs, UI-Callbacks und State-bezogene Logik ergänzt.
   - Systemgrenzen bleiben fachlich getrennt; cross-cutting logic bleibt in `core.inc`/`state_system.inc`/`db_interface.inc` zentralisiert.

## Moderne Plugins/Includes

Empfohlenes Basis-Stack für diesen Aufbau:

Gerisini GitHub’da oku

Bu sayfa GitHub’ın depo hakkında yayımladıklarından oluşturulur. samp.directory kodu barındırmaz. Bu ilanla ilgili bir sorun bildir

Nexus-Core-Mesh/Nexus-Core-Gamemode: SA-MP Gamemode | samp.directory