IiSrSSKJrJr SSKJr SSKJr SSKJ r J r SSK r SSK Jr \ (aS S KJr "S S \5r"S S\5r\"SS55r"SS\5rS\4SjrS\S\4Sjrg)z-Abstract User class that games interact with.)ABCabstractmethod) dataclass)Enum) TYPE_CHECKINGAnyN) LocalizationUserPreferencesc$\rSrSrSrSrSrSrSrg)EscapeBehaviorz$How the escape key behaves in menus.keybindselect_last_option escape_eventN) __name__ __module__ __qualname____firstlineno____doc__KEYBIND SELECT_LAST ESCAPE_EVENT__static_attributes__r5c:\Users\dbart\PlayPalace11\server\core\users\base.pyrrs.G&K!Lrrc(\rSrSrSrSrSrSrSrSr g) TrustLevelz'User trust level for permission checks.rr r rN) rrrrrBANNEDUSERADMIN SERVER_OWNERrrrrr!r!s1 F D ELrr!cj\rSrSr%Sr\\S'Sr\S-\S'Sr\S-\S'S\ \\ 4\-4Sjr S r g) MenuItem z&A menu item with text and optional ID.textNidsoundreturncURc URbHSUR0nURbURUS'URbURUS'U$UR$)zUser4z Abstract base class for users. Games interact with this interface, never with network code directly. Implementations include NetworkUser (real players), TestUser (for testing), and Bot (AI players). r.cg)z+The user's unique identifier (UUID string).Nrr0s ruuid User.uuid= rcg)zThe user's display name.Nrr;s rusername User.usernameCr>rcg)z6The user's locale for localization (e.g., 'en', 'es').Nrr;s rlocale User.localeIr>rc"[R$)z;The user's trust level. Defaults to USER if not overridden.)r!r%r;s r trust_levelUser.trust_levelOsrcSSKJn U"5$)z;The user's preferences. Returns defaults if not overridden.r r ) preferencesr )r0r s rrIUser.preferencesTs 1  rr+bufferNcg)z Send a text message to be displayed and spoken via TTS. Args: text: The message text. buffer: Which buffer to route the message to (misc, activity, chats). Nr)r0r+rKs rspeak User.speak[ r message_idc j[R"URU40UD6nURXB5 g)z Send a localized message to be displayed and spoken via TTS. Args: message_id: The message ID from the .ftl file. buffer: Which buffer to route the message to (misc, activity, chats). **kwargs: Variables to substitute into the message. N)r getrCrM)r0rPrKkwargsr+s rspeak_l User.speak_lfs+ ZB6B 4 rnamevolumepanpitchcg)z Play a sound effect. Args: name: Sound filename. volume: Volume 0-100. pan: Pan -100 to 100. pitch: Pitch 0-200, where 100 is normal. Nr)r0rVrWrXrYs r play_soundUser.play_soundrs rTloopingcg)za Play background music. Args: name: Music filename. looping: Whether to loop the music. Nr)r0rVr]s r play_musicUser.play_musicrOrcg)zStop background music.Nrr;s r stop_musicUser.stop_music rloopintrooutrocg)z Play ambient background sound. Args: loop: Looping ambient sound filename. intro: Optional intro sound played once before loop. outro: Optional outro sound played when stopping. Nr)r0rerfrgs r play_ambienceUser.play_ambiences rcg)zStop ambient background sound.Nrr;s r stop_ambienceUser.stop_ambiencerdrFr ) multiletterescape_behaviorposition grid_enabled grid_widthplay_selection_soundmenu_iditemsrnrorprqrrrscg)a Display a menu to the user. Args: menu_id: String identifier for this menu. items: List of menu items (strings or MenuItem objects). multiletter: Enable type-to-search navigation. escape_behavior: How escape key behaves (see EscapeBehavior enum). position: 1-based position to select (None for first item). grid_enabled: Enable grid navigation mode. grid_width: Number of columns in grid mode. play_selection_sound: Play the selection sound for the focused item. Nr) r0rtrurnrorprqrrrss r show_menuUser.show_menus4 r selection_idcg)a Update an existing menu's items. Args: menu_id: The menu to update. items: New list of items. position: Optional new position (1-based). selection_id: Optional item ID to focus on. play_selection_sound: If True, client plays selection sound at new focus. Nr)r0rtrurpryrss r update_menuUser.update_menus& rcg)z8 Remove a menu. Args: menu_id: The menu to remove. Nr)r0rts r remove_menuUser.remove_menu r) multiline read_onlyinput_idprompt default_valuerrcg)a Display an editbox to the user. Args: input_id: String identifier for this editbox. prompt: Prompt text to display. default_value: Default text in the editbox. multiline: Whether to use a multiline editbox. read_only: Whether the editbox is read-only. Nr)r0rrrrrs r show_editboxUser.show_editboxs( rcg)z@ Remove an editbox. Args: input_id: The editbox to remove. Nr)r0rs rremove_editboxUser.remove_editboxrrcg)zClear all menus and editboxes.Nrr;s rclear_ui User.clear_uirdrr)r.r )misc)drr)T)r.N)r)NNF)r)"rrrrrpropertyrr4r<r@rCr!rFrIrMrTintr[boolr_rbrirlrrlistr)rwr{r~rrrrrrrr8r84sP c   #     Z!!  # s    !# !s !$ !  s  C  C  C  Z^     s T T      #  c  s  D       !*8*@*@#"%*  C(N#   (  *   #    6 $#'%*   C(N# *  Dj  #     ( 3 4                 * s t    rr8r.c>[[R"55$)zGenerate a new UUID string.)r4 uuid_moduleuuid4rrr generate_uuidrs {  " ##rrVct[R"S5n[[R"USU355$)zGenerate a deterministic UUID for a virtual bot based on its name. This ensures virtual bots have consistent UUIDs across server restarts so their game stats persist properly. z$a1b2c3d4-e5f6-7890-abcd-ef1234567890z virtual_bot:)rUUIDr4uuid5)rV namespaces rgenerate_virtual_bot_uuidrs4  !GHI {  l4&,AB CCr)rabcrr dataclassesrenumrtypingrrr<rmessages.localizationr rIr rr!r)r8r4rrrrrrs3#!%1,"T"  &J 3J Z$s$ DCDCDr