artillery pillagers

# 💥 Pillager Artillery 1.3.0
**An add-on for Historical Arms: the pillagers bring artillery to their raids!**

In the **final wave of every raid**, a full artillery battery takes position on a hill near the village and starts shelling it. To win the raid, you'll have to storm the guns.

## 🎖️ Two batteries
- **Napoleonic battery** (Easy / Normal): 5 bronze cannons manned by pillagers in Imperial Guard artillery uniforms, with bearskin hats and spyglasses.
- **🇫🇮 Finnish battery** (Hard): 4 **105 K/13 field guns** manned by pillagers in the Finnish **M/36 field uniform**, with M/40 helmets, binoculars and breech-loading animations.

## 🎯 Smart artillery crews
- **Strategic positions:** the battery scouts the terrain and picks high ground that overlooks the village. It looks for hilltops and ridges with a clear view and flat, dry ground.
- **Real ballistics:** every shot is aimed using the cannon's actual physics.
- **The lookout corrects every shot,** so the first rounds miss and the following ones get closer.
- **They shell the whole village:** houses, the bell, workplaces, villagers and golems.
- **Get too close and they'll fire at you:** canister from the bronze guns, direct fire from the 105s.
- **The guns stay in place:** after each recoil, the crew pushes the gun back into position.
- The crew counts toward the raid bar.

## 🎬 Cinematic intro
When the battery appears, nearby players get a cinematic with letterbox bars:
- The camera reveals the battery on its hill.
- Close-up of the lookout giving the order.
- **"FIRE!"** — the camera **follows the shell all the way to the village** and watches it explode.

## ⌨️ Commands (operators)
- `/pillagerartillery battery`: deploy the battery for the current raid.
- `/pillagerartillery battery napoleonic`: deploy the Napoleonic battery.
- `/pillagerartillery battery finnish`: deploy the Finnish battery.

## 🔧 Configurable
Battery distance, number of guns, which battery appears on each difficulty, accuracy, rate of fire, crew health, cinematic and more, all in `config/pillager-artillery.json`.

## 📦 Requirements
- Minecraft **26.3** · Fabric Loader 0.19.5+ · Fabric API · GeckoLib 5.5.7
- **Historical Arms 1.4.0+** (required)
- 💡 Use a render distance of **11 chunks or more** to see the battery and the cinematic.

---

# 💥 Pillager Artillery 1.3.0
**Complemento de Historical Arms: ¡los pillagers traen artillería a sus incursiones!**

En la **última oleada de cada incursión**, una batería de artillería se coloca en una colina cerca de la aldea y empieza a bombardearla. Para ganar la incursión tendrás que asaltar los cañones.

## 🎖️ Dos baterías
- **Batería napoleónica** (Fácil / Normal): 5 cañones de bronce servidos por pillagers con uniforme de artillería de la Guardia Imperial, gorro de piel de oso y catalejo.
- **🇫🇮 Batería finlandesa** (Difícil): 4 **cañones 105 K/13** servidos por pillagers con el **uniforme de campaña M/36** finlandés, casco M/40, prismáticos y animaciones de carga por la recámara.

## 🎯 Dotaciones inteligentes
- **Posiciones estratégicas:** la batería reconoce el terreno y elige un lugar alto que domine la aldea. Busca colinas y crestas con buena vista y terreno llano y seco.
- **Balística real:** cada disparo se apunta con la física real del cañón.
- **El vigía corrige cada disparo,** así que los primeros tiros fallan y los siguientes se acercan.
- **Bombardean toda la aldea:** casas, campana, puestos de trabajo, aldeanos y gólems.
- **Si te acercas demasiado, te disparan:** metralla con los cañones de bronce y tiro directo con los 105.
- **Los cañones no se mueven de su sitio:** después de cada retroceso, la dotación vuelve a colocar la pieza.
- La dotación cuenta en la barra de la incursión.

## 🎬 Cinemática de presentación
Cuando aparece la batería, los jugadores cercanos ven una cinemática con bandas de cine:
- La cámara muestra la batería en su colina.
- Primer plano del vigía dando la orden.
- **«¡FUEGO!»**: la cámara **sigue la bala hasta la aldea** y muestra la explosión.

## ⌨️ Comandos (operadores)
- `/pillagerartillery battery`: despliega la batería de la incursión actual.
- `/pillagerartillery battery napoleonic`: despliega la batería napoleónica.
- `/pillagerartillery battery finnish`: despliega la batería finlandesa.

## 🔧 Configurable
Distancia de la batería, número de cañones, qué batería sale en cada dificultad, precisión, cadencia, vida de la dotación, cinemática y más, todo en `config/pillager-artillery.json`.

## 📦 Requisitos
- Minecraft **26.3** · Fabric Loader 0.19.5+ · Fabric API · GeckoLib 5.5.7
- **Historical Arms 1.4.0+** (obligatorio)
- 💡 Usa una distancia de renderizado de **11 chunks o más** para ver la batería y la cinemática.