Ůj_MdZddlmZddlZddlZddlZddlmZddlm Z m Z m Z m Z m Z ddlmZmZGddeZGd d eZGd d eZed d GddZed GddZed GddZed GddZed GddZdddddddd d!d"d#dd$d!d%d&d'dd(d)d*d+d,dd-d.d/d0d0dd1d2d3d4d5dd6d7d8d9d:dd;dd?dd@d=dAd?d?ddB ZGdCdDZdS)Eu Player Private Hideout (Tiên Phủ Động Thiên) & Waygate Infrastructure Engine for FreeExile. Architected following Path of Exile 2 (PoE2) Player Hideout & Endgame Map Device specifications. Core Subsystems: 1. Private Sanctuary Instance: 100% Zero-Trust Server-Authoritative private world instance. 2. Astral Map Device (Thiên Đạo Tinh Đồ Nghi): - Accepts Tier 1 to Tier 16 Astral Map Tablets. - Summons 6 active Swirling Void Portals in a hexagonal ring around the device altar. - Each portal traversal consumes 1 portal charge (6 -> 5 -> ... -> 0). 3. World Exploration Waygate (Vạn Giới Giới Môn): - Configurable portal link to any of the 10 Canonical Open World Zones. 4. Quest & Bounty Portal (Thiên Mệnh Bí Cảnh Môn): - Synchronizes with active quests (Story Chapters, Boss Bounties, Cryptic Chambers). - Instant direct teleportation to the target quest objective area. 5. Interactive Hideout Facilities: - Consignment Vault & Seasonal Stash (Remove-Only Tab Consolidation). - Primal Spirit Stone Alchemy Cauldron & Forge. - Meridian Meditation Mat (Bát Mạch Đồ Đàn). - AI Agent Orb Delegation Altar (Phân Thần Tu Luyện). ) annotationsN)Enum)DictListOptionalTupleAny) dataclassfieldceZdZdZdZdZdZdS) HideoutTheme ASTRAL_PEAK DRAGON_VALLEY BAMBOO_SHRINELUNAR_SANCTUARYN)__name__ __module__ __qualname__rrrr4C:\Projects\FreeExile\server\world\hideout_engine.pyr r s"K#M#M'OOOrr ceZdZdZdZdZdS)HideoutPortalTypeMAP_DEVICE_PORTALWORLD_EXPLORATION_GATEQUEST_BOUNTY_GATEN)rrrrrrrrrrr's"+5+rrc"eZdZdZdZdZdZdZdS) FacilityTypeCONSIGNMENT_STASH_VAULTPRIMAL_FORGE_CAULDRONMERIDIAN_MEDITATION_MATAGENT_ORB_ALTARASTRAL_MAP_DEVICEN)rrrrr r!r"r#rrrrr-s-737'O+rrT)slotsfrozenc~eZdZUded<ded<ded<ded<dZded<d Zded <d Zded <d Zded<dZded<dS) AstralMapstrmap_idnameinttierzone_template_id#item_quantity_bonus_pctitem_rarity_bonus_pctmonster_pack_size_pctuThống Lĩnh Man Quỷ boss_name)u$+25% Sát Thương Quái Vật Hỏau"Quái Vật Kháng Hàn Băng +30%u1+40% Tốc Độ Di Chuyển Của Quái Tinh AnhzTuple[str, ...]affixesN) rrr__annotations__r/r1r3r4r5rrrr'r'5sKKK III III#%%%%%!#####!#####.I.... Grr')r$ceZdZUded<dZded<dZded<dZded<d Zd ed <d Zd ed <dZ ded<dZ ded<e dZ ded<dZ ded<d S)MapDeviceStater( device_idfloatcenter_xcenter_yg@radiusNzOptional[AstralMap] active_map Optional[str]active_instance_idr+ total_portalsrportals_remainingcdgdzS)NFrBrrrrzMapDeviceState.Ps ugkrdefault_factoryz List[bool] portal_statesactivated_timestamp_ms)rrrr6r<r=r>r?rArCrDr rIrJrrrr8r8FsNNNHHF&*J****(,,,,,M %6I6I J J JMJJJJ"#######rr8cneZdZUded<dZded<dZded<dZded <d Zded <d Zd ed<dZ ded<dS)WorldGateStater(gate_idgr;r<@r=zone_tang_kiem_nhaitarget_zone_iduTáng Kiếm Nhaitarget_zone_nameTbool is_activez#38bdf8 vortex_colorN) rrrr6r<r=rPrQrSrTrrrrLrLTsLLLHH/N/////////I!L!!!!!!rrLceZdZUded<dZded<dZded<dZd ed <d Zded <d Zded<dZ ded<dZ ded<dZ ded<dZ ded<dZ ded<dS)QuestGateStater(rMg@r;r<rNr=quest_story_01_thuc_tinhr@active_quest_iduThức Tỉnh Kiếm Tâm quest_titlezone_ancient_sword_barrowrPuCổ Kiếm TrũngrQ^@target_objective_xg@U@target_objective_yTrRrSz#fbbf24rTN)rrrr6r<r=rXrYrPrQr\r]rSrTrrrrVrV_sLLLHH%?O????2K22225N555500000 %%%%% $$$$$I!L!!!!!!rrVceZdZUded<ded<ded<dZded<d Zded <ed Zd ed<ed Zded<ed Z ded<ed Z ded<ee Z ded<dS) PlayerHideoutr( hideout_idowner_player_idr themer:r;spawn_xgspawn_yc"tdS)Nmap_device_primaryr9)r8rrrrFzPlayerHideout.us~Xl?m?m?mrrGr8 map_devicec"tdS)Nworld_gate_primaryrM)rLrrrrFzPlayerHideout.v~Vj?k?k?krrL world_gatec"tdS)Nquest_gate_primaryrk)rVrrrrFzPlayerHideout.wrlrrV quest_gatecHttjdzS)N)r+timerrrrFzPlayerHideout.xsc$)++PTBT>U>Urr+created_timestamp_mszSet[str]visitorsN) rrrr6rcrdr rhrmrprtsetrurrrr_r_nsOOOGG!&7m7m!n!n!nJnnnn!&7k7k!l!l!lJllll!&7k7k!l!l!lJllll %6U6U V V VVVVVs333H333333rr_uBờ Đá Tàn Xương gI@)r* min_level max_levelxyuĐầm Lầy Thối Rữar0gN@gF@uSa Cốt Hoang Mạcr.Y@r[uPhế Tích Xẻ Thịt-gT@ga@uTế Đàn Man Hoang(7gb@uVực Đầm Băng Độc2AgV@gf@uVực Đói Nuốt Chửng<Kgi@g@j@uMiệng Lửa Nung MáuFUgd@g@o@uBệ Thờ Quỷ Đoạt Mệnhd) rOrZzone_boundless_sandstormzone_blood_scale_ruinszone_five_elements_altarzone_abyssal_ice_pondzone_infinite_blood_riftzone_purgatory_lava_cavernzone_boundless_celestial_palaceceZdZdZd)dZejfd*d Zd+d Zd,dZ d-d.dZ d/d0dZ d1dZ d2d3d#Z d4d&Zd5d(ZdS)6 HideoutEnginez Authoritative Hideout Manager for FreeExile. Manages private sanctums, 6-portal map device mechanics, and routing gates. returnNoneci|_dSN) _hideouts)selfs r__init__zHideoutEngine.__init__s 35r player_idr(rbr r_c ||jvr |j|Sdtjjdd}t |||t d|t d|td| }||j|<|S) zKRetrieves an existing hideout or instantiates a new sanctum for the player.ho_N dev_rgwgate_rkqgate_)r`rarbrhrmrp)ruuiduuid4hexr_r8rLrV)rrrbr`hideouts rget_or_create_hideoutz#HideoutEngine.get_or_create_hideouts  & &>), ,24:<<+CRC022 !%%0Cz0C0CDDD%.Cz.C.CDDD%.Cz.C.CDDD    %,y!r new_themeTuple[bool, str]cT||}||_dd|jdfS)z>Modifies the aesthetic theme of the player's personal hideout.Tu0Chuyển đổi cảnh quan Động Phủ sang [u] thành công.)rrbvalue)rrrrs rchange_hideout_themez"HideoutEngine.change_hideout_themes5,,Y77! h hhhhhr astral_mapr'&Tuple[bool, str, List[Dict[str, Any]]]c $|jdks |jdkrdd|jdgfS||}|j}d|jdt jjdd }||_||_d |_ d |_ d gd z|_ ttj d z|_g}td D]}|d t jzdz z}|j|jt!j|zz} |j|jt!j|zz} |||jd|t3| dt3| dd |j|jddd|jd|jd} d | |fS)u Activates the 6-Portal Astral Map Device (Thiên Đạo Tinh Đồ Nghi). Opens exactly 6 swirling portals around the dais perimeter in a hexagonal layout. rwFuCấp độ Tinh Đồ (Tier u/) không hợp lệ! Chỉ cho phép Tier 1-16. inst_map__Nr}rBTrrrNg@_pz#a855f7) portal_index portal_idr{r|is_openr,map_namecoloru;[THIÊN ĐẠO TINH ĐỒ NGHI] Kích hoạt thành công [z] (Tier u*)! Đã triệu hồi 6 Cổng Hư Không.)r,rrhr)rrrr?rArCrDrIr+rsrJrangemathpir<r>cosr=sinappendr9roundr*) rrrrdev instance_idportal_info_listianglepxpymsgs ractivate_map_devicez!HideoutEngine.activate_map_devices ?Q  */B"6"6z*/zzz|~~ ~,,Y77 M*"3LLdjll6Frr6JLL #!, !!FQJ%(t);%<%<"24q  Atw,-E TXe__ < !,,Y77 1T5TAR5T5T"O     "w{ppprtt t,,Y77#N3  *'/ z, )& 1 ~ ~";/O   lW`agWhlllnzzzrr~quest_idrY objective_xr; objective_yc T||}|j}t|idd} ||_||_||_| |_||_||_ d|_ |j |j |j |||| |||jd } dd|d| d| fS)zi Configures the Quest Waygate to direct the player directly to the quest objective area. r*uVùng Đất Lưu ĐàyT) rMr{r|rrYrPrQtarget_xtarget_yrTu>Thiên Mệnh Bí Cảnh Môn đã đồng bộ nhiệm vụ [u ] tại [r)rrprgetrXrYrPrQr\r]rSrMr<r=rT) rrrrYrPrrrqg zone_namers rconfigure_quest_gatez"HideoutEngine.configure_quest_gateis,,Y77  #'';;??Habb %$*' + + z &, )##O   yVayyluyyy|HH Hr facility_typercH||}|tjkr ddddddfS|tjkrdddddfS|tjkrddd dd fS|tjkrdd d dd fS|tjkr|jj}dd|dd|dfSddifS)zG Handles interaction with domestic hideout facilities. TuDMở Rương Vạn Giới Kỳ Trân & Tab Luân Hồi thành công.STASH)facility can_withdraw can_deposituNTiếp cận Luyện Đan Lô & Lò Đúc Linh Thạch sẵn sàng chế tác.FORGE)rcrafting_availableueNgồi vào Bát Mạch Đồ Đàn, khí huyết lưu thông, sẵn sàng đả thông huyệt vị.MERIDIAN)rmeditation_activeuXKích hoạt Định Hồn Thần Châu Đài uỷ thác AI Agent tự động du hành. AGENT_ORB)rdelegation_readyu>Thiên Đạo Tinh Đồ Nghi sẵn sàng (Cổng còn lại: z/6). MAP_DEVICE)rrDFu!Công trình không xác định.) rrrr r!r"r#rhrD)rrrrrs rinteract_facilityzHideoutEngine.interact_facilitys<,,Y77 L@ @ @_# $#bb  l@ @ @i#&*ll lB B BA&%)CC l: : :s'$(vv l< < <(:GgZaggg(%,jj  92==rDict[str, Any]c x||}|j}|j}|j}|j|jj|jr |jjnd|jr |jj nd|j |j t|j d|j|j|jd|j|j|j|j|jddS)z>Provides a structured overview of the player's hideout status.N)r?r,rDrCrI)rPrQrS)rrYrPrQrS)r`rbrhrmrp)rrhrmrpr`rbrr?r*r,rDrClistrIrPrQrSrXrY)rrhrrrs rget_hideout_summaryz!HideoutEngine.get_hideout_summarys  & &y 1 1l \ \,W]58^Mcn11/2~G++4%(%:!$!2!%c&7!8!8 #%"3$&$7\ .!~"$"3$&$7\    r)rr)rr(rbr rr_)rr(rr rr)rr(rr'rr)NN)rr(rrrrrrr)rr(rr'rrrr)rr(rPr(rr)r~r~)rr(rr(rYr(rPr(rr;rr;rr)rr(rrrr)rr(rr )rrr__doc__rr rrrrrrrrr rrrrrrs* 6666 +8*iiii .+.+.+.+f'+%) =!=!=!=!=!F&* )))))V{{{{N#"&H&H&H&H&HP&>&>&>&>P      rr)r __future__rrrsrenumrtypingrrrrr dataclassesr r r rrr'r8rLrVr_rrrrrrss,#""""" 33333333333333(((((((((((((4(((,,,,,,,, ,,,,,4,,, d###       $#    $ $ $ $ $ $ $ $ """"""""  " " " " " " " "  4 4 4 4 4 4 4 4%=1[]dhostt*ETUdfmqx|!}!})?b_ahmty z z'@r`bimtyzz)?b_ahmty z z&APRacjnuz{{)ETVegnsz!A!A+DSUdfmry~""0Q`bqt|AHM(N(N  L L L L L L L L L L r