IiJSrSSKJrJr \(aSSKJrJr "SS5rg)aBot helper for managing AI player actions. This is a stateless helper that operates on serialized Player fields: - player.bot_think_ticks: Ticks until bot can act - player.bot_pending_action: Action to execute when ready - player.bot_target: Game-specific target value ) TYPE_CHECKINGCallable)GamePlayerc .\rSrSrSrSr\SSSS\S-S\S S-S S4S jj5r \SS S S\S-S S4S jj5r \S S S\S-S S4Sj5r \S S S \S-4Sj5r \SS S\ /\S-4S\ \/S4S \4Sj5r\SSSS\S S4Sjj5rSrg) BotHelperzStateless helper for managing bot AI in games. All bot state is stored on Player fields for serialization. This helper provides utility methods for manipulating that state. Usage: BotHelper.on_tick(self) BotHelper.jolt_bots(game, ticks=10) NgamerticksplayersrreturncUbUO[RnUbUO URnUH#nUR(dMX5lSUlM% g)z Make bots pause before they can act. Args: game: The game instance. ticks: How many ticks to pause. Uses DEFAULT_THINK_TICKS if None. players: Specific players to jolt. All bots in game if None. N)r DEFAULT_THINK_TICKSris_botbot_think_ticksbot_pending_action)r r r pause_tickstarget_playersplayers ;c:\Users\dbart\PlayPalace11\server\game_utils\bot_helper.py jolt_botsBotHelper.jolt_botssG %0ei6S6S $+$7T\\$F}}})4&,0)%rclUR(a#UbUO[RnX lSUlgg)zJolt a single bot.N)rr rrr)rr rs rjolt_botBotHelper.jolt_bot1s0 ==#(#4%):W:WK%0 "(,F % rtargetcXlg)z%Set a game-specific target for a bot.N bot_target)rrs r set_targetBotHelper.set_target9s #rcUR$)z'Get the game-specific target for a bot.r!)rs r get_targetBotHelper.get_target>s   rbotthink_fn execute_fncURS:aU=RS-slgUR(aURnSUlU"U5 gU"5nU(aX0lgg)a Process a single bot's action cycle: think -> pending -> execute. This encapsulates the common pattern for bot action handling: 1. Count down think ticks if bot is still "thinking" 2. Execute pending action if one exists 3. Otherwise, call think function to decide what to do Args: bot: The bot player to process. think_fn: A callable that returns an action_id (or None if no action). execute_fn: A callable that takes an action_id and executes it. Returns: True if the bot took an action (executed or set pending), False if still thinking. Example usage: BotHelper.process_bot_action( bot=player, think_fn=lambda: self.bot_think(player), execute_fn=lambda action_id: self.execute_action(player, action_id), ) rFNT)rr)r(r)r* action_ids rprocess_bot_actionBotHelper.process_bot_actionCsg<    "   1 $   ! !..I%)C " y !J %. "rdebugcBUR(aURS:wagURnU(aD[SU(a UROSSU(a UR OSSUR 35 U(aUR (dgURS:aU=RS-slgUR(a%URnSUlURX#5 g[US5(a URU5nU(aX2lggg) zO Process bot actions for a tick. Call this from your game's on_tick() method. playingNz[BotHelper] current=z , is_bot=z , turn_index=rr, bot_think) game_activestatuscurrent_playerprintnamer turn_indexrrexecute_actionhasattrr3)r r0currentr-s ron_tickBotHelper.on_tickts4;;)#; %%  &ww||D&IelSZSaSarvRwxEFJFUFUEVW gnn   " "Q &  # #q ( #   % %22I)-G &    3  4 % %w/I-6* &r)NN)N)F)__name__ __module__ __qualname____firstlineno____doc__r staticmethodintlistrrr#r&rstrboolr.r=__static_attributes__r?rrr r sKQU11 4Z19=h$9N1 11&--#*---#8#S4Z#D##!8!d !!. .2sTz>*.cUD[).  ..`#7f#7T#7d#7#7rr N)rDtypingrr games.baserrr r?rrrMs!+)I7I7r