Game Actions Module
The Game Actions module provides a collection of possible actions that players can perform or that occur during the game. It acts as a high-level controller, orchestrating interactions between the player (human or AI), the game state (Game), the core rules (GameLogic), the visual representation (Board, GameRenderer), and other services like sound (Sound_Manager). It translates user input or AI decisions into concrete game state changes.
The Game Actions module is responsible for:
Executing a player’s turn (play_turn), including dice rolling and movement initiation.
Handling the decision process when a player lands on an unowned property (handle_buy_decision).
Initiating property auctions (start_auction).
Managing the options and outcomes for a player in jail (handle_jail_turn).
Processing AI player turns, including purchase and auction decisions (handle_ai_turn).
Handling player bankruptcy (handle_bankruptcy) and voluntary exits (handle_voluntary_exit).
Managing the Free Parking pot (add_to_free_parking, collect_free_parking).
Handling fines (handle_fine_payment).
Delegating checks for game end conditions (check_one_player_remains, check_game_over).
Coordinating with the main game loop for AI turn triggers (check_and_trigger_ai_turn).
Initiating the end-game sequences (end_full_game, end_abridged_game).
Detailed Design
![@startuml
skinparam classAttributeIconSize 0
skinparam class {
BackgroundColor White
BorderColor Black
ArrowColor Black
}
class GameActions {
- game: Game
+ __init__(game: Game)
+ play_turn(): void
+ handle_buy_decision(wants_to_buy: bool): void
+ start_auction(property_data: Property): void
+ handle_jail_turn(player: Player): void
+ handle_voluntary_exit(player_name: str): void
+ calculate_player_assets(player: Player): int
+ handle_ai_turn(ai_player: Player): void
+ handle_bankruptcy(player: Player): void
+ add_to_free_parking(amount: int): void
+ collect_free_parking(player: Player): void
+ handle_fine_payment(player: Player, amount: int, reason: str): void
+ show_time_stats(): void
+ show_exit_confirmation(): bool
+ check_one_player_remains(): bool
+ check_game_over(): bool
+ check_and_trigger_ai_turn(): void
+ end_full_game(): void
+ end_abridged_game(): void
}
class Game {
+ logic: GameLogic
+ players: List<Player>
+ board: Board
+ renderer: GameRenderer
+ state: GameState
+ current_property: Property
+ dice_values: List<int>
+ free_parking_pot: int
+ update_current_player(): void
+ move_player(player: Player, steps: int): void
+ wait_for_animations(): void
+ check_game_over(): bool
}
class GameLogic {
+ players: List<Player>
+ properties: List<Property>
+ current_player_index: int
+ play_turn(): Tuple[int, int]
+ auction_property(position: int): bool
+ remove_player(player_name: str, voluntary: bool): void
}
class Player {
+ name: str
+ is_ai: bool
+ in_jail: bool
+ bankrupt: bool
}
class Board {
+ add_message(message: str): void
+ update_ownership(properties: List<Property>): void
+ update_board_positions(): void
}
class GameRenderer {
+ draw(): void
}
class Sound_Manager {
+ play_sound(sound_name: str): void
}
GameActions o-- "1" Game : contains
GameActions --> "1" GameLogic : uses
GameActions --> "*" Player : manages
GameActions --> "1" Board : updates
GameActions --> "1" GameRenderer : uses
GameActions --> "1" Sound_Manager : uses
@enduml](../_images/plantuml-1fb7c254748cd443bf315cdf37b6a1bddfdda26a.png)
GameActions Class Diagram
Player Turn Flow Activity Diagram
Play Turn Sequence (Human Player, Normal Roll)
Handle Buy Decision Sequence (Player Buys)
Start Auction Sequence