No description
  • Rust 71.8%
  • Lua 12%
  • C# 7.5%
  • CSS 3.7%
  • JavaScript 2.7%
  • Other 2.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-26 13:56:23 +01:00
backend feat(architecture): pivot to PostgreSQL, embedded P/Invoke core and full PvE revolution gameplay loops 2026-10-26 13:55:33 +01:00
citizenfx_resources/redsyndicate_core feat(architecture): pivot to PostgreSQL, embedded P/Invoke core and full PvE revolution gameplay loops 2026-10-26 13:55:33 +01:00
config feat(architecture): pivot to PostgreSQL, embedded P/Invoke core and full PvE revolution gameplay loops 2026-10-26 13:55:33 +01:00
docs docs: update walkthrough with PostgreSQL & embedded P/Invoke architecture 2026-10-26 13:56:23 +01:00
.gitignore feat(core): initial architecture of RedSyndicate (CitizenFX + Rust Smart Backend + ArangoDB Graph) 2026-10-25 15:17:14 +01:00
docker-compose.yml feat(architecture): pivot to PostgreSQL, embedded P/Invoke core and full PvE revolution gameplay loops 2026-10-26 13:55:33 +01:00
Makefile feat(core): initial architecture of RedSyndicate (CitizenFX + Rust Smart Backend + ArangoDB Graph) 2026-10-25 15:17:14 +01:00
README.md feat(architecture): pivot to PostgreSQL, embedded P/Invoke core and full PvE revolution gameplay loops 2026-10-26 13:55:33 +01:00

RedSyndicate — Revolution & Territory Warfare Framework (RedM / CitizenFX)

„Proletarier aller Länder, vereinigt euch — auch im Wilden Westen!“
Die 2. Internationale hat das RDR2-Szenario erfasst. Während Fabrikbarone und Großgrundbesitzer mit bezahlten Privatarmeen und korrupter Staatsmacht ihre Monopole sichern wollen, erheben sich die Arbeiter zur Revolution.


1. Kern-Gameplay & Feature-Säulen (100 % Kooperatives PVE)

  1. Revolutionäre Keimzelle & Granulare Welt:

    • Alle neuen Rekruten starten an Benedict Point (New Austin) in einfacher Arbeitskleidung mit Basiswerkzeug.
    • Jede Mine, jedes Dorf, jede Farm, jedes Ölfeld und jeder Bahnhof ist ein eigenes, einnehmbares Territorium (19 handgefertigte RDR2-Zonen von New Austin bis Lemoyne).
    • Das saisonale Finale: Sind alle Außenbezirke befreit, folgt der Sturm auf Saint Denis und das Halten der Stadt gegen massive Wellen bis zum Erhalt der Saint-Denis-Besitzurkunde → Saison-Sieg und Saison-Reset!
  2. Revierkampf & Taktische Enteignung (Stealth vs. Bataillone):

    • Stealth-Option: Bei einem Angriff versucht ein NPC-Wächter zum Alarm-Telefon/Telegrafen zu rennen. Schalten die Spieler ihn rechtzeitig aus, bleibt der Alarm stumm und die Besitzurkunde kann dem Großgrundbesitzer direkt ohne Gegenangriff entwendet werden!
    • Alarm-Verteidigung: Geht der Anruf durch, rücken 2 bis 4 Bataillone (Infanterie, Kavallerie, Schrotflinten-Söldner) an.
    • Stakes: Kein Permadeath. Verwundete Genossen können hochgeholfen werden („Revive“). Geht das gesamte Team down (Wipeout) → Respawn an Benedict Point, wobei alle Waffen von der Bourgeoisie konfisziert werden.
  3. Verteidigung, Bau & Bourgeoisie-Konzil (Spitzel-Netzwerk):

    • Die Großgrundbesitzer beraten im Hintergrund über Gegenangriffe – je mehr Zonen befreit sind, desto nervöser werden sie.
    • Spitzel des Syndikats warnen die Spieler rechtzeitig vor und markieren das Zielgebiet auf der Karte.
    • Angriffe erfolgen nur, wenn Spieler online sind (kein Offline-Raiding).
    • Spieler errichten Hürden, Barrikaden und Sandsäcke zur Verteidigung.
    • NPC-Arbeiter arbeiten bei Lohnzahlung automatisch; aktive Mithilfe der Spieler steigert Moral und Ertrag.
  4. Hybrid-Logistik mit Planwagen:

    • Ein kleiner Grundbedarf fließt automatisch nach Benedict Point. Alle größeren Erz- und Ernteerträge müssen physisch mit Planwagen über das Straßennetz eskortiert werden.
  5. Räte-Demokratie & Gemeinschaftskasse:

    • Demokratische Abstimmungen der Spieler über Arbeiterlöhne, Kassenwarte und Steuersätze an die Gemeinschaftskasse.
    • 3-Säulen-Rüstung: Internationale Solidaritäts-Lieferungen (abhängig vom Befreiungsgrad), Büchsenmacher-Crafting und Raids auf Heeresfestungen (Fort Wallace).

2. Architektur: „Dumb CitizenFX Server, Embedded Rust Core & PostgreSQL“

[ RedM Client (RDR2) ] 
       │  (FiveM NetEvents)
[ Dumb CitizenFX Linux Server (C# ServerMain.cs) ] 
       │  (P/Invoke C-ABI: [DllImport("redsyndicate_core")] -> 0ms In-Process Latenz!)
[ Embedded Rust Core (libredsyndicate_core.so) ] 
       │  (sqlx Binary TCP Connection Pool)
[ PostgreSQL 16 ACID Database ]
  • Embedded Rust Core (libredsyndicate_core.so):
    • Kompiliert als native C-ABI Shared Library (cdylib).
    • 0 ms Netzwerk-Overhead & 0 ms Garbage Collection Pausen.
    • Zonenprüfung, Telefonreichweiten-Check, Bataillons-Kalkulation und Räte-Logik direkt im Server-Speicher.
  • PostgreSQL 16:
    • Relationale Integrität, ACID-Transaktionen für Inventar und Löhne.
    • Graph-Traversierung via PostgreSQL WITH RECURSIVE CTEs für sichere Planwagen-Routen.
  • TeamSpeak + YaCA Plugin:
    • Realistischer 3D-Richtungsfunk, Megafone und Brigade-Frequenzen.

3. Schnellstart & Entwicklung

Voraussetzungen

  • Docker & Docker Compose
  • Rust Toolchain (cargo, rustc 1.80+)
  • PostgreSQL 16 (wird über Docker bereitgestellt)

1. PostgreSQL Datenbank starten

docker compose up -d

Verbindungs-URL: postgres://redsyndicate:redsyndicate_secret@127.0.0.1:5432/redsyndicate

2. Tests ausführen

make test

3. Native Shared Library bauen

make build

Erzeugt backend/target/release/libredsyndicate_core.so (bzw. .dylib auf macOS) für die direkte Einbindung in den CitizenFX C# Server.