Ii?;SrSSKJrJr SSKJrJr SSKJrJ r SSK r SSK J r SSK Jr SSKJr SS KJr S S KJr S S KJrJr S S KJrJr S SKJr S SKJr S SK J!r! S SK"J#r# S SK$J%r% S SK&J'r' S SK(J)r) S SK*J+r+ S SK,J-r- S SK.J/r/ S SK0J1r1J2r2 S SK3J4r4 S SK5J6r6 S SK7J8r8 S SK9J:r: SSK;J\r\"S"S#\\ \\!\#\%\'\)\+\-\/\1\4\6\8\\:55r?g)$z%Base game class and player dataclass.) dataclassfield)AnyClassVar)ABCabstractmethodN)DataClassJSONMixin) BaseConfig)User)Bot) ActionSet) GameOptionsOptionsHandlerMixin) GameResult PlayerResult) TeamManager)GameSoundMixin)GameCommunicationMixin)GameResultMixin)DurationEstimateMixin)GameScoresMixin)GamePredictionMixin)TurnManagementMixin)MenuManagementMixin)ActionVisibilityMixin)LobbyActionsMixin BOT_NAMES)EventHandlingMixin)ActionSetCreationMixin)ActionExecutionMixin)ActionSetSystemMixin)KeybindcP\rSrSr%SrSr\S-\S'Sr\ S-\S'Sr \ \S'Sr g) ActionContext%aContext passed to action handlers when triggered by keybind. Attributes: menu_item_id: ID of the selected menu item when the keybind fired. menu_index: 1-based index of the selected menu item. from_keybind: True if triggered via keybind, False if via menu. N menu_item_id menu_indexF from_keybind) __name__ __module__ __qualname____firstlineno____doc__r'str__annotations__r(intr)bool__static_attributes__r*0c:\Users\dbart\PlayPalace11\server\games\base.pyr%r%%s/ $L#*#!Jd !L$r5r%c\rSrSr%Sr\\S'\\S'Sr\\S'Sr \\S'Sr \\S'S r \ \S 'S r \S -\S 'S r\ S -\S 'Sr\\S'Srg )Player4aA player in a game (serialized with game state). The associated User object is not serialized and is reattached after load. Attributes: id: Unique identifier (user UUID for humans, generated for bots). name: Display name. is_bot: True for bot players. is_virtual_bot: True for server-level virtual bots (count in stats). is_spectator: True if spectating. bot_think_ticks: Ticks until bot can act. bot_pending_action: Action to execute when ready. bot_target: Game-specific target (e.g., score to reach). idnameFis_botis_virtual_bot is_spectatorrbot_think_ticksNbot_pending_action bot_targetreplaced_humanr*)r+r,r-r.r/r0r1r<r3r=r>r?r2r@rArBr4r*r5r6r8r84sb  G IFD ND L$OS%)d )!Jd ! ND r5r8c \rSrSr%Sr"SS\5r\"\S9r \\ \ S'Sr \ \ S'S r\\ S 'S r\\ S 'S r\\ S'S r\\ S'S r\\ S'Sr\ \ S'Sr\ \ S'Sr\ \ S'\"\S9r\\\ S'Sr\\ S'Sr\ \ S'\"\S9r\\ S'Sr\ \ S'\"\S9r\\\ \\4\ S'S r \\ S'\"\S9r!\\\\"4\ S'\"\#S9r$\#\ S'Sr%SBS"jr&\'\(S \4S#j55r)\'\(S \4S$j55r*/r+\,\\\ S%'\'S \4S&j5r-\'S \4S'j5r.\'S \ 4S(j5r/\'S \ 4S)j5r0\'S \\4S*j5r1S \\\\\\4-4S+jr2S,\S \S!-4S-jr3SBS.jr4SCS0jr5\(SBS1j5r6SBS2jr7SBS3jr8S4\S5\9S S!4S6jr:S/\ S \9S!-4S7jr;S4\S \ S!-4S8jrSDS/\ S!-S<\S=\S S!4S>jjr?S4\S \\\\44S?jr@\AS \#4S@j5rBSArCg!)EGameUaAbstract base class for all games. Games are dataclasses serialized with Mashumaro. All authoritative state must live in dataclass fields; runtime-only objects are rebuilt after load. Responsibilities: - Maintain authoritative game state. - Expose actions and keybinds for players. - Advance turns and manage lifecycle (waiting/playing/finished). - Provide menu content for the client. Phases: - waiting: Lobby phase; host can add bots and start. - playing: Game in progress. - finished: Game over. Notes: - Use broadcast_l / broadcast_personal_l for table transcript messages. - Use user.speak_l for command responses or private status checks. c\rSrSrSrSrg) Game.Config~Tr*N)r+r,r-r.serialize_by_aliasr4r*r5r6ConfigrG~s!r5rJ)default_factoryplayersrroundF game_activewaitingstatushost current_musiccurrent_ambience turn_indexturn_directionturn_skip_countturn_player_idsidleround_timer_stateround_timer_ticksscheduled_soundssound_scheduler_tick event_queue is_animatingplayer_action_sets _team_managerc0UlSUl0Ul0Ul0Ul[ 5Ul[ 5UlSUl/Ul /Ul /Ul SUl [R"5Ul0Ul0Ulg)z Initialize non-serialized state.NF)_users_table _keybinds_pending_actions_action_contextset_status_box_open_actions_menu_open _destroyed_estimate_threads_estimate_results_estimate_errors_estimate_running threadingLock_estimate_lock _transcripts _options_pathselfs r6 __post_init__Game.__post_init__s(*    13  +.%,/E %9;,.+-',.7nn.>=?35r5returnNcg)zRebuild runtime-only state after deserialization. Subclasses can override to rebuild non-serialized objects. Base turn management and sound scheduling are stored in serialized fields, so they do not require rebuilding. Nr*rvs r6rebuild_runtime_stateGame.rebuild_runtime_states r5cg)z8Return the display name of this game (English fallback).Nr*clss r6get_name Game.get_name r5cg)z)Return the type identifier for this game.Nr*rs r6get_type Game.get_typerr5relevant_preferencesc(SUR53$)z1Return the localization key for this game's name.z game-name-)rrs r6 get_name_keyGame.get_name_keysCLLN+,,r5cg)z3Return the category localization key for this game.zcategory-uncategorizedr*rs r6 get_categoryGame.get_categorys(r5cg)z!Return minimum number of players.r r*rs r6get_min_playersGame.get_min_playersr5cg)z!Return maximum number of players.r*rs r6get_max_playersGame.get_max_playersrr5c/$)aReturn additional leaderboard types this game supports. Override in subclasses to add game-specific leaderboards. Each dict should have: - "id": leaderboard type identifier (e.g., "best_single_turn") - "path": dot-separated path to value in custom_data Use {player_id} or {player_name} as placeholders e.g., "player_stats.{player_name}.best_turn" OR for ratio calculations, use: - "numerator": path to numerator value - "denominator": path to denominator value (values are summed across games, then divided) - "aggregate": how to combine values across games "sum", "max", or "avg" - "format": entry format key suffix (e.g., "score" for leaderboard-score-entry) - "decimals": optional, number of decimal places (default 0) The server will look up localization keys like: - "leaderboard-type-{id}" for menu display (with underscores as hyphens) - "leaderboard-{format}-entry" for each entry r*rs r6get_leaderboard_typesGame.get_leaderboard_typess . r5c/n[URVs/sHo"R(aMUPM sn5nX0R5:a#UR SSUR5045 U$s snf)afValidate game configuration before starting. Returns a list of localization keys for any errors found, or a list of (error_key, kwargs) tuples for errors that need context. Override in subclasses to add game-specific validation. Examples: return ["pig-error-min-bank-too-high"] return [("scopa-error-not-enough-cards", {"decks": 1, "players": 4})] zaction-need-more-players min_players)lenrLr>rappend)rwerrorsp active_counts r6prestart_validateGame.prestart_validateskt||J|!>>A|JK ..0 0 MM."D$8$8$:;   Ks A3A3 team_modecUR5n[U5nSU;d[SU55(a[R"U5n[R "X5(dgg)zHelper to validate team mode for current player count. Args: team_mode: Internal team mode string (e.g., "individual", "2v2"). Returns: Localization key for error if invalid, None if valid.  c3P# UHoS:wdM UR5v M g7f)vN)isupper).0cs r6 +Game._validate_team_mode.."s"N 1#X;199;; s &&zgame-error-invalid-team-modeN)get_active_playersranyrparse_display_to_team_modeis_valid_team_mode)rwractive_players num_playerss r6_validate_team_modeGame._validate_team_modes_002.)  ) s"N "NNN#>>yII--iEE1r5c^UR(aURURlgg)z*Synchronize table status with game status.N)rerPrvs r6_sync_table_statusGame._sync_table_status+s ;;!%DKK  r5playercURS:wagSUlSUlURR UR S5 [ URUR S9nURUR U5 g)z1Replace a human player with a bot (shared logic).playingNT)uuid) rPrBr<rdpopr:r r; attach_user)rwrbot_users r6_replace_with_botGame._replace_with_bot0s^ ;;) #  $   4(v{{3 H-r5cg)z4Start game logic after lobby transitions to playing.Nr*rvs r6on_start Game.on_start<s r5cDUR5 UR5 g)zRun per-tick logic (50ms). Override for bots/timers. Subclasses should call super().on_tick() to ensure base functionality runs. N)process_scheduled_soundscheck_estimate_completionrvs r6on_tick Game.on_tickAs %%' &&(r5cg)z?Handle round-timer expiry for games using RoundTransitionTimer.Nr*rvs r6on_round_timer_readyGame.on_round_timer_readyJs r5 player_idusercX RU'UR(aURUR5 UR(aUR UR5 gg)z Attach a user to a player by ID.N)rdrS play_musicrT play_ambience)rwrrs r6rGame.attach_userPsK!% I    OOD.. /    t44 5 !r5cLURRUR5$)zGet the user for a player.)rdgetr:rwrs r6get_user Game.get_userYs{{vyy))r5cRURHnURU:XdMUs $ g)zGet a player by ID (UUID).N)rLr:)rwrrs r6get_player_by_idGame.get_player_by_id]s&llFyyI% #r5r;cRURHnURU:XdMUs $ g)zr:rtrs r6_reset_transcriptsGame._reset_transcriptsks09=avM`M`]VYY]aas AAtextbuffercU(aUR(agURRUR/5R X#S.5 g)z&Store a transcript entry for a player.N)rr)r>rt setdefaultr:r)rwrrrs r6record_transcript_eventGame.record_transcript_eventos:,,  $$VYY3::D;[\r5cL[URRU/55$)z+Return the transcript history for a player.)listrtr)rwrs r6get_transcriptGame.get_transcriptws D%%)))R899r5cUR$)z#Get the team manager for this game.)rbrvs r6 team_managerGame.team_manager{s!!!r5)rhrkrlrorsrnrprmrfrurgrjrertrd)rzN)rr8rzN)table)Dr+r,r-r.r/r rJrrrLr8r1rMr2rNr3rPr0rRrSrTrUrWrXrYr[r\r]r^r_tupledictr`rarrrbrxr| classmethodrrrrrrrrrrrrrrrrrr rrrrrrrpropertyrr4r*r5r6rDrDUsN(*"" "$7GT&\7E3NKFCD#NM3cJNCOS!&"OT#Y$s#s"48d8 !#!/40KeCdN+,L$5:45PS$y/12P!&{!CM;C60       13(49-2-S--(S((d4j049tE#t)4D/E#E,SS4Z,- .  ) 6S666*v*$+*#&4-sv}b ?F]tm]+.]8;] ]::T#s(^0D:"k""r5rD)@r/ dataclassesrrtypingrrabcrrrqmashumaro.mixins.jsonr mashumaro.configr server.core.users.baser server.core.users.botr game_utils.actionsrgame_utils.optionsrDeclarativeGameOptionsrgame_utils.game_resultrrgame_utils.teamsrgame_utils.game_sound_mixinr#game_utils.game_communication_mixinrgame_utils.game_result_mixinr"game_utils.duration_estimate_mixinrgame_utils.game_scores_mixinr game_utils.game_prediction_mixinr game_utils.turn_management_mixinr game_utils.menu_management_mixinr"game_utils.action_visibility_mixinrgame_utils.lobby_actions_mixinrrgame_utils.event_handling_mixinr$game_utils.action_set_creation_mixinr !game_utils.action_execution_mixinr!"game_utils.action_set_system_mixinr"server.core.ui.keybindsr#r%r8rDr*r5r6r s+( #4''%*>*8H:F:BBBFI@IDE+      ! ! !:%  h"#h" h"r5