FeGmbH: /* API-Referenz für Mechaniken */

2026-06-16T19:04:32Z

API-Referenz für Mechaniken

← Nächstältere Version		Version vom 16. Juni 2026, 21:04 Uhr
Zeile 48:		Zeile 48:
	\| <code>/api/shop/buy</code> \|\| POST \|\| Führt einen Kauf aus. \|\| Validiert Guthaben, zieht Kosten ab und aktiviert Upgrade-Effekte.		\| <code>/api/shop/buy</code> \|\| POST \|\| Führt einen Kauf aus. \|\| Validiert Guthaben, zieht Kosten ab und aktiviert Upgrade-Effekte.
	\|-		\|-
	\| <code>/api/game/event-choice</code> \|\| POST \|\| Verarbeitet RPG-Entscheidungen. \|\| Wendet die positiven/negativen Konsequenzen des Events an.		\| <code>/api/game/event-choice</code> (Coming Soon) \|\| POST \|\| Verarbeitet RPG-Entscheidungen. \|\| Wendet die positiven/negativen Konsequenzen des Events an.
	\|}		\|}

	[[Kategorie:Spielmechanik]]		[[Kategorie:Spielmechanik]]
	[[Kategorie:Entwickler-Dokumentation]]		[[Kategorie:Entwickler-Dokumentation]]

FeGmbH: Die Seite wurde neu angelegt: „Das System hinter den '''Spielmechaniken''' im ''Social Media Simulator'' steuert die gesamte Spiellogik, die Berechnungen der Kennzahlen und die Abwicklung von Events. Die Mechaniken sind serverseitig in Spring Boot implementiert und laufen komplett unabhängig vom darstellenden PHP-Frontend. TOC == Core-Loop & Zeitsteuerung == Die Spielmechanik basiert auf einem zustandslosen, pull-basierten Modell. Es gibt keinen permanenten Hintergrund-Thread, d…“

2026-06-16T19:02:28Z

Die Seite wurde neu angelegt: „Das System hinter den '''Spielmechaniken''' im ''Social Media Simulator'' steuert die gesamte Spiellogik, die Berechnungen der Kennzahlen und die Abwicklung von Events. Die Mechaniken sind serverseitig in Spring Boot implementiert und laufen komplett unabhängig vom darstellenden PHP-Frontend. __TOC__ == Core-Loop & Zeitsteuerung == Die Spielmechanik basiert auf einem zustandslosen, pull-basierten Modell. Es gibt keinen permanenten Hintergrund-Thread, d…“

Neue Seite

Das System hinter den '''Spielmechaniken''' im ''Social Media Simulator'' steuert die gesamte Spiellogik, die Berechnungen der Kennzahlen und die Abwicklung von Events. Die Mechaniken sind serverseitig in Spring Boot implementiert und laufen komplett unabhängig vom darstellenden PHP-Frontend.

__TOC__

== Core-Loop & Zeitsteuerung ==
Die Spielmechanik basiert auf einem zustandslosen, pull-basierten Modell. Es gibt keinen permanenten Hintergrund-Thread, der die Server-Ressourcen blockiert, sondern die Updates werden über die Client-Anfragen getriggert.

* '''Das 10-Hz-Intervall:''' Da das Frontend die Daten über <code>updateHUD()</code> 10 Mal in der Sek (100ms) neu abfragt, nutzt das Backend diese Requests, um die zeitabhängigen Variablen (z. B. passives Einkommen durch Werbeeinnahmen oder Mitarbeiter-Kosten) zu berechnen und zu inkrementieren.
* '''Echtzeit-Berechnung:''' Bei jedem Aufruf der REST-Schnittstelle wird die Zeitdifferenz zum letzten Request ermittelt und die Werte wie Guthaben (<code>money</code>) oder Forschungspunkte (<code>researchPoints</code>) entsprechend hochgerechnet.

== Kern-Komponenten der Mechanik ==

=== 1. Wirtschaftssystem (Finanzen) ===
Das Wirtschaftssystem berechnet den Cashflow des Spielers.
* '''Einnahmen:''' Generieren sich passiv basierend auf der Reichweite der Plattform und aktiv durch Interaktionen.
* '''Ausgaben:''' Die laufenden Kosten berechnen sich direkt aus der Anzahl der eingestellten Mitarbeiter (<code>employees</code>).
* '''Sandbox-Modus:''' Ist in der Konfiguration die Flag <code>infinite_money</code> aktiv, werden finanzielle Abzüge bei Einkäufen im Shop ausgesetzt.

=== 2. Upgrade-Logik (Shop-Schnittstelle) ===
Der Shop schaltet neue spielerische Möglichkeiten frei und skaliert die Produktionswerte. Ein Kauf läuft nach folgendem mechanischen Muster ab:
# Der Client sendet den Item-Namen per <code>POST</code> an <code>/api/shop/buy</code>.
# Das Backend schaut in der registrierten Upgrade-Liste nach dem Basispreis.
# Es wird geprüft, ob <code>money >= price</code> erfüllt ist.
# Bei Erfolg wird der Preis abgezogen und der jeweilige Effekt (z. B. Erhöhung der Forschungsrate oder Freischaltung neuer Event-Typen) auf das Spielobjekt angewendet.

=== 3. Ereignis-Trigger (RPG-Events) ===
Zufallsereignisse brechen das lineare Wachstum auf und fordern strategische Entscheidungen.
* '''Trigger-Chance:''' Bei den regelmäßigen API-Abfragen besteht eine prozentuale Wahrscheinlichkeit, dass ein unvorhergesehenes Ereignis generiert wird.
* '''Zustands-Sperre:''' Sobald ein Event aktiv ist, wird im JSON ein Event-Objekt mitgeliefert. Das Frontend pausiert optisch und erzwingt das HTML5-Dialogfeld.
* '''Konsequenzen-Verarbeitung:''' Die Antwort des Spielers wird an <code>/api/game/event-choice?choice=...</code> gesendet. Das Backend wertet den String aus und modifiziert die Server-Variablen (z. B. Abbuchen von 50 Euro bei Gehaltserhöhungen oder Verringern des Mitarbeiter-Zählers bei einer Kündigung).

== Erweiterbarkeit (Extensions) ==
Die Spielmechaniken sind so aufgebaut, dass sie über ein Modul-System erweitert werden können. Wie im Frontend-Template ersichtlich, können Themes oder Mechanik-Erweiterungen (z. B. <code>cyberpunk</code> oder <code>matrix_theme</code>) registriert werden.

* '''Style- & Skript-Hooks:''' Über die <code>ext.php</code> der jeweiligen Extension werden zusätzliche Stylesheets und JavaScript-Dateien injiziert, die das Verhalten der Aktionen-Box manipulieren können.
* '''HTML-Footer-Hooks:''' Ermöglichen es, eigene, unsichtbare Dialoge oder zusätzliche Event-Listener in den DOM einzubetten, um neue Gameplay-Elemente zu registrieren, ohne den Core-Code der Plattform zu verändern.

== API-Referenz für Mechaniken ==

{| class="wikitable"
|-
! Endpunkt !! Methode !! Beschreibung !! Auswirkung auf Spielmechanik
|-
| <code>/api/init</code> || GET || Initialisiert eine neue Session. || Generiert eine neue, eindeutige Game-UUID.
|-
| <code>/api/game</code> || GET || Ruft den aktuellen Zustand ab. || Berechnet den zeitlichen Fortschritt seit dem letzten Aufruf.
|-
| <code>/api/shop/buy</code> || POST || Führt einen Kauf aus. || Validiert Guthaben, zieht Kosten ab und aktiviert Upgrade-Effekte.
|-
| <code>/api/game/event-choice</code> || POST || Verarbeitet RPG-Entscheidungen. || Wendet die positiven/negativen Konsequenzen des Events an.
|}

[[Kategorie:Spielmechanik]]
[[Kategorie:Entwickler-Dokumentation]]

Spielmechaniken - Versionsgeschichte

FeGmbH: /* API-Referenz für Mechaniken */