Weather And Daynight

Key Exports

import {
  TimePeriod,           // enum: Dawn, Day, Dusk, Night
  CYCLE_LENGTH,         // 360
  getTimePeriod,        // (step: number) → TimePeriod
  getEncounterMultiplier, // Dawn/Day=1.0, Dusk=1.25, Night=1.5
  isNightTime,          // true during Dusk and Night
  PERIOD_TINT,          // Record<TimePeriod, 0xRRGGBB>
  PERIOD_LABEL,         // Record<TimePeriod, "🌅 Dawn" etc.>
} from "../systems/daynight";

Visual Effects

• Overworld: Tint applied to every tile sprite via applyDayNightTint()
• Battle: Background image tinted + celestial body drawn (sun/moon)
  • Dawn: sun low-left (rising)
  • Day: sun upper-left with rays
  • Dusk: sun mid-left (setting, redder)
  • Night: crescent moon upper-left + scattered stars
• Music: Night mode shifts major scales to relative minor, darker tone

Gameplay Effects

• Encounter rate increases at dusk (+25%) and night (+50%)
• Night-exclusive monsters spawn during Dusk and Night periods
• timeStep is persisted in save data and passed through all scene transitions

Weather System (src/systems/weather.ts)

Weather Types

Weather State

interface WeatherState {
  current: WeatherType;
  stepsUntilChange: number; // Countdown to next weather check
}

// Create fresh state (starts Clear, 40 steps until first check)
const state = createWeatherState();

Biome-Weighted Probabilities

Each chunk name maps to weather weights. Examples:

• Mountain chunks: high Snow/Fog probability
• Desert chunks: high Sandstorm probability
• Swamp chunks: high Fog/Rain probability
• Tundra chunks: Snow dominant

Key Functions

import {
  WeatherType,
  createWeatherState,
  advanceWeather,         // Step-based countdown, may change weather
  changeZoneWeather,      // Called on chunk transition
  getWeatherAccuracyPenalty,  // Accuracy penalty for combat
  getWeatherEncounterMultiplier, // Encounter rate modifier
  getMonsterWeatherBoost, // Per-monster AC/ATK/DMG bonuses
  WEATHER_TINT,           // Tint colors per weather type
  WEATHER_LABEL,          // HUD labels per weather type
} from "../systems/weather";

Combat Effects

// In combat, apply weather penalties:
const weatherPenalty = getWeatherAccuracyPenalty(weatherState.current);
const boost = getMonsterWeatherBoost(monster.id, weatherState.current);
// boost.acBonus, boost.attackBonus, boost.damageBonus

Adding a New Weather Type

1. Add to WeatherType enum
2. Add probability weights in BIOME_WEATHER records
3. Add accuracy penalty in WEATHER_ACCURACY_PENALTY
4. Add encounter multiplier in WEATHER_ENCOUNTER_MULT
5. Add tint color in WEATHER_TINT
6. Add label in WEATHER_LABEL
7. Add particle config in overworld updateWeatherParticles() (in renderers/map.ts) and Battle.createWeatherParticles()
8. Add ambient SFX in audioEngine.playWeatherSFX()

Scene Data Flow

Both systems' state must be passed through every scene transition:

this.scene.start("NextScene", {
  player: this.player,
  defeatedBosses: this.defeatedBosses,
  codex: this.codex,
  timeStep: this.timeStep,           // Day/night position
  weatherState: this.weatherState,   // Current weather + countdown
});

Common Pitfalls

• ❌ Don't forget to pass weatherState in scene transitions — it resets to Clear otherwise
• ❌ Don't apply weather in dungeons/cities — they force WeatherType.Clear
• ❌ Don't forget to call rerollWeather() on chunk transitions
• ❌ Don't use hardcoded step numbers — use getTimePeriod() and constants