Social Media Simulator Wiki - Benutzerbeiträge [de]

RailRoad Games

2026-10-18T09:56:06Z

130.180.44.249: /* Einzelnachweise */

=RailRoad Games=
{{Infobox Unternehmen
| Name=RailRoad Games
| Logo = RailRoad Games Logo.png
| Logobeschreibung = Logo von RailRoad Games
| Kürzel = RRG
| Unternehmensform = Indie-Entwicklerstudio / --- (Kein Unternehmen)
| Gründung = 2023
| Gründer = FeGmbH
| Sitz = (unbekannt, Deutschland)
| Leitung = FeGmbH
| Mitarbeiterzahl = 3
| Branche = Videospiele, Webplattformen, Software
| Produkte = '''Spiele:''' [https://us-wiki.rrgames.org Underground Simulator (Wiki)] [[Social Media Simulator]] '''Plattformen:''' aBookable Online!-Accountsystem '''Technik:''' TrackScript '''Sonstiges:''' [https://deepslatesmp.de/preview DeepslateSMP], Wiki (MediaWiki)
| Programmiersprachen = Java, PHP, JavaScript, HTML/Cascading Style Sheets (CSS)
| Website = https://www.rrgames.org
| Account = ---
| API = ---
| Entwicklerportal = ---
}}

'''RailRoad Games''' (kurz ''RRG'') ist ein Indie-Entwicklerprojekt, das Videospiele, Webplattformen und Entwicklerwerkzeuge herstellt. Zum Portfolio gehören unter anderem die Simulationsspiele ''Underground Simulator'' und ''Social Media Simulator'', die Self-Publishing-Plattform ''aBookable'' (nur angekündigt!), die Erweiterungssprache ''TrackScript'' sowie ein spieleübergreifendes Account-System namens „RailRoad Games Online!“.

Der Name verweist auf das erste Projekt des Studios, den Underground Simulator, in dem es um das Leiten und Verwalten einer Zuggesellschaft geht.

== Geschichte ==
''RailRoad Games'' entstand als Entwicklungsmarke für selbst programmierte Spiele und Webprojekte unter dem Namen QuatschStudio Games.<ref>https://us-wiki.rrgames.org/index.php/Herunterladbarer_Content</ref> Das erste Projekt war der ''Underground Simulator'', eine Multiplayer-Zugsimulation in Java. Dessen Paketstruktur wurde von <code>de.qstudios</code> auf <code>org.rrgames</code> umgestellt, womit das Projekt unter dem Namen RailRoad Games vereinheitlicht wurde.

Im Lauf der Zeit kamen weitere Projekte hinzu: der ''Social Media Simulator'', die Erweiterungssprache ''TrackScript'' (in Arbeit), ein gemeinsames Account-System für alle Spiele (RailRoad Games Online!) (noch nicht öffentlich), ein Wiki für die Dokumentation und die Self-Publishing-Plattform ''aBookable''.

== Projekte ==

=== Underground Simulator ===
Der '''Underground Simulator''' ist ein CLI-basiertes Singleplayer-Spiel in Java. Der Name ist angelehnt an das Londoner U-Bahn- und Bahnnetz. Es gibt eine nicht weiterentwickelte Version eines [[RailRoad Games#Underground Simulator Server (USS)|Multiplayer-Servers]]. Spieler steuern Züge und bewegen sich in einem Netz, das jedoch keineswegs dem Vorbild nachempfunden ist, sondern sich je nach Aktion des Spielers verändert.

Das Spiel besitzt einen ''Wirtschafts- und Karrieremodus'' mit:
* einem ''Shop-System'',
* einer ''Börse mit Aktienkursen''.

=== Underground Simulator Server (USS) ===
Der '''Underground Simulator Server''' (kurz '''USS''') ist die zugehörige Serversoftware zum ''Underground Simulator'' und ermöglicht den Multiplayer-Betrieb.

=== Social Media Simulator ===
Der '''Social Media Simulator''' (kurz '''SMSim''') ist ein Spiel über den Aufbau und Betrieb einer eigenen Social-Media-Plattform. Das Projekt wird derzeit komplett überarbeitet und auf ein sehr hohes Qualitätsniveau gebracht.

Zu den Kernideen gehören:
* '''Engagement-Strategien:''' Spieler können unterschiedliche Schwerpunkte setzen, etwa eher auf Watchtime oder eher auf Herzen und Likes.
* '''Anpassbares Plattformdesign:''' Die Oberfläche der eigenen Plattform lässt sich per Drag-and-drop gestalten. Je mehr schöne, aber teure Komponenten verbaut sind, desto besser bewerten die Nutzer die Plattform.
* '''Dark Patterns als Spielmechanik:''' Unerwünschte Funktionen wie „Konto löschen“ können in zahlreichen Untermenüs versteckt werden.

Im Modding des Spiels kommt wahrscheinlich die Erweiterungssprache [[RailRoad Games#TrackScript|TrackScript]] zum Einsatz.

=== aBookable ===
''aBookable'' (Eigenschreibweise auch '''aBOOKable''') ist eine Self-Publishing-Plattform für Bücher und Hörbücher. Sie ist eine Marke von RailRoad Games und wird gemeinsam mit ZerowFlow entwickelt, einem Freund des Gründers und Mitglied von RailRoad Games.

==== Stand der Entwicklung ====
Es existiert bereits ein Frontend-Prototyp. Die Plattform wird auf eine neue Architektur umgestellt: PHP setzt einen Session-Key, JavaScript rendert die Seite je nach Kontext. Dieses Konzept stammt aus einem separaten Lernprojekt, das selbst nicht weiterverfolgt wird.

==== Geplante Funktionen (Keine Gewähr!) ====
* '''Bewertungen:''' Sternebewertungen und ein editierbarer Kommentar pro gekauftem Buch. Kommentare können je nach Einstellung des Autors oder Verlags erst geprüft werden.
* '''Vorbestellungen und Ankündigungen:''' Nur für verifizierte Autoren und Verlage. Als Käuferschutz erhalten Käufer ihr Geld zurück, wenn das Buch nicht binnen eines Monats erscheint. Der Autor erhält das Geld erst bei Veröffentlichung.
* '''Besitzgarantie:''' Wird ein Buch aus dem Sortiment genommen, behalten bereits zahlende Käufer ihre Datei.
* '''aBOOKable Pro:''' Ein Buch oder Hörbuch pro Monat gratis. Zunächst nicht käuflich, sondern etwa über Verlosungen vergeben.
* '''Umgang mit Raubkopien:''' Geklaute oder raubkopierte Bücher werden samt Account gelöscht. Bei verifizierten Accounts wird vorher Kontakt aufgenommen.

==== Entwicklungsreihenfolge ====
Nach dem Umbau des PHP-Grundgerüsts folgt zuerst die Infrastruktur zum Laden echter Bücher (Datei-Storage sowie Besitz und Bibliothek). Bewertungen, Vorbestellungen, aBOOKable Pro und das Piraterie-Handling kommen danach.

[[File:ABOOKable Logo (2026).png|thumb|aBOOKable Logo (Preview/2026)]]
[[File:ABOOKable Prototype Header.png|thumb|aBOOKable Prototype Header (Preview/2026)]]

=== TrackScript ===
'''TrackScript''' ist eine Erweiterungs- und Extension-Sprache für RailRoad-Games-Projekte. Sie ist nicht auf ein Spiel/Projekt beschränkt, hat aber gewisse Limitierungen, ist ansonsten recht weitläufig. Im Modding des [[RailRoad Games#Social Media Simulator|Social Media Simulator]] wird sie bereits verwendet; Testdateien tragen die Endungen <code>.rail</code> (Sourcecode) bzw. <code>.track</code> (kompiliert).

==== Grundkonzept (Oktober 2026) ====
Das Konzept beschreibt Interpreter und API für '''Java''' und '''PHP'''. Die PHP-Host-API umfasst Klassen, Builder und Limits, Runtime-Methoden, die Typabbildung (<code>TsMap</code>, <code>TsData</code>, <code>TsFunction</code>), das Attribut <code><nowiki>#[TsExpose]</nowiki></code> sowie Fehler, Diagnosen und Policy.

Die Java-API ist noch nicht ausgearbeitet.

==== Berechtigungsmodell ====
Erweiterungen deklarieren ihre Berechtigungen im Manifest. Beispiele:

{| class="wikitable"
! Bereich !! Berechtigungen
|-
| Host
| <code>host.log</code>, <code>host.fs.read</code>/<code>write</code> (mit Scopes <code><nowiki>[workspace]</nowiki></code>, <code><nowiki>[temp]</nowiki></code>, <code><nowiki>[const]</nowiki></code>, <code><nowiki>[sys]</nowiki></code>), <code>host.resources.cpu</code>/<code>gpu</code>/<code>mem</code>/<code>stack</code>, <code>host.envvar</code>, <code>host.supproc</code>, <code>host.ipc</code> ('''I'''nter '''P'''lugin '''C'''ommunication), <code>host.media</code>, <code>host.connections</code> (Bluetooth/WLAN)
|-
| Netzwerk
| <code>network.tcp</code>, <code>network.http</code>, <code>network.rrg-data</code>
|}

Dazu gibt es '''drei Sicherheitsstufen:'''
# '''Stufe 1:''' automatisch erlaubt.
# '''Stufe 2:''' Bestätigung per Nutzer-Dialog.
# '''Stufe 3:''' Betriebssystem- oder Admin-Passwort plus Haftungsausschluss-Checkbox.

=== Online!-Account-System ===
Das '''Online!'''-System ist ein zentraler '''OAuth2'''-Account, der über mehrere RailRoad-Games-Spiele hinweg gilt, derzeit geplant für den [[RailRoad Games#Social Media Simulator|Social Media Simulator]] und den [[RailRoad Games#Underground Simulator|Underground Simulator]].

==== Technischer Stand ====
* OAuth2 mit '''PKCE''' (RFC 7636) statt eines festen Client Secrets.
* Als Nutzerkennung dient eine getrimmte hexadezimale UUID im Java-Stil, nicht das @-Handle.
* Grundprinzip: Punkte, Ränge und ähnliche Werte werden '''serverseitig berechnet''' und sind clientseitig (z. B. per JavaScript) nicht manipulierbar.

==== Geplante Funktionen ====
* '''Spieldaten:''' höchste Wins, Playgames, gespielte Server
* '''Ränge,''' unter anderem über '''TrackPoints''' und weitere Wege
* '''Savegames''' (mindestens 5 Slots, genaue Anzahl offen)
* '''Advancements'''
* '''Profil-Einstellungen:''' Name und @-Handle ändern
* '''Status:''' Online, AFK, Offline
* '''Freunde:''' für lokal gehostete Spiele, Nachrichten auf Servern
* '''Consent-Screen:''' Firmenname, Verified-Häkchen für vertrauenswürdige Apps, Warnhinweis bei nicht selbst entwickelten Drittanbieter-Apps

==== Infrastruktur ====
'''Folgende Tabelle ist noch nicht final!'''

{| class="wikitable"
! Adresse !! Zweck
|-
| <code>account.rrgames.org</code> || Authentifizierung
|-
| <code>api.rrgames.org</code> || API (durch API-Key geschützt)
|-
| <code>account.rrgames.org/developers/</code> || Entwicklerportal
|}

Im '''Entwicklerportal''' sollen Entwickler eigene API-Keys und OAuth2-Clients erstellen, ein Profil-Onboarding beim ersten Besuch durchlaufen und Apps mit Firmenname und Support-URL anlegen können. Später sollen dort Mods im Developer-Forum veröffentlicht werden. „DEV“ ist als Rang beziehungsweise Abzeichen vorgesehen.

[[File:RailRoad Games Online! Consent Screen.png|thumb|Consent Screen (Preview)]]
[[File:RailRoad Games Online! Dashboard.png|thumb|RRG Online!-Accountseite Dashboard (Preview)]]

=== Wiki und Dokumentation ===
Für seine Spiele betreibt RailRoad Games ein '''Dokumentations-Wiki im GitBook-Stil''', basierend auf '''MediaWiki 1.45'''. Das Wiki für den Social Media Simulator findet man unter [https://sms-wiki.rrgames.org sms-wiki.rrgames.org], das Wiki des Underground Simulator unter [https://us-wiki.rrgames.org us-wiki.rrgames.org].

Entstanden ist es aus der Entscheidung, statt eines eigenen PHP-Spiels mit Login und Datenbank lieber eine Doku-Seite für beide Spiele zu bauen, und zwar auf MediaWiki statt auf einer komplett eigenen PHP-Engine.

==== Eigene Erweiterungen ====
* '''VersionLinks:''' Versioniert Artikel nach global registrierbaren ''Versionen'' statt nach Sprachen. Ein Auswahlmenü im Artikel wechselt die Version, ein Artikel kann für mehrere Versionen eingetragen werden. Die Erweiterung ist installiert. Sie ist aktuell noch nicht im Internet verfügbar.
* '''Git-Code-Seiten (in Planung):''' Verlinkt ein Git-Repository und zeigt Dateien als Wiki-Seiten <code><nowiki>Code:<Pfad></nowiki></code> (z. B. <code>src/main/cpp/main.cpp</code>). Dazu kommen Inline-Kommentare, Inline-Überschriften und Seitenzusammenfassungen, ohne das Repository zu verändern, ähnlich wie bei einem Jupyter Notebook.

=== DeepslateSMP ===
'''DeepslateSMP''' ist ein Minecraft-Survival-Multiplayer-Server ([https://www.deepslatesmp.de/preview deepslatesmp.de] v2-Website), der vom Betreiber der Marke geführt wird. Er besitzt eine eigene '''Landingpage''' aus PHP, HTML, CSS und JavaScript (Tailwind CSS über CDN).

== Technologie ==
{| class="wikitable"
! Bereich !! Eingesetzt
|-
| Spiele (CLI, Server) || Java
|-
| Web und Backend (Social Media Sim) || PHP
|-
| Frontend || HTML, CSS, JavaScript, Tailwind CSS
|-
| Authentifizierung || OAuth2 mit PKCE (PHP)
|-
| Dokumentation || MediaWiki
|-
| Eigene Sprache || TrackScript (Compiler/Runtime in Java, Host-API für Java und PHP)
|}

== Zusammenarbeit ==
Die meisten Projekte werden vom Gründer allein entwickelt. Bei der Plattform [[RailRoad Games#aBookable|aBookable]] arbeitet er mit seinem Freund '''ZerowFlow''' zusammen, der eigene Feature-Ideen einbringt.

== Zukunftspläne ==
* Fertigstellung des '''Online!-Account-Systems'''
* Vollständige Überarbeitung des '''Social Media Simulator'''
* Compiler und Runtime für '''TrackScript''' in Java
* Infrastruktur für echte Bücher bei '''aBookable'''
* Erweiterung des Wikis um die '''Git-Code-Seiten'''
* Ausbau des '''Entwicklerportals''' inklusive Developer-Forum für Mods

== Weblinks ==
* [https://www.rrgames.org Offizielle Website]
* [https://deepslatesmp.de DeepslateSMP]

== Einzelnachweise ==
<references />

Vorlage:Infobox Unternehmen

2026-10-17T18:50:39Z

130.180.44.249:

{| class="toccolours infobox float-right toptextcells" style="font-size:90%; max-width:25em; margin-top:0;"
|-
! colspan="2" style="font-size:110%; background-color: #eaecf0;" | {{{Name|{{PAGENAME}}}}}}
|-
| colspan="2" style="text-align:center; padding:1em 0;" | [[Datei:{{{Logo}}}|250x175px|rahmenlos|zentriert]]
}}
{{#if: {{{Unternehmensform|}}} |
|-
! style="font-weight:bold; text-align:left;" | Rechtsform
| {{{Unternehmensform}}}
}}
{{#if: {{{ISIN|}}} |
{{#ifeq: {{{ISIN}}} | nicht vorhanden | |
|-
! style="font-weight:bold; text-align:left;" | ISIN
| [https://www.boerse-frankfurt.de/aktie/{{{ISIN}}} {{{ISIN}}}]
}}
}}
{{#if: {{{Gründungsdatum|}}} |
|-
! style="font-weight:bold; text-align:left;" | Gründung
| {{{Gründungsdatum}}}
}}
{{#if: {{{Auflösungsdatum|}}} |
|-
! style="font-weight:bold; text-align:left;" | Auflösung
| {{{Auflösungsdatum}}}
}}
{{#if: {{{Auflösungsgrund|}}} |
|-
! style="font-weight:bold; text-align:left;" | Auflösungsgrund
| {{{Auflösungsgrund}}}
}}
{{#if: {{{Sitz|}}} |
|-
! style="font-weight:bold; text-align:left;" | Sitz
| {{{Sitz}}}
}}
{{#if: {{{Leitung|}}} |
|-
! style="font-weight:bold; text-align:left;" | Leitung
| {{{Leitung}}}
}}
{{#if: {{{Mitarbeiterzahl|}}} |
|-
! style="font-weight:bold; text-align:left;" | Mitarbeiterzahl
| {{{Mitarbeiterzahl}}}
}}
{{#if: {{{Umsatz|}}} |
|-
! style="font-weight:bold; text-align:left;" | Umsatz
| {{{Umsatz}}}
}}
{{#if: {{{Branche|}}} |
|-
! style="font-weight:bold; text-align:left;" | Branche
| {{{Branche}}}
}}
{{#if: {{{Homepage|{{{Website|}}}}}} |
|-
! style="font-weight:bold; text-align:left;" | Website
| [https://{{{Homepage|{{{Website}}}}}} {{{Homepage|{{{Website}}}}}}]
}}
{{#if: {{{Stand|}}} |
|-
| colspan="2" style="font-size:80%;" | Stand: {{{Stand}}}
}}
|}

API-Dokumentation

2026-09-11T18:09:56Z

130.180.44.249:

__NOTOC__
Mit dieser API-Schnittstelle kommuniziert der Client (Frontend) des Social Media Simulators mit dem Spring Boot-Backend, um Spielstände zu initialisieren und abzurufen.
{{#version:1.0}}
== Endpunkte Übersicht ==
[[#POST|POSTs]] <nowiki>|</nowiki> [[#GET|GETs]]
=== GET ===
{| class="wikitable" style="width:100%; border-radius: 8px; overflow: hidden;"
! style="width: 15%;" | Methode
! style="width: 35%;" | Endpunkt
! Beschreibung
! style="width: 20%;" | Parameter (falls vorhanden)
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/active</code>
| Gibt, wenn der Backend-Prozess läuft, immer true zurück.
| ---
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/game?id={id}</code>
| Gibt, wenn der Backend-Prozess läuft, immer true zurück.
| <nowiki>id | String | Spiel-UUID</nowiki>
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/init</code>
| Generiert eine neue Spieler-UUID (UTF-16).
| ---
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/game/stream?id={id}</code>
| Gibt SSE-Stream der Updates zurück.
| <nowiki>id | String | Spiel-UUID</nowiki>
|-
|}
=== POST ===
{| class="wikitable" style="width:100%; border-radius: 8px; overflow: hidden;"
! style="width: 15%;" | Methode
! style="width: 35%;" | Endpunkt
! Beschreibung
! style="width: 35%;" | Parameter (falls vorhanden)
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/game/init_recall?id={id}</code>
| Initialisiert ein neues Spiel mit einer Konfiguration, gespeichert mit `id` als Key.
|<nowiki> id | String | Spiel-UUID</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/shop/buy?id={id}&item={item}</code>
| Kauft dem Spieler das Item, welches angegeben ist.
|<nowiki> id | String | Spiel-UUID | item | String | Shop-Item-ID</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/tech/unlock?id={id}&tech={tech}&cost={cost}</code>
| Schaltet Technologie aus dem Tech-Tree frei.
|<nowiki> id | String | Spiel-UUID | tech | String Tech-Item-ID | cost | Integer | FP Kosten</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/infrasctructure/build?id={id}&lat={lat}&lng={lng}&name={name}</code>
| Errichtet nach Parametern ein Data Center. Standort wird nicht mitgeliefert!
|<nowiki> id | String | Spiel-UUID | lat | Zahl mit Nachkommastelle | Latenz | lng | Zahl mit Nachkommastelle | Sprache | name | String | Name des Rechenzentrums</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/infrasctructure/repair?id={id}&index={index}</code>
| Repariert ein defektes Rechenzentrum.
|<nowiki> id | String | Spiel-UUID | index | Integer | Index der Liste der Rechenzentren</nowiki>
|}

== Dokumentation der Endpunkte ==

=== 1. Spieler-UUID generieren ===
* '''Endpunkt:''' <code>/api/init</code>
* '''Methode:''' GET
* '''Format:''' <code>text/plain;charset=utf-16</code>

Diese Methode generiert eine neue, eindeutige V4-UUID, registriert sie im RAM des Servers in der aktiven Spielerliste und gibt sie als Byte-Array im UTF-16-Format zurück.

==== Rückgabe (Response) (Bsp.!) ====
<pre>
4f3b89a2-1e4d-4c6a-9b88-123456789abc
</pre>

---
=== 2. Spielstand abrufen ===
* '''Endpunkt:''' <code>/api/game</code>
* '''Methode:''' GET
* '''Format:''' <code>application/json</code>

Gibt den aktuellen Zustand der laufenden Simulation für die übergebene UUID zurück. Der Client nutzt diesen Endpunkt für den regelmäßigen Sync oder beim Neuladen des Dashboards.

==== Query-Parameter ====
{| class="wikitable"
! Parameter
! Typ
! Pflichtfeld
! Beschreibung
|-
| <code>id</code>
| UUID
| Ja
| Die eindeutige Kennung des Spielers, die über <code>/api/init</code> generiert wurde.
|}

==== Rückgabe (Response) ====
* '''Status 200 (Erfolgreich):''' Gibt das <code>GameResponse</code>-JSON-Objekt zurück, wenn die UUID existiert. Falls die ID nicht in der aktiven Spielerliste registriert ist, wird <code>null</code> zurückgegeben.

<pre>
{
"playerId": "4f3b89a2-1e4d-4c6a-9b88-123456789abc",
"companyName": "QuatschStudio Tech",
"money": 50000,
"employees": 1,
"researchPoints": 0
}
</pre>

===== Parameter-Spezifikation =====
{| class="wikitable"
! Feld
! Typ
! Beschreibung
|-
| <code>playerId</code>
| String (UUID)
| Die UUID des Spielers zur Validierung auf Client-Seite.
|-
| <code>companyName</code>
| String
| Der Name des Social-Media-Unternehmens.
|-
| <code>money</code>
| Integer
| Der aktuelle Kontostand des Unternehmens im Spiel.
|-
| <code>employees</code>
| Integer
| Die Anzahl der derzeit eingestellten Mitarbeiter.
|-
| <code>researchPoints</code>
| Integer
| Die aktuell angesammelten Forschungspunkte für neue Features oder Algorithmen-Upgrades.
|}
---
=== 3. Spiel initialisieren ===
* '''Endpunkt:''' <code>/api/game/init_recall</code>
* '''Methode:''' POST
* '''Format:''' <code>application/json</code>

Initialisiert die Spielmechaniken für eine bereits generierte UUID auf Basis der übergebenen Unternehmenseinstellungen im Request-Body.

==== Query-Parameter ====
{| class="wikitable"
! Parameter
! Typ
! Pflichtfeld
! Beschreibung
|-
| <code>id</code>
| UUID
| Ja
| Die ID des Spielers, für den das Spiel gestartet wird.
|}

==== Payload (Request Body) ====
Übergabe des <code>GameConfigDTO</code> als JSON-Objekt:
<pre>
{
"companyName": "QuatschStudio Tech",
"infiniteMoney": false,
"startMoney": 50000,
"startEmployees": 1,
"startResearch": 0
}
</pre>

===== Parameter-Spezifikation =====
{| class="wikitable"
! Feld
! Typ
! Beschreibung
|-
| <code>companyName</code>
| String
| Der Name des zu gründenden Social-Media-Unternehmens.
|-
| <code>infiniteMoney</code>
| Boolean
| Sandbox-Modus. Wenn <code>true</code>, ist das Startkapital unbegrenzt.
|-
| <code>startMoney</code>
| Integer
| Das verfügbare Startkapital bei Spielbeginn.
|-
| <code>startEmployees</code>
| Integer
| Die Anzahl der Mitarbeiter, mit denen das Unternehmen startet.
|-
| <code>startResearch</code>
| Integer
| Der initiale Wert für bereits generierte Forschungspunkte.
|}

==== Server-Log (SLF4J) ====
Beim Aufruf triggert der Controller einen Log-Eintrag auf dem Server (Bsp.!):
<pre>
2026-06-16T20:23:28.789+02:00 INFO 523700 --- [nio-8080-exec-6] o.r.smsim.api.controller.GameController : Setting up Game for 737e1e57-3e1d-4f0e-b1a8-1fcad8c145d0:GameConfigDTO [companyName=adsf, infiniteMoney=false, startMoney=1000, startEmployees=1, startResearch=0]

</pre>
[[index.php?title=Kategorie:Entwickler-Dokumentation]]

API-Dokumentation

2026-09-11T18:08:21Z

130.180.44.249: /* POST */

__NOTOC__
Mit dieser API-Schnittstelle kommuniziert der Client (Frontend) des Social Media Simulators mit dem Spring Boot-Backend, um Spielstände zu initialisieren und abzurufen.
{{#version:1.0}}
== Endpunkte Übersicht ==
[[#POST|POSTs]] <nowiki>|</nowiki> [[#GET|GETs]]
=== GET ===
{| class="wikitable" style="width:100%; border-radius: 8px; overflow: hidden;"
! style="width: 15%;" | Methode
! style="width: 35%;" | Endpunkt
! Beschreibung
! style="width: 20%;" | Parameter (falls vorhanden)
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/active</code>
| Gibt, wenn der Backend-Prozess läuft, immer true zurück.
| ---
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/game?id={id}</code>
| Gibt, wenn der Backend-Prozess läuft, immer true zurück.
| <nowiki>id | String | Spiel-UUID</nowiki>
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/init</code>
| Generiert eine neue Spieler-UUID (UTF-16).
| ---
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/game/stream?id={id}</code>
| Gibt SSE-Stream der Updates zurück.
| <nowiki>id | String | Spiel-UUID</nowiki>
|-
|}
=== POST ===
{| class="wikitable" style="width:100%; border-radius: 8px; overflow: hidden;"
! style="width: 15%;" | Methode
! style="width: 35%;" | Endpunkt
! Beschreibung
! style="width: 35%;" | Parameter (falls vorhanden)
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/game/init_recall?id={id}</code>
| Initialisiert ein neues Spiel mit einer Konfiguration, gespeichert mit `id` als Key.
|<nowiki> id | String | Spiel-UUID</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/shop/buy?id={id}&item={item}</code>
| Kauft dem Spieler das Item, welches angegeben ist.
|<nowiki> id | String | Spiel-UUID item | String Shop-Item-ID</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/tech/unlock?id={id}&tech={tech}&cost={cost}</code>
| Schaltet Technologie aus dem Tech-Tree frei.
|<nowiki> id | String | Spiel-UUID tech | String Tech-Item-ID cost | Integer | FP Kosten</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/infrasctructure/build?id={id}&lat={lat}&lng={lng}&name={name}</code>
| Errichtet nach Parametern ein Data Center. Standort wird nicht mitgeliefert!
|<nowiki> id | String | Spiel-UUID lat | Zahl mit Nachkommastelle | Latenz | lng Zahl mit Nachkommastelle Sprache | name String | Name des Rechenzentrums</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/infrasctructure/repair?id={id}&index={index}</code>
| Repariert ein defektes Rechenzentrum.
|<nowiki> id | String | Spiel-UUID index | Integer | Index der Liste der Rechenzentren</nowiki>
|}

== Dokumentation der Endpunkte ==

=== 1. Spieler-UUID generieren ===
* '''Endpunkt:''' <code>/api/init</code>
* '''Methode:''' GET
* '''Format:''' <code>text/plain;charset=utf-16</code>

Diese Methode generiert eine neue, eindeutige V4-UUID, registriert sie im RAM des Servers in der aktiven Spielerliste und gibt sie als Byte-Array im UTF-16-Format zurück.

==== Rückgabe (Response) (Bsp.!) ====
<pre>
4f3b89a2-1e4d-4c6a-9b88-123456789abc
</pre>

---
=== 2. Spielstand abrufen ===
* '''Endpunkt:''' <code>/api/game</code>
* '''Methode:''' GET
* '''Format:''' <code>application/json</code>

Gibt den aktuellen Zustand der laufenden Simulation für die übergebene UUID zurück. Der Client nutzt diesen Endpunkt für den regelmäßigen Sync oder beim Neuladen des Dashboards.

==== Query-Parameter ====
{| class="wikitable"
! Parameter
! Typ
! Pflichtfeld
! Beschreibung
|-
| <code>id</code>
| UUID
| Ja
| Die eindeutige Kennung des Spielers, die über <code>/api/init</code> generiert wurde.
|}

==== Rückgabe (Response) ====
* '''Status 200 (Erfolgreich):''' Gibt das <code>GameResponse</code>-JSON-Objekt zurück, wenn die UUID existiert. Falls die ID nicht in der aktiven Spielerliste registriert ist, wird <code>null</code> zurückgegeben.

<pre>
{
"playerId": "4f3b89a2-1e4d-4c6a-9b88-123456789abc",
"companyName": "QuatschStudio Tech",
"money": 50000,
"employees": 1,
"researchPoints": 0
}
</pre>

===== Parameter-Spezifikation =====
{| class="wikitable"
! Feld
! Typ
! Beschreibung
|-
| <code>playerId</code>
| String (UUID)
| Die UUID des Spielers zur Validierung auf Client-Seite.
|-
| <code>companyName</code>
| String
| Der Name des Social-Media-Unternehmens.
|-
| <code>money</code>
| Integer
| Der aktuelle Kontostand des Unternehmens im Spiel.
|-
| <code>employees</code>
| Integer
| Die Anzahl der derzeit eingestellten Mitarbeiter.
|-
| <code>researchPoints</code>
| Integer
| Die aktuell angesammelten Forschungspunkte für neue Features oder Algorithmen-Upgrades.
|}
---
=== 3. Spiel initialisieren ===
* '''Endpunkt:''' <code>/api/game/init_recall</code>
* '''Methode:''' POST
* '''Format:''' <code>application/json</code>

Initialisiert die Spielmechaniken für eine bereits generierte UUID auf Basis der übergebenen Unternehmenseinstellungen im Request-Body.

==== Query-Parameter ====
{| class="wikitable"
! Parameter
! Typ
! Pflichtfeld
! Beschreibung
|-
| <code>id</code>
| UUID
| Ja
| Die ID des Spielers, für den das Spiel gestartet wird.
|}

==== Payload (Request Body) ====
Übergabe des <code>GameConfigDTO</code> als JSON-Objekt:
<pre>
{
"companyName": "QuatschStudio Tech",
"infiniteMoney": false,
"startMoney": 50000,
"startEmployees": 1,
"startResearch": 0
}
</pre>

===== Parameter-Spezifikation =====
{| class="wikitable"
! Feld
! Typ
! Beschreibung
|-
| <code>companyName</code>
| String
| Der Name des zu gründenden Social-Media-Unternehmens.
|-
| <code>infiniteMoney</code>
| Boolean
| Sandbox-Modus. Wenn <code>true</code>, ist das Startkapital unbegrenzt.
|-
| <code>startMoney</code>
| Integer
| Das verfügbare Startkapital bei Spielbeginn.
|-
| <code>startEmployees</code>
| Integer
| Die Anzahl der Mitarbeiter, mit denen das Unternehmen startet.
|-
| <code>startResearch</code>
| Integer
| Der initiale Wert für bereits generierte Forschungspunkte.
|}

==== Server-Log (SLF4J) ====
Beim Aufruf triggert der Controller einen Log-Eintrag auf dem Server (Bsp.!):
<pre>
2026-06-16T20:23:28.789+02:00 INFO 523700 --- [nio-8080-exec-6] o.r.smsim.api.controller.GameController : Setting up Game for 737e1e57-3e1d-4f0e-b1a8-1fcad8c145d0:GameConfigDTO [companyName=adsf, infiniteMoney=false, startMoney=1000, startEmployees=1, startResearch=0]

</pre>
[[index.php?title=Kategorie:Entwickler-Dokumentation]]

API-Dokumentation

2026-09-11T18:07:25Z

130.180.44.249:

__NOTOC__
Mit dieser API-Schnittstelle kommuniziert der Client (Frontend) des Social Media Simulators mit dem Spring Boot-Backend, um Spielstände zu initialisieren und abzurufen.
{{#version:1.0}}
== Endpunkte Übersicht ==
[[#POST|POSTs]] <nowiki>|</nowiki> [[#GET|GETs]]
=== GET ===
{| class="wikitable" style="width:100%; border-radius: 8px; overflow: hidden;"
! style="width: 15%;" | Methode
! style="width: 35%;" | Endpunkt
! Beschreibung
! style="width: 20%;" | Parameter (falls vorhanden)
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/active</code>
| Gibt, wenn der Backend-Prozess läuft, immer true zurück.
| ---
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/game?id={id}</code>
| Gibt, wenn der Backend-Prozess läuft, immer true zurück.
| <nowiki>id | String | Spiel-UUID</nowiki>
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/init</code>
| Generiert eine neue Spieler-UUID (UTF-16).
| ---
|-
| style="background-color: #28a745; color: white; font-weight: bold; text-align: center;" | GET
| <code>/api/game/stream?id={id}</code>
| Gibt SSE-Stream der Updates zurück.
| <nowiki>id | String | Spiel-UUID</nowiki>
|-
|}
=== POST ===
{| class="wikitable" style="width:100%; border-radius: 8px; overflow: hidden;"
! style="width: 15%;" | Methode
! style="width: 35%;" | Endpunkt
! Beschreibung
! style="width: 20%;" | Parameter (falls vorhanden)
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/game/init_recall?id={id}</code>
| Initialisiert ein neues Spiel mit einer Konfiguration, gespeichert mit `id` als Key.
|<nowiki> id | String | Spiel-UUID</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/shop/buy?id={id}&item={item}</code>
| Kauft dem Spieler das Item, welches angegeben ist.
|<nowiki> id | String | Spiel-UUID item | String Shop-Item-ID</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/tech/unlock?id={id}&tech={tech}&cost={cost}</code>
| Schaltet Technologie aus dem Tech-Tree frei.
|<nowiki> id | String | Spiel-UUID tech | String Tech-Item-ID cost | Integer | FP Kosten</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/infrasctructure/build?id={id}&lat={lat}&lng={lng}&name={name}</code>
| Errichtet nach Parametern ein Data Center. Standort wird nicht mitgeliefert!
|<nowiki> id | String | Spiel-UUID lat | Zahl mit Nachkommastelle | Latenz | lng Zahl mit Nachkommastelle Sprache | name String | Name des Rechenzentrums</nowiki>
|-
| style="background-color: #007bff; color: white; font-weight: bold; text-align: center;" | POST
| <code>/api/infrasctructure/repair?id={id}&index={index}</code>
| Repariert ein defektes Rechenzentrum.
|<nowiki> id | String | Spiel-UUID index | Integer | Index der Liste der Rechenzentren</nowiki>
|}

== Dokumentation der Endpunkte ==

=== 1. Spieler-UUID generieren ===
* '''Endpunkt:''' <code>/api/init</code>
* '''Methode:''' GET
* '''Format:''' <code>text/plain;charset=utf-16</code>

Diese Methode generiert eine neue, eindeutige V4-UUID, registriert sie im RAM des Servers in der aktiven Spielerliste und gibt sie als Byte-Array im UTF-16-Format zurück.

==== Rückgabe (Response) (Bsp.!) ====
<pre>
4f3b89a2-1e4d-4c6a-9b88-123456789abc
</pre>

---
=== 2. Spielstand abrufen ===
* '''Endpunkt:''' <code>/api/game</code>
* '''Methode:''' GET
* '''Format:''' <code>application/json</code>

Gibt den aktuellen Zustand der laufenden Simulation für die übergebene UUID zurück. Der Client nutzt diesen Endpunkt für den regelmäßigen Sync oder beim Neuladen des Dashboards.

==== Query-Parameter ====
{| class="wikitable"
! Parameter
! Typ
! Pflichtfeld
! Beschreibung
|-
| <code>id</code>
| UUID
| Ja
| Die eindeutige Kennung des Spielers, die über <code>/api/init</code> generiert wurde.
|}

==== Rückgabe (Response) ====
* '''Status 200 (Erfolgreich):''' Gibt das <code>GameResponse</code>-JSON-Objekt zurück, wenn die UUID existiert. Falls die ID nicht in der aktiven Spielerliste registriert ist, wird <code>null</code> zurückgegeben.

<pre>
{
"playerId": "4f3b89a2-1e4d-4c6a-9b88-123456789abc",
"companyName": "QuatschStudio Tech",
"money": 50000,
"employees": 1,
"researchPoints": 0
}
</pre>

===== Parameter-Spezifikation =====
{| class="wikitable"
! Feld
! Typ
! Beschreibung
|-
| <code>playerId</code>
| String (UUID)
| Die UUID des Spielers zur Validierung auf Client-Seite.
|-
| <code>companyName</code>
| String
| Der Name des Social-Media-Unternehmens.
|-
| <code>money</code>
| Integer
| Der aktuelle Kontostand des Unternehmens im Spiel.
|-
| <code>employees</code>
| Integer
| Die Anzahl der derzeit eingestellten Mitarbeiter.
|-
| <code>researchPoints</code>
| Integer
| Die aktuell angesammelten Forschungspunkte für neue Features oder Algorithmen-Upgrades.
|}
---
=== 3. Spiel initialisieren ===
* '''Endpunkt:''' <code>/api/game/init_recall</code>
* '''Methode:''' POST
* '''Format:''' <code>application/json</code>

Initialisiert die Spielmechaniken für eine bereits generierte UUID auf Basis der übergebenen Unternehmenseinstellungen im Request-Body.

==== Query-Parameter ====
{| class="wikitable"
! Parameter
! Typ
! Pflichtfeld
! Beschreibung
|-
| <code>id</code>
| UUID
| Ja
| Die ID des Spielers, für den das Spiel gestartet wird.
|}

==== Payload (Request Body) ====
Übergabe des <code>GameConfigDTO</code> als JSON-Objekt:
<pre>
{
"companyName": "QuatschStudio Tech",
"infiniteMoney": false,
"startMoney": 50000,
"startEmployees": 1,
"startResearch": 0
}
</pre>

===== Parameter-Spezifikation =====
{| class="wikitable"
! Feld
! Typ
! Beschreibung
|-
| <code>companyName</code>
| String
| Der Name des zu gründenden Social-Media-Unternehmens.
|-
| <code>infiniteMoney</code>
| Boolean
| Sandbox-Modus. Wenn <code>true</code>, ist das Startkapital unbegrenzt.
|-
| <code>startMoney</code>
| Integer
| Das verfügbare Startkapital bei Spielbeginn.
|-
| <code>startEmployees</code>
| Integer
| Die Anzahl der Mitarbeiter, mit denen das Unternehmen startet.
|-
| <code>startResearch</code>
| Integer
| Der initiale Wert für bereits generierte Forschungspunkte.
|}

==== Server-Log (SLF4J) ====
Beim Aufruf triggert der Controller einen Log-Eintrag auf dem Server (Bsp.!):
<pre>
2026-06-16T20:23:28.789+02:00 INFO 523700 --- [nio-8080-exec-6] o.r.smsim.api.controller.GameController : Setting up Game for 737e1e57-3e1d-4f0e-b1a8-1fcad8c145d0:GameConfigDTO [companyName=adsf, infiniteMoney=false, startMoney=1000, startEmployees=1, startResearch=0]

</pre>
[[index.php?title=Kategorie:Entwickler-Dokumentation]]

Social Media Simulator Wiki:Datenschutz

2026-07-10T05:19:26Z

130.180.44.249: Die Seite wurde neu angelegt: „= Datenschutzerklärung = == Allgemeine Hinweise == Der Schutz Ihrer persönlichen Daten ist uns ein wichtiges Anliegen. In dieser Datenschutzerklärung informieren wir Sie darüber, welche personenbezogenen Daten bei der Nutzung dieses Wikis erhoben und wie diese verwendet werden. == Verantwortliche Stelle == Verantwortlich für die Datenverarbeitung in diesem Wiki ist: :'''Betreiber:''' RailRoad Games :'''E-Mail:''' info@rrgames.org == Erhebung und…“

= Datenschutzerklärung =

== Allgemeine Hinweise ==
Der Schutz Ihrer persönlichen Daten ist uns ein wichtiges Anliegen. In dieser Datenschutzerklärung informieren wir Sie darüber, welche personenbezogenen Daten bei der Nutzung dieses Wikis erhoben und wie diese verwendet werden.

== Verantwortliche Stelle ==
Verantwortlich für die Datenverarbeitung in diesem Wiki ist:

:'''Betreiber:''' RailRoad Games
:'''E-Mail:''' info@rrgames.org

== Erhebung und Speicherung personenbezogener Daten ==

=== Beim Besuch des Wikis ===
Beim Aufrufen dieses Wikis werden automatisch Informationen durch die Server erfasst. Diese sind:

* IP-Adresse
* Datum und Uhrzeit der Anfrage
* Browsertyp und Browserversion
* Verwendetes Betriebssystem
* Referrer-URL

Diese Daten dienen ausschließlich der Sicherstellung eines störungsfreien Betriebs der Seite sowie der Verbesserung unseres Angebots.

=== Bei Registrierung und Bearbeitung ===
Wenn Sie sich in diesem Wiki registrieren, werden folgende Daten gespeichert:

* Benutzername
* E-Mail-Adresse (sofern angegeben)
* Zeitstempel von Bearbeitungen
* IP-Adressen bei Bearbeitungen (intern gespeichert)

Bitte beachten Sie, dass Bearbeitungen öffentlich einsehbar und dauerhaft gespeichert werden.

== Cookies ==
Dieses Wiki verwendet Cookies, um grundlegende Funktionen bereitzustellen (z. B. Login-Status, Spracheinstellungen). Sie können die Speicherung von Cookies in Ihrem Browser einschränken oder deaktivieren.

== Weitergabe von Daten ==
Eine Weitergabe personenbezogener Daten an Dritte erfolgt nicht, außer wenn dies gesetzlich vorgeschrieben ist.

== Speicherdauer ==
Personenbezogene Daten werden nur so lange gespeichert, wie dies für den jeweiligen Zweck erforderlich ist oder gesetzliche Aufbewahrungsfristen bestehen.

== Ihre Rechte ==
Sie haben das Recht auf:

* Auskunft über Ihre gespeicherten Daten
* Berichtigung unrichtiger Daten
* Löschung Ihrer Daten
* Einschränkung der Verarbeitung
* Datenübertragbarkeit
* Widerspruch gegen die Verarbeitung

Zur Ausübung Ihrer Rechte wenden Sie sich bitte an die oben genannte verantwortliche Stelle.

== Sicherheit ==
Wir setzen technische und organisatorische Sicherheitsmaßnahmen ein, um Ihre Daten vor Verlust, Manipulation oder unbefugtem Zugriff zu schützen.

== Änderungen dieser Datenschutzerklärung ==
Wir behalten uns vor, diese Datenschutzerklärung bei Bedarf anzupassen. Es gilt die jeweils aktuelle, im Wiki veröffentlichte Version.