🌦️ Sistema de Clima

🎯 Características del Sistema

🏗️ Arquitectura del Sistema

// Flujo del sistema de clima

Environment (Bioma)
    └── WeatherForecast[] (por hora 0-23)
            └── { WeatherId, Weight }  // Probabilidades

WeatherPlugin
    ├── WeatherResource (estado actual)
    │       ├── forcedWeatherIndex
    │       └── environmentWeather (clima por bioma)
    │
    ├── WeatherTracker (componente en jugadores)
    │       └── Tracking del clima actual del jugador
    │
    └── WeatherSystem
            ├── WorldAddedSystem (init)
            ├── PlayerAddedSystem (añade tracker)
            ├── TickingSystem (actualiza cada hora)
            └── InvalidateWeatherAfterTeleport

☀️ Configuración de Weather

El asset Weather.java (867 líneas) define todos los aspectos visuales del clima:

Propiedades del Cielo

class Weather {
    String id;                        // "Clear", "Rain", "Storm"...
    
    // Colores del cielo (cambian según hora)
    TimeColorAlpha[] skyTopColors;    // Color superior del cielo
    TimeColorAlpha[] skyBottomColors; // Color inferior del cielo
    TimeColorAlpha[] skySunsetColors; // Colores del atardecer
    
    // Sol y Luna
    TimeColor[] sunColors;            // Color del sol
    TimeColorAlpha[] sunGlowColors;   // Resplandor del sol
    TimeFloat[] sunScales;            // Tamaño del sol
    TimeColorAlpha[] moonColors;      // Color de la luna
    TimeColorAlpha[] moonGlowColors;  // Resplandor de la luna
    TimeFloat[] moonScales;           // Tamaño de la luna
    DayTexture[] moons;               // Texturas de luna por día
    
    // Iluminación
    TimeColor[] sunlightColors;       // Color de la luz solar
    TimeFloat[] sunlightDampingMultiplier; // Atenuación
}

Nubes

class Cloud {
    String texture;           // Textura de las nubes
    TimeColorAlpha[] colors;  // Colores por hora del día
    TimeFloat[] speeds;       // Velocidad de movimiento por hora
}

// Múltiples capas de nubes posibles
Cloud[] clouds;

Niebla

// Configuración de niebla
TimeColor[] fogColors;          // Colores por hora
TimeFloat[] fogDensities;       // Densidad por hora
TimeFloat[] fogHeightFalloffs;  // Caída de altura
float[] fogDistance;            // [near, far] distancia
FogOptions fogOptions;          // Opciones adicionales

Efectos Adicionales

// Partículas de clima (lluvia, nieve)
WeatherParticle particle;

// Efecto de pantalla (overlay)
String screenEffect;
TimeColorAlpha[] screenEffectColors;

// Filtros de color
TimeColor[] colorFilters;

// Tinte del agua
TimeColor[] waterTints;

// Estrellas
String stars;

⏰ Sistema de Colores por Hora (TimeColor)

El clima utiliza arrays de TimeColor y TimeFloat para definir valores que cambian según la hora del día:

class TimeColor {
    float hour;   // Hora del día (0-24)
    Color color;  // Color RGB
}

class TimeFloat {
    float hour;   // Hora del día
    float value;  // Valor interpolado
}

// Ejemplo: cielo que cambia durante el día
"SkyTopColors": [
    { "Hour": 0,  "Color": "#1a1a2e" },   // Medianoche - oscuro
    { "Hour": 6,  "Color": "#ff7b54" },   // Amanecer - naranja
    { "Hour": 12, "Color": "#87ceeb" },   // Mediodía - azul cielo
    { "Hour": 18, "Color": "#ff6b6b" },   // Atardecer - rojo
    { "Hour": 24, "Color": "#1a1a2e" }    // Vuelta a medianoche
]

🎲 Sistema de Pronóstico (WeatherForecast)

Cada Environment (bioma) tiene un pronóstico de clima con probabilidades:

class WeatherForecast implements IWeightedElement {
    String weatherId;     // "Clear", "Rain", "Storm"
    double weight;        // Peso/probabilidad
}

// En Environment.java
Int2ObjectMap<IWeightedMap<WeatherForecast>> weatherForecasts;

IWeightedMap<WeatherForecast> getWeatherForecast(int hour) {
    // Devuelve el pronóstico para esa hora
    return weatherForecasts.get(hour);
}

Ejemplo de Probabilidades

// Bosque en hora 12 (mediodía)
"WeatherForecast": {
    "12": [
        { "WeatherId": "Clear",  "Weight": 60.0 },  // 60%
        { "WeatherId": "Cloudy", "Weight": 25.0 },  // 25%
        { "WeatherId": "Rain",   "Weight": 10.0 },  // 10%
        { "WeatherId": "Storm",  "Weight": 5.0  }   // 5%
    ]
}

🔄 WeatherSystem (Actualización)

class WeatherSystem {
    // Constantes de transición
    static final float JOIN_TRANSITION_SECONDS = 0.5f;
    static final float WEATHERCHANGE_TRANSITION_SECONDS = 10.0f;
    
    // TickingSystem - Se ejecuta cada tick
    void tick(float dt, Store store) {
        WeatherResource weatherRes = store.getResource(WEATHER_RESOURCE_TYPE);
        
        // Si hay un clima forzado, usarlo
        if (weatherRes.consumeForcedWeatherChange()) {
            // Forzar actualización inmediata
            return;
        }
        
        // Verificar si cambió la hora
        int currentHour = worldTimeResource.getCurrentHour();
        if (weatherRes.compareAndSwapHour(currentHour)) {
            // Nueva hora = seleccionar nuevo clima para cada bioma
            for (Environment env : Environment.getAssetMap()) {
                IWeightedMap forecast = env.getWeatherForecast(currentHour);
                int selectedWeather = forecast.get(random).getWeatherIndex();
                environmentWeather.put(envIndex, selectedWeather);
            }
        }
        
        // Actualizar jugadores cada segundo
        playerUpdateDelay -= dt;
        if (playerUpdateDelay <= 0) {
            playerUpdateDelay = 1.0f;
            updateAllPlayers();
        }
    }
}

💻 Comandos de Clima

// WeatherResource.setForcedWeather()
public void setForcedWeather(@Nullable String forcedWeather) {
    this.previousForcedWeatherIndex = this.forcedWeatherIndex;
    this.forcedWeatherIndex = forcedWeather == null 
        ? 0  // Automático
        : Weather.getAssetMap().getIndex(forcedWeather);
}

🤖 Sensores de Clima para NPCs

Los NPCs pueden reaccionar al clima usando SensorWeather:

class SensorWeather extends Sensor {
    String[] weathers;  // Globs a matchear: "Rain*", "Storm"
    
    boolean evaluate(Role role, Store store) {
        int weatherIndex = role.getWorldSupport().getCurrentWeatherIndex(store);
        String weatherId = Weather.getAssetMap().getAsset(weatherIndex).getId();
        return matchesWeather(weatherId);
    }
    
    boolean matchesWeather(String weather) {
        for (String pattern : weathers) {
            if (StringUtil.isGlobMatching(pattern, weather)) {
                return true;
            }
        }
        return false;
    }
}

// Ejemplo de uso en NPC config:
"Sensors": {
    "IsRaining": {
        "Type": "Weather",
        "Weathers": ["Rain*", "Storm"]
    }
}

🐾 Spawning basado en Clima

El sistema de spawn puede usar el WeatherTracker para condicionar spawns:

// LocalSpawnControllerSystem usa WeatherTracker
WeatherTracker weatherTracker = store.getComponent(ref, WeatherTracker.getComponentType());
weatherTracker.updateEnvironment(transform, store);
int environmentIndex = weatherTracker.getEnvironmentId();

// Luego verifica condiciones de spawn por clima

🎯 WeatherTriggerCondition (Adventures)

El sistema de aventuras puede usar el clima como condición de trigger:

// WeatherTriggerCondition.java
// Permite crear objetivos que dependen del clima

// Ejemplo en Adventure config:
"Objectives": {
    "WaitForRain": {
        "TriggerCondition": {
            "Type": "Weather",
            "Weather": "Rain"
        }
    }
}

⚠️ Estabilidad y Problemas Comunes

Es posible experimentar inconsistencias en el clima debido a la arquitectura desacoplada de audio y video:

🛠️ Extensión: WeatherFixer Plugin

Para solucionar de forma automática los problemas de desincronía, hemos desarrollado el plugin WeatherFixer basado en la arquitectura de Hytale.

// Fragmento de la Auditoría en WeatherAuditSystem.java
if (suggestsRain && !hasParticles) {
    LOGGER.warning("[!] Inconsistencia Detectada: Clima '" + id + "' parece ser lluvioso pero NO TIENE partículas.");
}

📁 Archivos Clave

• 📄 Weather.java 867 líneas - Asset de configuración visual
• 📄 WeatherPlugin.java 57 líneas - Plugin principal
• 📄 WeatherSystem.java 190 líneas - Sistemas de actualización
• 📄 WeatherResource.java 75 líneas - Estado del clima por mundo
• 📄 WeatherForecast.java 57 líneas - Pronóstico con pesos
• 📄 Cloud.java 69 líneas - Configuración de nubes
• 📄 SensorWeather.java Sensor de clima para NPCs
• 📄 WeatherCommand.java Comandos /weather