Description
THE ADVISORY
You're mining, or building, or walking home at dusk. Your screen goes black. A siren starts.
**EMERGENCY ALERT — CIVIL DANGER ALERT — *** This is not a test ***
You can't move. You can't close it. You can only read it.
A narrated advisory crawls up the screen in broadcast type. *Reports of anomalous entities have been confirmed throughout the affected area. Avoid all unnecessary travel. If you encounter any individual or object displaying impossible or abnormal behavior, leave the area immediately. Do not attempt to investigate.*
*Stay indoors. Stay alert. Stay alive.*
Then the screen judders, goes red, and tells you the part the advisory left out:
**IT'S WATCHING US.**
And then you're back in your world, standing exactly where you were, wondering whether anything actually changed.
Something did.
---
### THREE BROADCASTS
**The Emergency Alert** — the full sequence. A flashing warning screen with a real siren tone, blacking out and returning every few seconds. Then the scrolling narrated advisory, voiced and timed so the crawl and the narration start and finish together. Then the shaky red closing line. You're frozen for all of it.
**The Transmission** — a separate, much rarer event: an actual video clip, played back frame by frame inside Minecraft with its own soundtrack. No warning, no explanation. It is also the only warning you get before the Locust arrives.
**Mygal** — audio only. No screen, no freeze, nothing to look at. Just a sound over your world while you keep playing, which is somehow worse.
All three fire on their own, rarely, on independent timers — roughly one alert every three hours of play, the transmission about three times rarer. Every interval, cooldown and chance is configurable, and all three can be triggered by command whenever you want to use them yourself.
---
### STAY INDOORS — *and the advisory was wrong about that*
Once every eight in-game days or so, the dice come up wrong.
The transmission plays to **everybody online**, in broad daylight. That's your warning. You have until nightfall.
When it gets dark, one Locust is placed out in the world near a random player, forty to seventy-five blocks out — far enough to be a silhouette rather than an ambush. It is **ten blocks tall**, rendered from a fully skinned glTF model with a hand-built walk cycle, and it moves on the needle claws at the end of its arms.
It does not run at you. It plays by rules:
- **It freezes when you look at it.** The moment your crosshair comes near it and there's line of sight, it stops dead. You will never watch it take a step.
- **It closes the distance when you look away.** Turn your back and it walks straight at you, until it's about twenty blocks off, then stands and watches.
- **If you stare it down, it's gone.** Hold your gaze on it for a few seconds and it relocates — behind you.
- **You cannot walk up to it.** Get close while it's still watching and it simply isn't there anymore. It reappears sixty-odd blocks away and starts over.
- **It kneels to look at you.** Inside twenty-six blocks it folds down onto its knees, because at full height its head is above your roofline.
- **Hiding indoors doesn't work.** While you're enclosed with no sky above you, it finds the glass and the doors in your walls, works out which side is outside, and goes and kneels there, facing in. It fills the window. To find the face you have to go out and look up.
- **Eventually it stops pretending.** Come within range, hit it, or just let its patience run out, and it drops onto all fours and hunts. 200 health, 14 damage, and a stride that covers ground in proportion to its size.
*Stay alert* is the only part of the advisory that actually helps. There is only ever **one**, no new roll happens while it's still out there, and the whole event — warning, arrival, the thing itself — survives a server restart.
---
### COMMANDS
Everything is op-level (permission 2) and takes an optional player selector, so this works as a tool for map-makers and server admins, not just as something that happens to you.
| Command | What it does |
|---|---|
| `/emergencyalert [players]` | Play the full alert: flash, advisory crawl, shaky ending |
| `/transmission [players]` | Play the video transmission |
| `/mygal [players]` | Play the audio-only broadcast (no screen, no freeze) |
| `/<any of the above> stop [players]` | Abort whatever is currently playing |
| `/locust spawn [stalking\|hunting]` | Put one in front of you, in a chosen mode |
| `/locust info` | What every nearby Locust is doing: stalking or hunting, whether it thinks you can see it, how much patience it has left |
| `/locust stance stalk\|crawl` | Force the pose |
| `/locust freeze` / `/locust unfreeze` | Switch its AI off so you can walk around it and look |
| `/locust clear` | Remove the ones you spawned |
| `/locustmodel` | Model readout: batches, triangles, bones, joints, measured limb lengths |
There's also a **Locust Spawn Egg** in the Spawn Eggs creative tab.
---
### WRITE YOUR OWN ADVISORY
`config/emergencyalert-common.toml` is built for editing, and every option is commented in the file itself:
- **Rewrite every word on screen** — the alert header, the full narrated advisory, the closing lines. *Stay indoors. Stay alert. Stay alive.* is just the default.
- **Reorder or remove the phases.** `flash`, `slide`, `shake`, `video` — build your own sequence for either broadcast. Want the alert to end on the video? Add it.
- **Swap the audio.** Drop your own `emergency_alert.ogg`, `narrator.ogg`, `mygal.ogg` or video soundtrack in and set the phase durations to match — the crawl speed is derived from the duration, so the text stays in sync with whatever you record.
- **Replace the video entirely.** Frames are plain JPEGs with an `ffmpeg` one-liner in the properties file.
- **Tune every trigger** — per-event rarity, per-player cooldowns, or turn natural triggering off completely and drive the whole thing from command blocks and datapacks.
- **Tune the Locust** — its nightly chance, spawn distance, and whether it gets announced at all. Turn the announcement off and it just arrives, with no advisory to ignore.
- Volumes are separate per sound, and the siren is turned well down by default because it is loud.
- `enabled = false` is a single master switch.
---
### COMPATIBILITY
- **Minecraft 1.20.1 / Forge 47+**
- Required on **both** client and server (the broadcast is rendered client-side)
- Works fine in singleplayer
- No hard dependencies beyond Forge
- MIT licensed
---
**Fair warning:** flashing imagery, a loud siren, and a jump-scare-adjacent ten-block humanoid. Set `naturalEnabled = false` if you'd rather decide for yourself when it happens.

