<˾jLPdZddlmZddlZddlmZmZmZmZm Z ddl m Z ddl m Z mZddlmZddlmZmZmZmZmZmZmZmZmZmZdd lmZgd ZGd d ZdS) as Zone, Dungeon Instance, and Secret Chamber Engine for FreeExile. Implements: 1. Authoritative Map & Zone Registry (Sanctuary, Open World, Dungeons, Secret Chambers). 2. Boundary-Checked Movement, Spawning, and Anti-Cheat Teleport Validation. 3. Waypoint Network, Proximity Discovery, and Fast Travel Gating. 4. Portal Traversal with Level and Quest Prerequisite Verification. 5. Dynamic Dungeon Instances with Layer Progression, Spatial Grid Isolation, and Time Limits. 6. Cryptic Secret Chamber Spawning, Lifespan Timers, and Auto-Collapse Mechanics. 7. Seamless Closed-Loop Integration with QuestEngine & Combat Subsystems. ) annotationsN)DictListOptionalSetTuple) SpatialGrid)euclidean_distance_2dis_within_radius_2d)now_ms) ZoneTypeZoneEnvironmentWaypoint ZonePortalZoneDefinitionPlayerLocationDungeonTemplateInstanceSessionSecretChamberTemplateSecretChamberSession)®ister_canonical_zones_and_templates) ZoneEnginer rrrrrrrrrceZdZdZdKdZdLdZdMd ZdNd ZdOdZdPdZ dQdZ dRdZ dSdTd Z dUd#Z dVd%Z dWdXd&ZdYd)ZdZd,Zd[d.Z d\d]d6Zd^d<Zd_d?Zd`d@Z dadbdFZdcdHZdcdIZdddJZdS)erz Authoritative Zone, Instance, and Secret Chamber Management Engine. Guarantees strict spatial bounds, zero-trust fast travel, isolated instances, and reactive secret chamber mechanics. returnNoneci|_i|_i|_i|_i|_i|_i|_i|_t|dSN) zonesdungeon_templatessecret_chamber_templatesplayer_locationsplayer_unlocked_waypointsactive_instancesactive_secret_chamberszone_spatial_gridsr)selfs 1C:\Projects\FreeExile\server\world\zone_engine.py__init__zZoneEngine.__init__8s]02 =?JL%<>>@&=?GI#;= /t44444zonerc^||j|j<td|j|j<dS)z2Registers a zone and initializes its spatial grid.P@ cell_sizeN)rzone_idr r%)r&r*s r'add_zonezZoneEngine.add_zoneKs0#' 4< 0;d0K0K0K ---r)r/strcT||jvrtd|d|j|S)NzZone 'z' not found in registry.)rKeyErrorr&r/s r'get_zonezZoneEngine.get_zoneTs6 $* $ $EGEEEFF Fz'""r)Optional[ZoneDefinition]c6|j|S)zASafe lookup alias for zone definition; returns None if not found.)rgetr4s r'get_zone_definitionzZoneEngine.get_zone_definitionYsz~~g&&&r) template_idrcT||jvrtd|d|j|S)NzDungeon template ' ' not found.)rr3r&r:s r'get_dungeon_templatezZoneEngine.get_dungeon_template]s8 d4 4 4I IIIJJ J%k22r)rcT||jvrtd|d|j|S)NzSecret chamber template 'r<)r r3r=s r'get_secret_chamber_templatez&ZoneEngine.get_secret_chamber_templatebs8 d; ; ;P{PPPQQ Q,[99r)boolc|j|}|dS|jtjtjtjfvS)z PoE2 Rule: Safe Havens (Sanctuary Hub and Player Hideout) prohibit hostile mobs. Only OPEN_WORLD, DUNGEON_INSTANCE, and SECRET_CHAMBER allow hostile encounters. NF)rr8 zone_typer OPEN_WORLDDUNGEON_INSTANCESECRET_CHAMBER)r&r/r*s r'can_spawn_hostile_monstersz%ZoneEngine.can_spawn_hostile_monstersgs? z~~g&& <5~("5x7PRZRi!jjjr)xfloatyc|j|}|dS|jD]'}t |||j|j|jrdS(dS)z PoE2 Rule: Checks if coordinates (x, y) fall within the safe_radius of any registered waypoint in the specified zone. NFT)rr8 waypointsvaluesr rHrJ safe_radius)r&r/rHrJr*wps r'is_in_waypoint_safe_radiusz%ZoneEngine.is_in_waypoint_safe_radiusqsm z~~g&& <5.''))  B"1artR^DD tt ur)FNis_dummyOptional[float]tx Optional[int]tyTuple[bool, str]ct|ttfr>t|tur(t||t|nd}}d\}}}|rdS||sdd|dfS|s|q|j|}|U|j D];}t|||j |j |j rdd|j d |jd fcS<|n|ldd lm} dd lm} | |||} | | j| j| j| j| jfvs| sdd | jd|d|dfSdd|dfS)z`Validates monster spawn in zone: checks Safe Havens, waypoint safe_radius, and tile passability.Nr)FNN)TufKhôi Lỗi Luyện Võ (Target Dummy) được phép kích hoạt để thử nghiệm chiêu thức.FuSNghiêm cấm sản sinh quái vật trong khu vực An Toàn (Sanctuary/Hideout: [u]) theo chuẩn PoE2!u?Nghiêm cấm sản sinh quái vật trong phạm vi an toàn (u"m) của điểm dịch chuyển [z]!)ProceduralMapEngine)TileTypeuNNghiêm cấm sản sinh quái vật trên địa hình không thể đi qua [u ] tại (z, z)!Tu Khu vực [u6] hợp lệ để sản sinh quái vật dã ngoại.) isinstanceintrItyperArGrr8rLrMr rHrJrNname"server.world.procedural_map_enginerXserver.world.map_data_typesrY get_tile_typeWALLCHASMWATER BOSS_GATEVOID is_passable) r&r/rQrHrJrSrUr*rOrXrY tile_types r'validate_monster_spawnz!ZoneEngine.validate_monster_spawn~sN he - - /$x..2L2L]]amCFFFB.NHa  BBB..w77 OOpwOOOO O =Q]:>>'**D.//11B*1artR^LL!\^`^l\\QSQX\\\  >bn N N N N N N < < < < < <+99'2rJJIX]HNHNHL^`h`mnnnvwLwLwNwNnKenesKKAKKEGKKKb7bbbbbr) player_idrcZ||jvr||d|j|S)Nzone_boundless_sanctuary)r! spawn_player)r&ris r'get_player_locationzZoneEngine.get_player_locations5 D1 1 1   i)C D D D$Y//r)Set[str]c||jvrqt}|jD]?}|jD]#}|jr||j$@||j|<|j|Sr)r"setrrMrLis_unlocked_by_defaultadd waypoint_id)r&ridefault_unlockedzrOs r'get_unlocked_waypointsz!ZoneEngine.get_unlocked_waypointss D: : :), Z&&(( = =+,,..==B0=(,,R^<<<=9ID *9 5-i88r)c ||}||n|j}||n|j}t||||ddt }||j|<|||S)N)rir/rHrJru instance_idlast_update_timestamp_ms)r5default_spawn_xdefault_spawn_yrr r!rv) r&rir/rHrJr*spawn_xspawn_ylocs r'rlzZoneEngine.spawn_players}}W%%}!!$*>}!!$*>%+XX   ,/i( ##I... r)new_xnew_ycD||}||j}|jdz }|jdz }t ||kst ||krdd|jd|dd|ddfS||_||_t|_ dS) Ng@Fu%Vượt quá ranh giới bản đồ u (Tọa độ: x=z.1fz, y=))T) rmr5r/ bounds_width bounds_heightabsr]rHrJr rz)r&rirrrr*half_whalf_hs r'update_player_positionz!ZoneEngine.update_player_positions&&y11}}S[))"S(#c) u::  #e**v"5"5y$)yy^cyyymryyyyy y'-xx$xr) current_x current_yc||}||j}||}t }|jD]U\}} t||| j| j | j r.||vr*| || |V|S)zKChecks if the player is within range of any locked waypoint and unlocks it.) rmr5r/rvrprLitemsr rHrJdiscovery_radiusrr) r&rirrrr* unlocked_setnewly_discoveredwp_idrOs r'check_waypoint_proximityz#ZoneEngine.check_waypoint_proximitys&&y11}}S[))229== %(UU--// 0 0IE2"9irtREXYY 0 ,, $$U+++$((///r)target_waypoint_idc||}||vrdd|dfSd}|jD]}||jvr|j|}n|sdd|dfS||}|j|_|j|_|j|_|j|_d|_ t|_ dd|j d fS) z)Teleports player to an unlocked waypoint.Fu'Chưa kích hoạt Trụ Thần Hành 'z'!Nu'Không tìm thấy Trụ Thần Hành ''.Tu$Dịch chuyển thành công đến .) rvrrMrLrmr/rHrJruryr rzr])r&rirunlocked target_wprurs r'teleport_via_waypointz ZoneEngine.teleport_via_waypoints..y99 X - -ZDVZZZZ Z(, ""$$  A!Q[00K(:; 1 [ZDVZZZZ Z&&y11'    '-xx$MINMMMMMr) portal_id player_levelr[completed_questsOptional[Set[str]]Tuple[bool, str, str]c||}||j}||jvr ddd|dfS|j|}||jkrddd|d|jdfS|jr| |j|vrddd |jd fS|j|_|j|_|j |_ d|_ t|_ ||j}d |jd |jd fS)zn Traverses a zone boundary portal. Returns: (success, target_zone_id, status_message) Fru2Không tìm thấy Lối Qua Vùng Đất Chết 'u!' trong bản đồ hiện tại.u%Chưa đạt cấp độ yêu cầu (/u) để vào khu vực này!Nu.Cần hoàn thành nhiệm vụ tiền đề 'u"' để mở phong ấn lối qua!T Bước vào u thành công.)rmr5r/portals min_levelrequired_quest_idtarget_zone_idtarget_xrHtarget_yrJryr rzr]) r&rirrrr current_zoneportal target_zones r'traverse_portalzZoneEngine.traverse_portalsZ&&y11}}S[11 L0 0 0"S\ %i0 &* * *"DlDDU[UeDDDD D  # L)9)AVE]euEuEu"LvOgLLLL L+ '-xx$mmF$9:: V*,\Kz6ZoneEngine.create_dungeon_instance..>s$J$J$J11 >>Q>>>r)uSố lượng người chơi (u) vượt quá giới hạn (z).inst__zone_rr,r-) ryr:instance_zone_idleader_player_idmember_player_ids current_layer max_layerslives_remainingtime_limit_secstart_timestamp_ms spatial_gridrxTuKhai mở phó bản u thành công!)rrr]rlenmax_party_sizeuuiduuid4hexrr revive_livesrr r r#rmr/ryrHrJrz) r&r:rrrrtmpl all_membersryrsessionprs ` r'create_dungeon_instancez"ZoneEngine.create_dungeon_instance*s d4 4 4$ W W W WW W%k2 $. ( ($ dDN d dX\Xa d d dd d  ! yd&>  (#'G $g--r)c||jvrdS|j|}t}|jD];}||jvr0|j|}d|_d|_d|_d|_||_ , ? ?r)parent_zone_idportal_xportal_y lifespan_sec0Tuple[bool, Optional[SecretChamberSession], str]cX||jvr ddd|dfS|j|}||n|j}t} d|dtjjdd} d|} t | || ||||| | |d zzd d dtd  } | |j| <d | d|j dfS)zLDynamically spawns a secret chamber portal upon satisfying cryptic criteria.FNu'Không tìm thấy mẫu mật thất 'rchamber_rrriTr,r-) chamber_idr:chamber_zone_idriportal_zone_idrrspawn_timestamp_mscollapse_timestamp_ms is_active is_discovered is_clearedru&Kỳ ngộ xuất hiện: Cổng vào u đã khai mở!) r rr rrrrr r$r]) r&r:rirrrrrdurationcurrent_now_msrrrs r'spawn_secret_chamberzZoneEngine.spawn_secret_chambers d; ; ;$ Y+ Y Y YY Y,[9#/#;<<ARD DDdjll.>rr.BDD /+//&!#+)-"0HtO"D$t444   3:#J/Wbtybbbbbr)rc||jvrdS|j|}t}||jks|js||dS|j|krdS||}|j|_|j |_ d|_ d|_ ||_ ||j}dd|jdfS)z?Player steps through the secret portal into the secret chamber.)Fu?Cổng mật thất không tồn tại hoặc đã sụp đổ!)Fu;Mật thất đã sụp đổ, lối vào đã khép lại!)FuWCơ duyên mật thất này chỉ dành riêng cho người hữu duyên kích hoạt!rxTru8 thành công. Hãy nhanh chóng tìm kiếm cơ duyên!)r$r rrcollapse_secret_chamberrirmrr/rryrHrJrzr@r:r])r&rirchamberrrrs r'enter_secret_chamberzZoneEngine.enter_secret_chambers T8 8 8[[-j9 W: : :'BS :  ( ( 4 4 4WW   ) )ss&&y11- !,'5$//0CDDhTYhhhhhr)c^||jvrdS|j|}|j|krdSd|_dS)z0Marks the secret chamber objective as completed.)Fu Mật thất không tồn tại!)Fu,Không phải chủ sở hữu mật thất!T)Tu/Khai mở trọn vẹn cơ duyên mật thất!)r$rir)r&rirrs r'complete_secret_chamberz"ZoneEngine.complete_secret_chambersE T8 8 8<<-j9   ) )HH!FFr)c||jvrdS|j|}d|_|j}||jvrM|j|}|j|_d|_|j|_ |j |_ t|_ dSdS)zUCollapses the secret chamber and returns the player back to the parent zone entrance.NF)r$rrrir!rr/ryrrHrrJr rz)r&rrrirs r'rz"ZoneEngine.collapse_secret_chambers T8 8 8 F-11*==!% - - -' 2C!0CK"CO$CE$CE+188C ( ( ( . -r))rr)r*rrr)r/r1rr)r/r1rr6)r:r1rr)r:r1rr)r/r1rrA)r/r1rHrIrJrIrrA)FNNNN)r/r1rQrArHrRrJrRrSrTrUrTrrV)rir1rr)rir1rrn)NN) rir1r/r1rHrRrJrRrr)rir1rrIrrIrrV)rir1rrIrrIrrn)rir1rr1rrV)rN) rir1rr1rr[rrrr) r:r1rr1rrrr[rrnrr)ryr1rr)ryr1rrr)r:r1rir1rr1rrIrrIrrTrr)rir1rr1rrV)rr1rr)__name__ __module__ __qualname____doc__r(r0r5r9r>r@rGrPrhrmrvrlrrrrrrrrrrrrr)r'rr1sF 5555&LLLL#### ''''3333 :::: kkkk    ei6:cccccB0000 9999]a(*    "NNNN:mq]]]]]D2P2P2P2Ph....(????6'+%c%c%c%c%cNiiii2 G G G G444444r)r) r __future__rrtypingrrrrrserver.world.spatial_gridr server.common.math_utilsr r server.common.time_utilsr server.world.zone_typesr rrrrrrrrrserver.world.zone_catalogr__all__rrr)r'rsl  #""""" 33333333333333111111OOOOOOOO++++++                        MLLLLL   p4p4p4p4p4p4p4p4p4p4r)