CobbleDrock Legendary Encounters

# CobbleDrock Legendary Encounters

A companion add-on for **CobbleDrock 1.2.2** (Minecraft Bedrock) that spawns
Legendary Pokémon out in the wild. It merges two previous packs — *CobbleDrock
Legendary Spawns* and *CobbleDrock Wild Legendary Spawns* — into a single
add-on with two encounter schedules, so you only need to install one file.

> **This add-on does NOT contain the CobbleDrock game itself.**
> You must install **CobbleDrock Core 1.2.2** and **CobbleDrock Content 1.2.2**
> first, or this pack will not load.

---

## ✨ What it does

- **Popular tier** — spawns 21 popular/common Legendaries near players every
  **12–18 minutes**, each in its fitting biome:
  Articuno (icy), Zapdos (mountain peaks), Moltres (Nether), Mewtwo (caves),
  Entei (badlands/savanna), Lugia (deep ocean), Ho-Oh (sky), Regirock, Regice,
  Registeel, Latias, Latios, Kyogre (deep ocean), Groudon (desert/badlands),
  Rayquaza (sky), Reshiram, Zekrom, Kyurem, Tornadus (sky), Thundurus (sky),
  Landorus.

- **Special tier** — spawns **31 rare/special Legendaries** every
  **20–30 minutes**, including the ultra-rares: **Mew, Deoxys, Arceus,
  Darkrai (night only), Shaymin, Regigigas, Victini, Keldeo, Meloetta,
  Genesect** and more.

- **One Legendary at a time** — only a single Legendary exists in the whole
  world (all 3 dimensions) at any moment. The two tiers coordinate through the
  shared `lota:legendary_spawn` tag, so they never stack two encounters.

- **Real encounters** — spawned Pokémon have levels, IVs (with guaranteed
  perfect IVs), can be caught with the CobbleDrock capture system, and leave
  on their own after ~15–20 minutes if you don't catch them.

---

## 🎮 Spawn details

| Setting | Popular tier | Special tier |
|---|---|---|
| Spawn interval | 15 min ± 3 min (12–18) | 25 min ± 5 min (20–30) |
| Lifetime before leaving | 15 min | 20 min |
| Distance from players | 40–80 blocks | 48–96 blocks |
| Level range | 50–65 | 55–70 |
| Guaranteed perfect IVs | 2 | 3 |

Not included yet (planned for a future update): Celebi, Jirachi, Phione,
Manaphy, Diancie, Hoopa, Volcanion, Xerneas, Yveltal, Zygarde, Uxie, Mesprit,
Azelf, Dialga, Palkia, Giratina.

---

## 📣 Notifications (recommended companion)

This pack only **spawns** Pokémon — it stays silent on purpose to avoid double
alerts. Install **CobbleDrock Spawn Alerts** to get full server-wide
notifications when a Legendary appears, is captured, defeated, or despawns,
with name, dex number, level, IVs, nature, ability, coordinates, biome and the
nearest player.

---

## 🛠 Commands (operator)

```
/scriptevent lota:wild_status        - popular tier status + ETA + how many Legendaries are out
/scriptevent lota:wild_spawn         - force a popular Legendary spawn attempt
/scriptevent lota:wild_despawn       - remove the active popular Legendary
/scriptevent lota:legendary_status   - special tier status + ETA
/scriptevent lota:legendary_spawn    - force a special Legendary spawn attempt
/scriptevent lota:legendary_despawn  - remove the active special Legendary
```

---

## 📦 Requirements

- **Required:** CobbleDrock Core 1.2.2, CobbleDrock Content 1.2.2
- **Recommended:** CobbleDrock Spawn Alerts 1.0.0
- Minecraft Bedrock **1.21.120 or newer** (min engine version)
- Experimental toggle **Beta APIs** must be enabled on new worlds

## 🧩 Installation

1. Import Core 1.2.2, Content 1.2.2, then this add-on (double-click the
   `.mcaddon` file).
2. In your world: **Settings → Behavior Packs** → enable **CobbleDrock Legendary
   Encounters** (after Core and Content).
3. New world: enable the **Beta APIs** experiment.

## 📜 Changelog

**v1.0.0**
- Merged CobbleDrock Legendary Spawns + Wild Legendary Spawns into one pack.
- Popular tier: 21 species, 12–18 min; special tier: 31 species, 20–30 min.
- Shared "one Legendary at a time" rule across both tiers.
- Removed 6 dead table entries (Uxie, Mesprit, Azelf, Dialga, Palkia,
  Giratina) that had no entity in Core 1.2.2.
- New pack icon.