diff --git a/Designphase/Architekturentscheidungen.md b/Designphase/Architekturentscheidungen.md index 6bd090a..054b3ba 100644 --- a/Designphase/Architekturentscheidungen.md +++ b/Designphase/Architekturentscheidungen.md @@ -2,4 +2,5 @@ Hier werden die verschiedenen Versionen der Architekturentscheidungen veröffent * [Architekturentscheidungen_V1.0](../uploads/Designphase/Architekturentscheidungen/Architekturentscheidungen_V1.0) * [Architekturentscheidungen_V1.1](../uploads/Designphase/Architekturentscheidungen/Architekturentscheidungen_V1.1) -* [Architekturentscheidungen_V1.2](../uploads/Designphase/Architekturentscheidungen/Architekturentscheidungen_V1.2) \ No newline at end of file +* [Architekturentscheidungen_V1.2](../uploads/Designphase/Architekturentscheidungen/Architekturentscheidungen_V1.2) +* [Architekturentscheidungen_V1.3](../uploads/Designphase/Architekturentscheidungen/Architekturentscheidungen_V1.3) \ No newline at end of file diff --git a/Designphase/Klassendiagramme.md b/Designphase/Klassendiagramme.md index 985831d..635eea7 100644 --- a/Designphase/Klassendiagramme.md +++ b/Designphase/Klassendiagramme.md @@ -3,4 +3,5 @@ Hier werden Klassendiagramme veröffentlicht * [ClassChart_V1.0](../uploads/Designphase/Klassendiagramme/ClassChart_V1.0.svg) * [ClassChart_V1.1](../uploads/Designphase/Klassendiagramme/ClassChart_V1.1.svg) * [ClassChart_V1.2](../uploads/Designphase/Klassendiagramme/ClassChart_V1.2.svg) -* [ClassChart_V1.3](../uploads/Designphase/Klassendiagramme/ClassChart_V1.3.svg) \ No newline at end of file +* [ClassChart_V1.3](../uploads/Designphase/Klassendiagramme/ClassChart_V1.3.svg) +* [ClassChart_V1.4](../uploads/Designphase/Klassendiagramme/ClassChart_V1.4.svg) \ No newline at end of file diff --git a/Designphase/Sequenzdiagramme.md b/Designphase/Sequenzdiagramme.md index b1e7358..04c51d2 100644 --- a/Designphase/Sequenzdiagramme.md +++ b/Designphase/Sequenzdiagramme.md @@ -2,6 +2,7 @@ Hier werden die Sequenzdiagramme veröffenticht * [Würfeln_V1.0](../uploads/Designphase/Sequenzdiagramme/Wuerfeln_V1.0.pdf) * [Würfeln_V1.1](../uploads/Designphase/Sequenzdiagramme/Wuerfeln_V1.1.svg) +* [Würfeln_V1.2](../uploads/Designphase/Sequenzdiagramme/Würfeln_V1.2.svg) --- diff --git a/Designphase/Testhandbuch.md b/Designphase/Testhandbuch.md index 060fd21..bf683c8 100644 --- a/Designphase/Testhandbuch.md +++ b/Designphase/Testhandbuch.md @@ -2,4 +2,5 @@ Folgende Versionen an Testhandbüchern sind bisher in der Designphase entstanden * [Testhandbuch_V2.0](../uploads/Designphase/Testhandbuch/Testhandbuch_V2.0.xlsx) * [Testhandbuch_V2.1](../uploads/Designphase/Testhandbuch/Testhandbuch_V2.1.xlsx) -* [Testhandbuch_V2.2](../uploads/Designphase/Testhandbuch/Testhandbuch_V2.2.xlsx) \ No newline at end of file +* [Testhandbuch_V2.2](../uploads/Designphase/Testhandbuch/Testhandbuch_V2.2.xlsx) +* [Testhandbuch_V2.3](../uploads/Designphase/Testhandbuch/Testhandbuch_V2.3.xlsx) \ No newline at end of file diff --git a/Designphase/Zustandsdiagramme.md b/Designphase/Zustandsdiagramme.md index e69de29..3c3a27f 100644 --- a/Designphase/Zustandsdiagramme.md +++ b/Designphase/Zustandsdiagramme.md @@ -0,0 +1,17 @@ +Hier werden die Zustandsdiagramme reingestellt + +
+GameState + +* [GameState_V1.2](../uploads/Designphase/Zustandsdiagramme/GameStateChart_V1.2.svg) + +
+ +--- + +
+PlayerState + +* [PlayerState_V1.2](../uploads/Designphase/Zustandsdiagramme/PlayerStateChart_V1.3.svg) + +
\ No newline at end of file diff --git a/uploads/Designphase/Architekturentscheidungen/Architekturentscheidungen_V1.3.md b/uploads/Designphase/Architekturentscheidungen/Architekturentscheidungen_V1.3.md new file mode 100644 index 0000000..0e49e5b --- /dev/null +++ b/uploads/Designphase/Architekturentscheidungen/Architekturentscheidungen_V1.3.md @@ -0,0 +1,70 @@ +# Architekturentscheidungen + +## Aufteilung Client Server + +### Server-seitige Aktionen und Berechnungen + +1. **Spielstart und Serververbindung**: + - Der Server wird beim Start des Spiels durch einen Spieler initialisiert, was anderen Spielern den Beitritt ermöglicht (UC-game-01). + - Spieler können sich über die Eingabe von Hostnamen und Portnummer zum Server verbinden (UC-game-07). +2. **Spielmechanik**: + - Zentrale Berechnungen wie die Würfelwürfe (UC-gameplay-02), Mietenberechnungen bei Grundstücksbesitz (UC-gameplay-08), und Strafzahlungen (UC-gameplay-20) werden serverseitig ausgeführt und anschließend an die Clients gesendet. + - Spielaktionen wie der Übergang ins Gefängnis (Gulag) oder der Kauf eines Grundstücks werden ebenfalls auf dem Server ausgeführt, da diese den Status der Spielwelt beeinflussen (UC-gameplay-09, UC-gameplay-07). +3. **Spielzüge und Spielerwechsel**: + - Die Verwaltung der Spielerreihenfolge und das automatische Beenden des Zugs bei Inaktivität erfolgen serverseitig (UC-gameplay-17, UC-gameplay-19). +4. **Handelsberechnungen**: + - Alle Berechnungen und Validierungen für Handelsangebote, z.B., Verifizierung der Verfügbarkeit von Grundstücken und Geldern beim Handel, werden serverseitig durchgeführt (UC-trade-07, UC-trade-08). +5. **Zustandsverwaltung der Spielwelt**: + - Änderungen in den Besitzverhältnissen, wie das Markieren von Grundstücken bei Kauf oder Verpfändung, werden zentral durch den Server verarbeitet und an alle Clients synchronisiert (UC-gameplay-10, UC-gameplay-14). + +### Client-seitige Aktionen und Darstellungen + +1. **UI-Interaktionen und Auswahlmöglichkeiten**: + - Der Client ermöglicht den Spielern, Menüs zu öffnen (z.B., Startmenü, Handelsmenü, Einstellungen) und eigene Aktionen wie den Würfelwurf oder die Auswahl von Handelsoptionen zu initiieren. Diese Aktionen lösen serverseitige Berechnungen aus, bleiben jedoch in der Steuerung und Interaktion clientseitig (UC-game-02, UC-trade-05, UC-menu-01). +2. **Anzeige und Soundeffekte**: + - Die Anzeige von Würfelergebnissen, Karteninformationen und Pop-Ups bei Ereignissen (z.B., Zahlung von Miete oder Startgeld) werden klientenseitig dargestellt. Soundeffekte werden durch clientseitige Trigger abgespielt (UC-sound-01, UC-gameplay-29). +3. **Echtzeit-Anzeigen**: + - Visualisierungen wie der Timeout-Counter und Anzeigen über das Vermögen der Mitspieler werden durch die Clients verwaltet und aktualisiert (UC-gameplay-36, UC-menu-12). +4. **Benachrichtigungen und Popup-Verwaltung**: + - Der Client verwaltet das Ausspielen und Schließen von Pop-ups und Warnhinweisen für den Nutzer, z. B., Timeout-Warnungen und Handelsofferten, die durch serverseitige Signale ausgelöst werden (UC-gameplay-40). + +## Messages + +### 1\. Verbindungsmanagement + +- **Client → Server**: `ConnectRequest` – Spieler sendet eine Anfrage, dem Server beizutreten (mit Hostname und Port). +- **Server → Client**: `ConnectionResponse` – Antwortet, ob die Verbindung erfolgreich hergestellt wurde. +- **Client → Server**: `DisconnectRequest` – Spieler möchte das Spiel verlassen. +- **Server → Client**: `PlayerDisconnected` – An alle Clients gesendete Nachricht, dass ein Spieler das Spiel verlassen hat. +- **Server → Client**: `GameEnd` – Signalisiert allen Spielern, dass der Host das Spiel beendet hat. +- **Client → Server**: `PlayerReady` - Setzt den Status eines Spielers in der Lobby auf Bereit oder nicht Bereit + +### 2\. Spielaktionen und -zustand + +- **Client → Server**: `RollDice` – Spieler fordert einen Würfelwurf an. +- **Server → Client**: `DiceResult` – Sendet das Ergebnis des Würfelwurfs an den Spieler. +- **Server → Client**: `MoveResult` – Bestätigt die Spielfigurbewegung und informiert über das Zielfeld mittels ID (z.B. „Grundstück“, „Steuerfeld“, „Gulag“). +- **Client → Server**: `BuyPropertyRequest` – Spieler möchte ein Grundstück kaufen. +- **Server → Client**: `BuyPropertyResponse` – Antwortet, ob der Kauf erfolgreich war. +- **Server → Client**: `PayRent` – Spieler muss Miete zahlen, wenn er auf einem fremden Grundstück landet. Nachricht enthält den Betrag und den Zahlungsempfänger. +- **Server → Client**: `UpdatePlayerAssets` – Informiert über aktualisierte Besitztümer oder Geldbeträge nach Aktionen (z.B., Kauf eines Grundstücks, Zahlung von Miete). +- **Client → Server**: `EndTurn` – Spieler signalisiert das Ende seines Zugs. +- **Server → Client**: `NextPlayerTurn` – Teilt allen Spielern mit, welcher Spieler an der Reihe ist. +- **Server → Client**: `JailEvent` – Informiert den Spieler über den Eintritt ins oder Austritt aus dem Gulag. + +### 3\. Benachrichtigungen und Statusupdates + +- **Server → Client**: `GameStart` – Teilt mit, dass das Spiel beginnt und alle Spieler bereit sind. +- **Server → Client**: `GameOver` – Informiert über das Spielende, entweder durch Bankrott eines Spielers oder weil ein Spieler gewonnen hat. +- **Server → Client**: `PlayerStatusUpdate` – Sendet allen Spielern Statusänderungen von Mitspielern (z.B. Bankrott, neue Besitztümer). +- **Server → Client**: `TimeoutWarning` – Warnung an einen inaktiven Spieler, dass sein Zug bald automatisch beendet wird. +- **Server → Client**: `EventCardDraw` – Eine Ereigniskarte wird gezogen, die Nachricht enthält die Karte und den Effekt. +- **Server → Client**: `SoundTrigger` – Signalisiert den Clients, bestimmte Soundeffekte auszulösen (z.B. „Würfeln“, „Grundstück kaufen“). + +### 4\. Interaktionen und Handelsmanagement + +- **Client → Server**: `TradeOffer` – Spieler sendet ein Handelsangebot an einen Mitspieler (enthält Details zu Geld, Grundstücken, etc.). +- **Server → Client**: `TradeRequest` – Übermittelt das Handelsangebot an den ausgewählten Handelspartner. +- **Client → Server**: `TradeResponse` – Antwortet auf ein Handelsangebot mit „Annehmen“ oder „Ablehnen“ oder „Gegenangebot“. +- **Client → Server**: `ViewAssetsRequest` – Spieler fordert an, die Besitztümer eines Mitspielers anzuzeigen. +- **Server → Client**: `ViewAssetsResponse` – Antwortet mit einer Übersicht der angeforderten Besitztümer eines Mitspielers. \ No newline at end of file diff --git a/uploads/Designphase/Klassendiagramme/ClassChart_V1.4.svg b/uploads/Designphase/Klassendiagramme/ClassChart_V1.4.svg new file mode 100644 index 0000000..3416461 --- /dev/null +++ b/uploads/Designphase/Klassendiagramme/ClassChart_V1.4.svg @@ -0,0 +1,4 @@ + + + +
Game
 -gameBoard: GameBoard 
 -bank: Bank 
 -timer: Timer 
 -deck: EventCard 
 -musicEnabled: boolean 
 -soundEffectEnabled: boolean 
 -eventCards: List<EventCard> 
 -communityCards: List<CommunityCard> 
 -gameState: GameState
+ initializeGame(): void
+ startTurn(player: Player): void
+ endTurn(player: Player): void
+ checkWinCondition(): boolean
+ applyEventCard(card: EventCard): void
+  rollDice(): DiceResult
- state
Player
-name: String
-color: ColorRGBA
-accountBalance: int
-gamePiece: GamePiece
-properties: List<Property>
-getOutOfJailCard: int
-fieldId: int

+move(steps: int): void
+buyProperty(property: Property): void
+payRent(amount: int): void
+declareBankruptcy(): void
<<abstract>>
GameState
InGame
GameOver
Lobby
-player
<<abstract>>
PlayerState
Active
Brankrup%3CmxGraphModel%3E%3Croot%3E%3CmxCell%20id%3D%220%22%2F%3E%3CmxCell%20id%3D%221%22%20parent%3D%220%22%2F%3E%3CmxCell%20id%3D%222%22%20value%3D%22NomalState%22%20style%3D%22swimlane%3BfontStyle%3D0%3BchildLayout%3DstackLayout%3Bhorizontal%3D1%3BstartSize%3D26%3BfillColor%3Dnone%3BhorizontalStack%3D0%3BresizeParent%3D1%3BresizeParentMax%3D0%3BresizeLast%3D0%3Bcollapsible%3D1%3BmarginBottom%3D0%3BwhiteSpace%3Dwrap%3Bhtml%3D1%3B%22%20vertex%3D%221%22%20parent%3D%221%22%3E%3CmxGeometry%20x%3D%22-240%22%20y%3D%22380%22%20width%3D%22140%22%20height%3D%2240%22%20as%3D%22geometry%22%2F%3E%3C%2FmxCell%3E%3C%2Froot%3E%3C%2FmxGraphModel%3
Lobby
InJail
-roundsInJail: Int
WaitForTurn
-game
StartScreen
CreateGame
Settings
GameClosed
Dice
+rollDice(): int
GulagField
-bailCost: int
+payBail(player: Player): void
+checkIfInJail(player: Player): boolean
MenuView
- properties
<<abstract>>
PropertyField
-price: int
-rent: int
-owner: Player
-mortgaged: boolean
TestStreckeField
+collectMoney(player: Player): void
EventField
-bailCost: int
+payBail(player: Player): void
+checkIfInJail(player: Player): boolean
Wache
+sendToJail(player: Player): void
FoodField
-diceCount: int
+applyDiceRollEffect(diceValue: int): void
GateField
-rentLevel: int

+calculateRent(): int
BuildingProperty
-houses: int
-hotel: boolean
+buildHouse(): void
+buildHotel(): void
TradeHandler
-offeredProperties: List<Property>
-offerMoney: int
-offerCards: List<Card>
+initiateTrade(trader: Player, tradee: Player): void
+offerProperty(property: Property): void
+offerMoney(amount: int): void
+finalizeTrade(): boolean
app
fields
MainMenu
+showMenu(): void
+hideMenu(): void
NewGameMenu
+createNewGame(): void
+camcel(): void
SettingMenu
+loadSettings(): void
+saveSettings(): void
+adjustVolume(level: int): void
Trading
+initiateTrade(): void
+confirmTrade(): void
+cancelTrade(): void
PropertyAdmin
+manageProperty(): void
+upgradeProperty(): void
+mortgageProperty(): void
- appState
- control
MonopolyApp
MainSynchronizer
<<abstract>>
ModelViewSynchronizer
MenuState
Camera
<<abstract>>
AppState
network
Client
-host: String
-port: int
+connect(): void
+disconnect(): void
Server
-playerConnections: List<PlayerCo
-gameState: GameState
-port: int
+startServer(): void
+stopServer(): void
+broadcastMessage(msg: String): void
-server
monopoly

<<abstract>>
Property

- name: String
- id: int

+ onPlayerLanding(player: Player): void

PlayerHandler
- playerHandler
- players
2**6
PropertyManager
SimpleApplication
jme
GameControl
+startGame(): void
+endGame(): void
NetworkClient
Server
messages
model
<<abstract>>
ClientMessage
+ accept(ServerInterpreter, int): void
<<abstract>>
ServerMessage
+ accept(ClientInterpreter, int): void
ConnectRequest
DisconnectRequest
PlayerReady
RollDice
BuyPropertyRequest
EndTurn
TradeOffer
TradeOffer
TradeResponse
ViewAssetsRequest
ConnectionResponse
PlayerDisconnected
GameEnd
DiceResult
MoveResult
BuyPropertyResponse
PayRent
UpdatePlayerAssets
NextPlayerTurn
JailEvent
GameEnd
GameStart
GameOver
PlayerStatusUpdate
TimeOutWarning
EventDrawCard
TradeRequest
ViewAssetsResponse
SoundTrigger
ClientInterpreter
ClientInterpreter
 \ No newline at end of file diff --git a/uploads/Designphase/Sequenzdiagramme/Würfeln_V1.2.svg b/uploads/Designphase/Sequenzdiagramme/Würfeln_V1.2.svg new file mode 100644 index 0000000..2b5b2d5 --- /dev/null +++ b/uploads/Designphase/Sequenzdiagramme/Würfeln_V1.2.svg @@ -0,0 +1,4 @@ + + + +
würfeln : Button
würfeln : Button
1): "Spieler klickt"
1): "Spieler klickt"
game : Game
game : Game
2): toDice()
2): toDice()
8:
8:
dice1 : Dice
dice1 : Dice
3: getEyes()
3: getEyes()
4: rollDice()
4: rollDice()
7: rollDice()
7: rollDice()
9:
9:
10:
10:
dice2 : Dice
dice2 : Dice
6:getEyes()
6:getEyes()
5:
5:
actor: Player
actor: Play...Text is not SVG - cannot display \ No newline at end of file diff --git a/uploads/Designphase/Testhandbuch/Testhandbuch_V2.3.xlsx b/uploads/Designphase/Testhandbuch/Testhandbuch_V2.3.xlsx new file mode 100644 index 0000000..51adc86 Binary files /dev/null and b/uploads/Designphase/Testhandbuch/Testhandbuch_V2.3.xlsx differ diff --git a/uploads/Designphase/Zustandsdiagramme/GameStateChart_V1.2.svg b/uploads/Designphase/Zustandsdiagramme/GameStateChart_V1.2.svg new file mode 100644 index 0000000..85625b8 --- /dev/null +++ b/uploads/Designphase/Zustandsdiagramme/GameStateChart_V1.2.svg @@ -0,0 +1,4 @@ + + + +
InGame
StartScreen
CreateGame
InLobby
close Game
GameOver
click "Spielen"
recieved(ConnectionResponse) sucessfull
recieved(GameStart)
recieved(GameOver)
GameState
 \ No newline at end of file diff --git a/uploads/Designphase/Zustandsdiagramme/PlayerStateChart_V1.3.svg b/uploads/Designphase/Zustandsdiagramme/PlayerStateChart_V1.3.svg new file mode 100644 index 0000000..a575490 --- /dev/null +++ b/uploads/Designphase/Zustandsdiagramme/PlayerStateChart_V1.3.svg @@ -0,0 +1,4 @@ + + + +
Active
recieved(JailEvent) == true
InJail
WaitForTurn
Bankrup%3CmxGraphModel%3E%3Croot%3E%3CmxCell%20id%3D%220%22%2F%3E%3CmxCell%20id%3D%221%22%20parent%3D%220%22%2F%3E%3CmxCell%20id%3D%222%22%20value%3D%22%26lt%3Bfont%20style%3D%26quot%3Bfont-size%3A%2022px%3B%26quot%3B%26gt%3BActive%26lt%3B%2Ffont%26gt%3B%22%20style%3D%22rounded%3D1%3BwhiteSpace%3Dwrap%3Bhtml%3D1%3B%22%20vertex%3D%221%22%20parent%3D%221%22%3E%3CmxGeometry%20x%3D%22360%22%20y%3D%22845%22%20width%3D%22210%22%20height%3D%2270%22%20as%3D%22geometry%22%2F%3E%3C%2FmxCell%3E%3C%2Froot%3E%3C%2FmxGraphModel%3Et
Lobby
recieved(GameStart)
send(TurnEnd)
recived(PlayerNextTurn).id == ownID
send(PlayerStatusUpdate).keyword = bankrupt
PlayerState
recieved(JailEvent) == false
rollDice
send(PlayerReady)
 \ No newline at end of file