Plattformen - Versionsgeschichte

FeGmbH am 16. Juni 2026 um 18:58 Uhr

2026-06-16T18:58:35Z

← Nächstältere Version		Version vom 16. Juni 2026, 20:58 Uhr
Zeile 71:		Zeile 71:
	:::''Hinweis: Der automatische HUD-Aktualisierungs-Intervall läuft auf 10 Hz (100ms). Das Pausenmenü (erreichbar über die Escape-Taste) friert die HUD-Abfragen temporär ein.''		:::''Hinweis: Der automatische HUD-Aktualisierungs-Intervall läuft auf 10 Hz (100ms). Das Pausenmenü (erreichbar über die Escape-Taste) friert die HUD-Abfragen temporär ein.''

	[[~~index.php?title=~~Kategorie:Spielmechanik]]		[[Kategorie:Spielmechanik]]
	[[~~index.php?title=~~Kategorie:Entwickler-Dokumentation]]		[[Kategorie:Entwickler-Dokumentation]]

FeGmbH: /* Entwickler-Hinweise & API-Anbindung */

2026-06-16T18:58:00Z

Entwickler-Hinweise & API-Anbindung

← Nächstältere Version		Version vom 16. Juni 2026, 20:58 Uhr
Zeile 69:		Zeile 69:
	</syntaxhighlight>		</syntaxhighlight>

	:::''Hinweis: Der automatische HUD-Aktualisierungs-Intervall läuft auf 1 Hz (~~1000ms~~)~~, um eine Überlastung der lokalen REST-Schnittstelle zu verhindern~~. Das Pausenmenü (erreichbar über die Escape-Taste) friert die HUD-Abfragen temporär ein.''		:::''Hinweis: Der automatische HUD-Aktualisierungs-Intervall läuft auf 10 Hz (100ms). Das Pausenmenü (erreichbar über die Escape-Taste) friert die HUD-Abfragen temporär ein.''

	[[Kategorie:Spielmechanik]]		[[index.php?title=Kategorie:Spielmechanik]]
	[[Kategorie:Entwickler-Dokumentation]]		[[index.php?title=Kategorie:Entwickler-Dokumentation]]

FeGmbH am 16. Juni 2026 um 18:52 Uhr

2026-06-16T18:52:55Z

FeGmbH: Die Seite wurde neu angelegt: „Das '''Erstellen von Plattformen''' ist das Kern-Feature im ''Social Media Simulator''. Spieler können hier eigene soziale Netzwerke gründen, konfigurieren, Upgrades erwerben und auf Marktereignisse reagieren. Das System basiert auf einer direkten REST-API-Kopplung zwischen dem PHP-Frontend (Plattform) und dem Spring Boot-Backend. TOC == Spiel-Konfiguration (Registrierung) == Bevor die Simulation startet, muss das Unternehmen initialisiert werden…“

2026-06-16T18:51:12Z

Die Seite wurde neu angelegt: „Das '''Erstellen von Plattformen''' ist das Kern-Feature im ''Social Media Simulator''. Spieler können hier eigene soziale Netzwerke gründen, konfigurieren, Upgrades erwerben und auf Marktereignisse reagieren. Das System basiert auf einer direkten REST-API-Kopplung zwischen dem PHP-Frontend (Plattform) und dem Spring Boot-Backend. __TOC__ == Spiel-Konfiguration (Registrierung) == Bevor die Simulation startet, muss das Unternehmen initialisiert werden…“

Neue Seite

Das '''Erstellen von Plattformen''' ist das Kern-Feature im ''Social Media Simulator''. Spieler können hier eigene soziale Netzwerke gründen, konfigurieren, Upgrades erwerben und auf Marktereignisse reagieren.

Das System basiert auf einer direkten REST-API-Kopplung zwischen dem PHP-Frontend (Plattform) und dem Spring Boot-Backend.

__TOC__

== Spiel-Konfiguration (Registrierung) ==
Bevor die Simulation startet, muss das Unternehmen initialisiert werden. Wenn noch kein aktiver Spielstand geladen ist (<codemw>$start = false</codemw>), wird dem Spieler das Konfigurationsformular angezeigt. Über dieses Formular werden die Startbedingungen festgelegt:

* '''Firmenname:''' Der eindeutige Name des sozialen Netzwerks (Pflichtfeld).
* '''Erweiterte Einstellungen (Cheats & Balances):'''
** ''Unbegrenzt Geld:'' Schaltet den Sandbox-Modus frei.
** ''Start-Geld:'' Bestimmt das Startkapital (Standard: 1.000 €).
** ''Start-Mitarbeiter:'' Die Anzahl der Angestellten zu Beginn (Standard: 1).
** ''Start-Forschungspunkte:'' Verfügbares Wissen für Upgrades (Standard: 0).

Nach dem Absenden des Formulars werden die Daten mittels <codemw>POST</codemw> an die Schnittstelle <codemw>init_game.php?id={UUID}</codemw> übertragen, die das Spiel im Backend registriert.

== Live-Gameplay & HUD ==
Sobald das Spiel läuft (<codemw>$start = true</codemw>), wechselt die Ansicht in die Echtzeit-Simulation. Das Interface passt sich dynamisch an das im <codemw>ThemeManager</codemw> gewählte Design (Dark Mode oder Light Mode) an.

=== Head-Up-Display (HUD) ===
Das HUD zeigt die aktuellen Leistungskennzahlen des Unternehmens. Diese Werte werden im Hintergrund jede Sekunde über einen asynchronen API-Call (<codemw>/api/game?id=...</codemw>) aktualisiert, um dem Spieler eine latenzfreie Übersicht zu bieten:

{| class="wikitable"
|-
! Kennzahl !! Beschreibung !! API-Variable
|-
| '''Geld''' || Das verfügbare Kapital für Erweiterungen und Gehälter. || <codemw>money</codemw>
|-
| '''Forschung''' || Punkte, die für technologische Upgrades benötigt werden. || <codemw>researchPoints</codemw>
|-
| '''Mitarbeiter''' || Die aktuelle Belegschaft, die das Wachstum vorantreibt. || <codemw>employees</codemw>
|}

=== Ereignis-Log ===
Auf der rechten Seite des Interfaces befindet sich der Event-Log-Stream. Hier werden globale Systemereignisse, getätigte Käufe oder Meilensteine gelistet. Jeder Eintrag wird mit einer farblichen Kennzeichnung versehen:
* <span style="color: #34c759; font-weight: bold;">Grün (Gain):</span> Positive Effekte, Startboni oder Einnahmen.
* <span style="color: #ff453a; font-weight: bold;">Rot (Cost):</span> Ausgaben, Verluste oder Kosten für Upgrades.

== Das Upgrade-System (Der Shop) ==
Über die untere Kontrollleiste kann das Modal-Fenster für den '''Shop''' geöffnet werden. Die Liste der verfügbaren Upgrades wird direkt aus dem Backend geladen.

* '''Kauf-Prozess:''' Beim Klick auf „Kaufen“ wird die JavaScript-Funktion <codemw>buyItem(itemName)</codemw> aufgerufen, die einen asynchronen <codemw>POST</codemw>-Request an den Endpunkt <codemw>/api/shop/buy</codemw> sendet.
* '''Validierung:''' Das Backend prüft, ob das Guthaben des Spielers ausreicht. Bei Erfolg wird das Shop-Fenster geschlossen, die HUD-Werte aktualisiert und ein neuer Eintrag im Ereignis-Log generiert.

== Zufallsereignisse (RPG-Dialoge) ==
Während der Simulation können unvorhergesehene Ereignisse eintreffen, die den Spieler vor logische oder finanzielle Entscheidungen stellen (z. B. Mitarbeiterkündigungen).

Das System nutzt hierfür native HTML5-<codemw><dialog></codemw>-Elemente. Sobald ein Event triggert, wird die Funktion <codemw>showEvent(title, text)</codemw> aufgerufen. Der Spieler muss eine der Optionen wählen, woraufhin die Entscheidung via <codemw>handleChoice(choice)</codemw> an den API-Endpunkt <codemw>/api/game/event-choice</codemw> zurückgemeldet wird.

== Entwickler-Hinweise & API-Anbindung ==
Für die korrekte Funktionsweise muss das Backend die Datenstruktur exakt im flachen Format liefern:

<syntaxhighlight lang="json">
{
"id": "GAME-UUID-STRING",
"companyName": "Beispiel GmbH",
"money": 1000,
"researchPoints": 0,
"employees": 1,
"shop": [
{
"name": "Server-Infrastruktur",
"price": 500
}
]
}
</syntaxhighlight>

:::''Hinweis: Der automatische HUD-Aktualisierungs-Intervall läuft auf 1 Hz (1000ms), um eine Überlastung der lokalen REST-Schnittstelle zu verhindern. Das Pausenmenü (erreichbar über die Escape-Taste) friert die HUD-Abfragen temporär ein.''

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

← Nächstältere Version		Version vom 16. Juni 2026, 20:52 Uhr
Zeile 6:		Zeile 6:

	== Spiel-Konfiguration (Registrierung) ==		== Spiel-Konfiguration (Registrierung) ==
	Bevor die Simulation startet, muss das Unternehmen initialisiert werden. Wenn noch kein aktiver Spielstand geladen ist (<~~codemw~~>$start = false</~~codemw~~>), wird dem Spieler das Konfigurationsformular angezeigt. Über dieses Formular werden die Startbedingungen festgelegt:		Bevor die Simulation startet, muss das Unternehmen initialisiert werden. Wenn noch kein aktiver Spielstand geladen ist (<code>$start = false</code>), wird dem Spieler das Konfigurationsformular angezeigt. Über dieses Formular werden die Startbedingungen festgelegt:

	* '''Firmenname:''' Der eindeutige Name des sozialen Netzwerks (Pflichtfeld).		* '''Firmenname:''' Der eindeutige Name des sozialen Netzwerks (Pflichtfeld).
Zeile 15:		Zeile 15:
	** ''Start-Forschungspunkte:'' Verfügbares Wissen für Upgrades (Standard: 0).		** ''Start-Forschungspunkte:'' Verfügbares Wissen für Upgrades (Standard: 0).

	Nach dem Absenden des Formulars werden die Daten mittels <~~codemw~~>POST</~~codemw~~> an die Schnittstelle <~~codemw~~>init_game.php?id={UUID}</~~codemw~~> übertragen, die das Spiel im Backend registriert.		Nach dem Absenden des Formulars werden die Daten mittels <code>POST</code> an die Schnittstelle <code>init_game.php?id={UUID}</code> übertragen, die das Spiel im Backend registriert.

	== Live-Gameplay & HUD ==		== Live-Gameplay & HUD ==
	Sobald das Spiel läuft (<~~codemw~~>$start = true</~~codemw~~>), wechselt die Ansicht in die Echtzeit-Simulation. Das Interface passt sich dynamisch an das im <~~codemw~~>ThemeManager</~~codemw~~> gewählte Design (Dark Mode oder Light Mode) an.		Sobald das Spiel läuft (<code>$start = true</code>), wechselt die Ansicht in die Echtzeit-Simulation. Das Interface passt sich dynamisch an das im <code>ThemeManager</code> gewählte Design (Dark Mode oder Light Mode) an.

	=== Head-Up-Display (HUD) ===		=== Head-Up-Display (HUD) ===
	Das HUD zeigt die aktuellen Leistungskennzahlen des Unternehmens. Diese Werte werden im Hintergrund jede Sekunde über einen asynchronen API-Call (<~~codemw~~>/api/game?id=...</~~codemw~~>) aktualisiert, um dem Spieler eine latenzfreie Übersicht zu bieten:		Das HUD zeigt die aktuellen Leistungskennzahlen des Unternehmens. Diese Werte werden im Hintergrund jede Sekunde über einen asynchronen API-Call (<code>/api/game?id=...</code>) aktualisiert, um dem Spieler eine latenzfreie Übersicht zu bieten:

	{\| class="wikitable"		{\| class="wikitable"
Zeile 27:		Zeile 27:
	! Kennzahl !! Beschreibung !! API-Variable		! Kennzahl !! Beschreibung !! API-Variable
	\|-		\|-
	\| '''Geld''' \|\| Das verfügbare Kapital für Erweiterungen und Gehälter. \|\| <~~codemw~~>money</~~codemw~~>		\| '''Geld''' \|\| Das verfügbare Kapital für Erweiterungen und Gehälter. \|\| <code>money</code>
	\|-		\|-
	\| '''Forschung''' \|\| Punkte, die für technologische Upgrades benötigt werden. \|\| <~~codemw~~>researchPoints</~~codemw~~>		\| '''Forschung''' \|\| Punkte, die für technologische Upgrades benötigt werden. \|\| <code>researchPoints</code>
	\|-		\|-
	\| '''Mitarbeiter''' \|\| Die aktuelle Belegschaft, die das Wachstum vorantreibt. \|\| <~~codemw~~>employees</~~codemw~~>		\| '''Mitarbeiter''' \|\| Die aktuelle Belegschaft, die das Wachstum vorantreibt. \|\| <code>employees</code>
	\|}		\|}

Zeile 42:		Zeile 42:
	Über die untere Kontrollleiste kann das Modal-Fenster für den '''Shop''' geöffnet werden. Die Liste der verfügbaren Upgrades wird direkt aus dem Backend geladen.		Über die untere Kontrollleiste kann das Modal-Fenster für den '''Shop''' geöffnet werden. Die Liste der verfügbaren Upgrades wird direkt aus dem Backend geladen.

	* '''Kauf-Prozess:''' Beim Klick auf „Kaufen“ wird die JavaScript-Funktion <~~codemw~~>buyItem(itemName)</~~codemw~~> aufgerufen, die einen asynchronen <~~codemw~~>POST</~~codemw~~>-Request an den Endpunkt <~~codemw~~>/api/shop/buy</~~codemw~~> sendet.		* '''Kauf-Prozess:''' Beim Klick auf „Kaufen“ wird die JavaScript-Funktion <code>buyItem(itemName)</code> aufgerufen, die einen asynchronen <code>POST</code>-Request an den Endpunkt <code>/api/shop/buy</code> sendet.
	* '''Validierung:''' Das Backend prüft, ob das Guthaben des Spielers ausreicht. Bei Erfolg wird das Shop-Fenster geschlossen, die HUD-Werte aktualisiert und ein neuer Eintrag im Ereignis-Log generiert.		* '''Validierung:''' Das Backend prüft, ob das Guthaben des Spielers ausreicht. Bei Erfolg wird das Shop-Fenster geschlossen, die HUD-Werte aktualisiert und ein neuer Eintrag im Ereignis-Log generiert.

Zeile 48:		Zeile 48:
	Während der Simulation können unvorhergesehene Ereignisse eintreffen, die den Spieler vor logische oder finanzielle Entscheidungen stellen (z. B. Mitarbeiterkündigungen).		Während der Simulation können unvorhergesehene Ereignisse eintreffen, die den Spieler vor logische oder finanzielle Entscheidungen stellen (z. B. Mitarbeiterkündigungen).

	Das System nutzt hierfür native HTML5-<~~codemw~~><dialog></~~codemw~~>-Elemente. Sobald ein Event triggert, wird die Funktion <~~codemw~~>showEvent(title, text)</~~codemw~~> aufgerufen. Der Spieler muss eine der Optionen wählen, woraufhin die Entscheidung via <~~codemw~~>handleChoice(choice)</~~codemw~~> an den API-Endpunkt <~~codemw~~>/api/game/event-choice</~~codemw~~> zurückgemeldet wird.		Das System nutzt hierfür native HTML5-<code><dialog></code>-Elemente. Sobald ein Event triggert, wird die Funktion <code>showEvent(title, text)</code> aufgerufen. Der Spieler muss eine der Optionen wählen, woraufhin die Entscheidung via <code>handleChoice(choice)</code> an den API-Endpunkt <code>/api/game/event-choice</code> zurückgemeldet wird.

	== Entwickler-Hinweise & API-Anbindung ==		== Entwickler-Hinweise & API-Anbindung ==
	Für die korrekte Funktionsweise muss das Backend die Datenstruktur exakt im flachen Format ~~liefern~~:		Für die korrekte Funktionsweise muss das Backend die Datenstruktur exakt im flachen Format hergeben:

	<syntaxhighlight lang="json">		<syntaxhighlight lang="json">