ij'dZddlmZddlZddlZddlmZmZmZm Z m Z m Z ddl m Z mZGddeeZGdd eeZe d Gd d Ze d GddZe d GddZe d GddZGddZdS)u Seasonal League & Realm Partitioning System for FreeExile. Provides Path of Exile 2 style League mechanics: - Permanent Standard Realm (Thái Hư Giới) vs Seasonal Challenge Leagues (Thiên Đạo Luân Hồi). - Clean slate resets every season (level 1, empty stash, fresh economy). - Remove-Only stash tabs for non-destructive seasonal merge. - Hardcore Permadeath immediate migration to Standard. - Solo Self-Found (SSF) isolation with voluntary opt-in trade migration. )EnumN)DictListOptionalTupleAnySet) dataclassfieldceZdZdZdZdZdZdS) LeagueTypestandard challengehardcoresolo_self_foundN)__name__ __module__ __qualname__STANDARD CHALLENGEHARDCORESOLO_SELF_FOUND;C:\Projects\FreeExile\server\world\season_league_manager.pyr r s"HIH'OOOrr c"eZdZdZdZdZdZdZdS) LeagueStatusupcomingactivefreezing migratingarchivedN)rrrUPCOMINGACTIVEFREEZING MIGRATINGARCHIVEDrrrrrs'H FHIHHHrrT)slotsceZdZUeed<eed<dZeed<dZeed<dZeed<e e Z e ee fed <d S) SeasonStashItem item_uuid item_name stack_count item_level PHAM_PHAMraritydefault_factoryraw_propertiesN)rrrstr__annotations__r.intr/r1r dictr4rrrrrr*r*!syNNNNNNKJFC%*U4%@%@%@NDcN@@@@@rr*ceZdZUeed<eed<eed<eed<dZeed<dZeed<d Ze ed <e e Z e eefed <d efdZded dfdZded eefdZd efdZd efdZdS)StashTabtab_id account_id league_idnameFis_remove_onlyz#d97706 color_hexcapacityr2itemsreturncL|j ot|j|jkSN)r?lenrCrBselfs r can_depositzStashTab.can_deposit6s"&&J3tz??T]+JJritemNc|jrtdt|j|jkr td|jd|jd||j|j<dS)Nz)Cannot deposit into Remove-Only stash tabz Stash tab 'z ' is full (z slots))r? ValueErrorrGrCrBr>r+)rIrKs r deposit_itemzStashTab.deposit_item9sl   JHII I tz??dm + +W49WWWWWXX X%) 4>"""rr+c8|j|dSrF)rCpop)rIr+s r withdraw_itemzStashTab.withdraw_item@sz~~i...rc2t|jdkS)Nr)rGrCrHs ris_emptyzStashTab.is_emptyCs4:!##rc8|jo|S)zHA Remove-Only tab that has been completely emptied can be safely pruned.)r?rSrHs r is_prunablezStashTab.is_prunableFs"6t}}6r)rrrr5r6r?boolr@rBr7r r8rCrr*rJrNrrQrSrUrrrr:r:+s0 KKKOOONNN III ND   IsHc(-d(C(C(CE4_$ %CCCKTKKKK**T****/s/x/H////$$$$$$7T777777rr:ceZdZUeed<eed<eed<eed<eed<dZeed<dZeed <e d Z eed <e e Z e eeefed <e e Zeeed<dS)SeasonCharacter character_idr<r> martial_classr=r-levelTis_alivecHttjdzSNir7timerrrzSeasonCharacter.Tss49;;;M7N7Nrr2 created_at_ms inventorymeridian_nodes_unlockedN)rrrr5r6r[r7r\rVr rblistrcrrrsetrdr rrrrXrXKsOOO IIINNNE3NNNHd/N/NOOOM3OOO&+eD&A&A&AItDcN#AAA(-c(B(B(BSXBBBBBrrXceZdZUeed<eed<eed<eed<dZeed<edZ e ed <d Z e ed <ee Z eeefed <d Ze ed <dS)Leaguer= display_name league_typestatusv1.0.0version_requirementcHttjdzSr^r_rrrrazLeague.`sStAS=T=Trr2start_time_epoch_msrend_time_epoch_msmechanic_flagsactive_characters_countN)rrrr5r6r rrmr ror7rpr8rqrrrrrrrhrhYsNNN ''''$u5T5TUUUUUUs%*U4%@%@%@NDcN@@@#$S$$$$$rrhcTeZdZdZddZddZejddfdeded e d ed ed e e eefde fd Z dede e fdZdededdfdZdededededef dZdede efdZdededefdZdedeeeffdZdededeeeffdZdededeefdZdS)SeasonLeagueManagerz Central Coordinator for Realms and Seasonal Leagues. Enforces realm partition rules, character creation gates, and status transitions. rDNcXi|_i|_i|_|dSrF)leagues charactersstashes_init_standard_realmrHs r__init__zSeasonLeagueManager.__init__ls1*, 68>@  !!#####rc ptddtjtjdddi}||jd<dS)Nru!Thái Hư Giới (Standard Realm)rl core_onlytruer=rirjrkrmrq)rhr rrr$rv)rIrs rryz(SeasonLeagueManager._init_standard_realmusG <"+& ('0    $, Z   rrlr=rirjrkrmrqc||jvrtd|dt||||||pi}||j|<|S)NzLeague with ID 'z' already existsr~)rvrMrh)rIr=rirjrkrmrqleagues r create_leaguez!SeasonLeagueManager.create_leaguesi  $ $K KKKLL L%# 3)/R    #) Y rc6|j|SrF)rvget)rIr=s r get_leaguezSeasonLeagueManager.get_leagues| ***r new_statusc|j|}|std|d|jtjkr|t jkrtd||_ dS)NLeague ' ' not foundz!Standard realm cannot be archived) rvrKeyErrorrjr rrr'rMrk)rIr=rrs rset_league_statusz%SeasonLeagueManager.set_league_statussq!!),, >rZr=r[r\stash_z Kho Chung 1F)r;r<r=r>r?)rvrrrkrr$rMvalueuuiduuid4hexrXrwrrrxr:) rIr<rrZr=rchar_idchar stash_key default_tabs rcreate_characterz$SeasonLeagueManager.create_charactersc!!),, JHYHHHII I =L/ / /C CC @SCCCDD D1$*,,*3B3/11 !'   $( &&!+&& + DL ( ("6 0! 466%#"$ K(3mDL # rrYc6|j|SrF)rwr)rIrYs r get_characterz!SeasonLeagueManager.get_characters""<000rworld_instance_league_idcT|j|}|sdS|j|kS)z Validates that a character is strictly authorized to enter an instance of that league. Prevents Standard realm characters from entering Seasonal instances and vice versa. F)rwrr=)rIrYrrs rvalidate_realm_accessz)SeasonLeagueManager.validate_realm_accesss4 ""<00 5~!999rc|j|}|sdd|dfS|j|j}|r|jt jkrdd|dfS|j}d|_d|_|jdkr|xjdzc_|jd}|xjdz c_dd|j d |d fS) z Permadeath handler for Hardcore leagues. The dead character is not deleted, but immediately migrated to the Standard realm. F Character 'rz' is not in a Hardcore leaguerTrr-z' perished in 'z' and was migrated to Standard) rwrrvr=rjr rr\rrr>)rIrYr source_league old_league_id std_leagues rhandle_hardcore_deathz)SeasonLeagueManager.handle_hardcore_deaths ""<00 BA AAAA A ((88  T 9Z=P P PS SSSS S #   01 4 4  1 1Q 6 1 1\*- **a/**j49jj]jjjjjrtarget_trade_league_idcZ|j|}|sdd|dfS|j|j}|r|jt jkrdS|j|}|r|jtj krdd|dfS||_dd|j d|d fS) zs Allows a Solo Self-Found character to voluntarily migrate to the trade league of the same season. Frr)FzEOnly Solo Self-Found characters can request voluntary trade migrationrz' is not an active trade leagueTz)' successfully migrated to trade league '') rwrrvr=rjr rrkrr$r>)rIrYrrr target_leagues rhandle_ssf_voluntary_migrationz2SeasonLeagueManager.handle_ssf_voluntary_migrations""<00 BA AAAA A ((88  b 9Z=W W Waa (()?@@  d 4 8K K Kc,Bcccc c/p49ppWmppppprc<|j||fgSrF)rxr)rIr<r=s rget_account_stashesz'SeasonLeagueManager.get_account_stashess|Y 7<<rs) 8888888888888888(((((((((((((d(((3 AAAAAAAA 77777777>  C C C C C C C C  % % % % % % % %c=c=c=c=c=c=c=c=c=c=r