# Scene Switching, Weather Engine, and Map Warp Reference

This document covers the mechanics for world region ("raid") switching, atmospheric/weather control, and the 2-click pin & warp map interaction.

---

## 1. Scene ("Raid") Switching (`SceneCatalog4229938.cs`)

Ananta's open world is partitioned into distinct sub-regions, instances, and raids defined in `RaidConfig.json` and `MapentranceConfig.json`:

### Triad ID Architecture
Every scene transition requires three authoritative identifiers:
1. **`raidId`**: The specific map/dungeon region (e.g. `23300888` for Main City, `23300999` for Longqi Mountain).
2. **`instanceId`**: The active scene instance (e.g. `20001222`, `20001223`).
3. **`universeId`**: The overarching world universe context (standard: `76000888`).

### Dynamic Presets
The server parses all valid map entrances dynamically into `SceneCatalog4229938.Presets`:
- **Main City Center**: `raid: 23300888`, `x: 3142.7`, `y: 0`, `z: 2522.8`
- **Airport District**: `raid: 23300888`, `x: -4468.3`, `y: -6.2`, `z: -2597.5`
- **Longqi Ancient Temple**: `raid: 23300999`, `x: -4306.0`, `y: 156.8`, `z: -3240.8`
- **Longqi Tea Plantation**: `raid: 23300999`, `x: -4818.4`, `y: 192.3`, `z: -2690.1`

When a switch is requested, the server sends `SyncSceneLoadCompleted` and teleports the player's managed spirit into the new instance.

---

## 2. Weather & Atmospheric Control (`WeatherCatalog4229938.cs`)

Ananta features an advanced hybrid weather pipeline combining server RPC state with client shader/particle overrides:

### Standard Weather States (`WeatherCatalog4229938`)
| ID | Weather Name | Environment Visuals |
| :---: | :--- | :--- |
| **`1`** | **☀️ Sunny (晴天)** | Clear sky, bright sunlight, natural shadows. |
| **`2`** | **⛅ Cloudy (多云)** | Overcast clouds, diffused indirect lighting. |
| **`3`** | **🌧️ Rain (小雨)** | Light precipitation, road puddle reflections. |
| **`4`** | **⛈️ Storm (暴风雨)** | Heavy rain, thunderstorm lighting, active wind vectors. |
| **`5`** | **🌤️ Afterrain (雨后)** | High-clarity atmosphere, wet asphalt specular glimmers. |

### Hybrid GPU Rain & Volumetric Fog
To guarantee visual effects render immediately without waiting for client transition cycles:
- **`CMD:SET_WEATHER:<id>`**: Dispatched via `SyncNotice` to activate client-side GPU particle rain (`SetGPURainActive`).
- **`CMD:SET_FOG:<density>`**: Direct override for Unity's Volumetric Exponential Fog density (e.g. `0.08` for heavy fog, `0.00` for crystal clear).

---

## 3. 2-Click Pin & Warp Map Interaction

### Problem with Standard Teleport
In default CBT clients, clicking on the mini-map or full map frequently triggered coordinate conversion errors, causing players to teleport to $(0, 0, 0)$ (ocean fall or out-of-bounds void).

### The 2-Click Pin & Warp Pattern
1. **Click 1**: Left-clicking anywhere on the map drops a navigation pin and notifies the player: `"Pin set! Click again to Warp"`.
2. **Click 2**: Clicking directly on the set pin executes the warp to those precise world coordinates and automatically dismisses the map screen.
3. **Zero-Coordinate Safety Interceptor**: Both client proxy and server packet handlers intercept any destination vector matching $(0, 0, 0)$ or invalid NaN/Infinity coordinates, protecting the player from void death.