games.monopoly.utils¶

Monopoly game utilities and board logic.

This module provides utility functions for the monopoly game, including:

  • Board setup and property definitions

  • Game logic calculations

  • Card definitions and handling

  • Rent calculations

Functions¶

calculate_rent(property, state[, dice_roll])

Calculate rent for a property.

can_trade_properties(prop1, prop2, state)

Check if two properties can be traded.

check_game_end(state)

Check if the game should end.

create_board()

Create the initial board with all properties.

create_players(player_names)

Create initial players.

get_building_cost(property, buildings[, is_hotel])

Calculate cost to build houses or hotel.

get_properties_by_color(color)

Get all property names for a color group.

get_property_at_position(position)

Get property information at a board position.

handle_special_position(position, player, state)

Handle special board positions like GO, Jail, etc.

move_player(player, dice_roll)

Move a player based on dice roll.

roll_dice()

Roll two dice.

shuffle_cards()

Shuffle and return chance and community chest cards.

Module Contents¶

games.monopoly.utils.calculate_rent(property, state, dice_roll=None)¶

Calculate rent for a property.

Parameters:

  • property (haive.games.monopoly.models.Property)

  • state (haive.games.monopoly.state.MonopolyState)

  • dice_roll (int | None)

Return type:

int

games.monopoly.utils.can_trade_properties(prop1, prop2, state)¶

Check if two properties can be traded.

Parameters:

  • prop1 (haive.games.monopoly.models.Property)

  • prop2 (haive.games.monopoly.models.Property)

  • state (haive.games.monopoly.state.MonopolyState)

Return type:

bool

games.monopoly.utils.check_game_end(state)¶

Check if the game should end.

Parameters:

state (haive.games.monopoly.state.MonopolyState)

Return type:

tuple[bool, str | None]

games.monopoly.utils.create_board()¶

Create the initial board with all properties.

Return type:

dict[str, haive.games.monopoly.models.Property]

games.monopoly.utils.create_players(player_names)¶

Create initial players.

Parameters:

player_names (list[str])

Return type:

list[haive.games.monopoly.models.Player]

games.monopoly.utils.get_building_cost(property, buildings, is_hotel=False)¶

Calculate cost to build houses or hotel.

Parameters:

  • property (haive.games.monopoly.models.Property)

  • buildings (int)

  • is_hotel (bool)

Return type:

int

games.monopoly.utils.get_properties_by_color(color)¶

Get all property names for a color group.

Parameters:

color (haive.games.monopoly.models.PropertyColor)

Return type:

list[str]

games.monopoly.utils.get_property_at_position(position)¶

Get property information at a board position.

Parameters:

position (int)

Return type:

dict[str, Any] | None

games.monopoly.utils.handle_special_position(position, player, state)¶

Handle special board positions like GO, Jail, etc.

Parameters:

  • position (int)

  • player (haive.games.monopoly.models.Player)

  • state (haive.games.monopoly.state.MonopolyState)

Return type:

str

games.monopoly.utils.move_player(player, dice_roll)¶

Move a player based on dice roll.

Parameters:

  • player (haive.games.monopoly.models.Player)

  • dice_roll (haive.games.monopoly.models.DiceRoll)

Return type:

tuple[int, bool]

games.monopoly.utils.roll_dice()¶

Roll two dice.

Return type:

haive.games.monopoly.models.DiceRoll

games.monopoly.utils.shuffle_cards()¶

Shuffle and return chance and community chest cards.

Return type:

tuple[list[str], list[str]]