Raid System

# Sistema de Incursiones

Este mod añade incursiones a tu mundo y te permite crear nuevas. ESTO ESTÁ EN UNA FASE EXPERIMENTAL, ASÍ QUE ESPERA ERRORES O COSAS DESBALANCEADAS. NO HA SIDO PROBADO EN MODO MULTIJUGADOR.

Incursiones disponibles ACTUALMENTE:

Caza de Manada de Lobos – id: wolves

Asedio Nocturno (Supervivencia) – id: Undead_Siege

Emboscada de Esqueletos – id: Skeleton_Ambush

Emboscada de Arañas – id: Spider_Ambush

Ataque de Arenas de Esqueletos – id: Skeleton_Sands

Emboscada de Scarak – id: Scarak_Ambush

Emboscada de Hielo – id: Frost_Ambush

Supervivencia del Caos – id: Caos_Survival

No diré qué/qué mobs aparecen en cada una porque llevaría demasiado tiempo, pero puedes probar cada incursión usando /raid start <id>. Cada una tiene una probabilidad X en cada X ticks. Ten cuidado porque algunas incursiones tienen MUCHOS mobs.

—

## Empezando

### 1. Instalación

Simplemente coloca el archivo `.jar` en la carpeta de mods.

### 2. Configuración Dinámica (Por Mundo)

1. Entra en tu mundo y escribe `/raid createConfig`.
2. Navega a la carpeta de tu mundo: `HytaleUserDataSavesnombredeTumundouniverseworldsdefault_worldRaids`.
3. Edita o añade nuevas incursiones en el archivo `customRaids.json`.
4. En el juego, reconéctate (recarga automática) O escribe `/raid reloadConfig` para aplicar los cambios!

—

## Comandos de Administrador

* **`/raid createConfig`**
* **Función**: Crea una carpeta `Raids` dentro de la carpeta de tu mundo actual (`HytaleUserDataSavesnombredeTumundouniverseworldsdefault_worldRaids`) y genera un archivo `customRaids.json`.
* **Uso**: Escribe una vez para generar la estructura del directorio.

* **`/raid reloadConfig`**
* **Función**: Recarga el archivo `customRaids.json` (y los valores predeterminados del jar).
* **Cuándo usar**: Siempre que edites manualmente el archivo `.json` y quieras aplicar cambios sin reiniciar el servidor.

* **`/raid set <id> <property> <value>`**
* **Función**: Modifica instantáneamente una configuración para una incursión activa.
* **Ejemplos**:
* `/raid set wolves radius 100` (Aumenta el área).
* `/raid set zombies chance 0.05` (Cambia la probabilidad al 5%).
* `/raid set spiders checkInTicks 600` (Verifica cada 30s).

* **`/raid start <id> [wave]`**
* **Función**: Fuerza a que una incursión comience en tu ubicación.
* **Ejemplo**: `/raid start skeletons` o `/raid start spiders 3`.

—

## Guía de Configuración (JSON)

Al editar `customRaids.json`, defines **objetos** de incursión. Todos los campos se explican a continuación.

### 1. Campos Globales (Para cualquier incursión)

### 2. Tipos de Spawn (`spawnType`)

* **`”Circle”`**: (Predeterminado) Los monstruos aparecen aleatoriamente dispersos dentro del `radio`. Bueno para asedios caóticos.
* **`”Horde”`**: El juego elige UN punto aleatorio dentro del radio, y TODOS los monstruos de ese grupo aparecen juntos en ese punto. Bueno para simular un “escuadrón” o “platoón” que llega junto.

—

### 3. Tipos de Incursión (`raidType`)

Debes elegir UN tipo y configurar la lista correspondiente (`waves` O `presets`).

#### Tipo A: `”Regular”` (Oleadas Secuenciales)

Funciona en un estilo clásico: Oleada 1 -> Terminado -> Oleada 2 -> Terminado -> Victoria.
Utiliza la lista **`”waves”`**:

“waves”: [
{
“mobs”: [“Zombie”, “Skeleton”], // Lista de monstruos que pueden aparecer
“count”: 10, // Total de monstruos en esta oleada
“intervalSeconds”: 15, // Tiempo hasta la siguiente oleada
“chanceToNext”: 1.0, // Probabilidad de avanzar (1.0 = 100%)
“chanceToRepeat”: 0.0 // Probabilidad de repetir la MISMA oleada (bucle de “refuerzos”)
}
]

#### Tipo B: `”Survival”` (Resistencia Paralela)

Múltiples grupos (Presets) aparecen **simultáneamente** y continúan apareciendo periódicamente hasta alcanzar un límite. La incursión termina cuando todos los grupos agotan sus apariciones.
Utiliza la lista **`”presets”`**:

“presets”: [
{
“mobs”: [“Spider”],
“minSpawns”: 5, // Aparecerá este mob al menos 5 veces
“maxSpawns”: 20, // Máximo absoluto de veces que este grupo aparecerá
“mobsPerSpawn”: 3, // 3 arañas aparecen por cada activación de spawn
“delayBetweenSpawns”: 10, // Aparecen cada 10 segundos
“chanceToStop”: 0.2 // Después del mínimo (5), 20% de probabilidad de DETENERSE cada vez.
}
]

### Ejemplo Completo (`customRaids.json`)[
{
“id”: “zombie_invasion”,
“displayName”: “Apocalipsis Zombie”,
“raidType”: “Regular”,
“spawnType”: “Horde”,
“radius”: 40,
“checkInTicks”: 1200,
“chancePerTick”: 0.1,
“startDelaySeconds”: 5,
“waves”: [
{ “mobs”: [“Zombie”], “count”: 5, “intervalSeconds”: 10, “chanceToNext”: 1.0 },
{ “mobs”: [“Zombie”, “Skeleton”], “count”: 10, “intervalSeconds”: 10 }
]
},
{
“id”: “infinite_spiders”,
“displayName”: “Nido de la Reina”,
“raidType”: “Survival”,
“spawnType”: “Circle”,
“radius”: 60,
“checkInTicks”: 2400,
“chancePerTick”: 0.05,
“presets”: [
{
“mobs”: [“Spider”],
“minSpawns”: 10, “maxSpawns”: 50,
“mobsPerSpawn”: 2, “delayBetweenSpawns”: 5, “chanceToStop”: 0.1
}
]
}
]