HAARP Weather Control

You're standing on a hilltop at dusk. You'd love to take a screenshot
right now if only the sky was a little more dramatic. You type
`/haarp 5`. A thunderstorm rolls in. You take the screenshot.

HAARP is the small mod that lets you control the weather in your
Hytale world on demand.

## What it is

A single command, `/haarp`, opens a colour-coded menu of 14 themed
weather programs. Pick one. The weather changes, runs for a set
duration, and then expires on its own. Cooldowns keep you from
spamming the same effect every minute, but otherwise the controls
are immediate and reliable.

It runs entirely server-side. Players don't need any client mod —
they just see the weather change.

## The 14 programs

| # | Program | Duration | Cooldown | Notes |
|---|---|---|---|---|
| 1 | Light Rain | 120s | 60s | Gentle rainfall, calming ambiance |
| 2 | Clear Sky | 180s | 60s | Stops all weather. Blue skies return |
| 3 | Light Fog | 90s | 45s | Mild atmospheric haze |
| 4 | Heavy Rain | 240s | 120s | Intense downpour with puddle effects |
| 5 | Thunderstorm | 300s | 180s | Lightning and wind. Dramatic but safe |
| 6 | Dense Fog | 120s | 90s | Thick fog blankets the area |
| 7 | Dust Storm | 180s | 120s | Sand particles swirl |
| 8 | Blizzard | 240s | 150s | Snow and ice effects |
| 9 | Aurora Borealis | 300s | 180s | Northern lights — best at night |
| 10 | Electrical Storm | 180s | 150s | Intense lightning show. Spectacular and safe |
| 11 | Acid Fog | 150s | 120s | Eerie green-tinted fog. Cosmetic only |
| 12 | Radiant Clear | 240s | 180s | Enhanced clear sky with golden light |
| 13 | Blood Moon | 300s | 180s | Massive red moon, twisted clouds. Best at night |
| 14 | Void Storm | 180s | 180s | WARNING: Void event atmosphere. Darkens sky — may increase dark mob spawns |

## How to use it

Type `/haarp` for the menu. The list appears in chat — green entries
are ready to activate, red entries are on cooldown with the remaining
time shown.

Pick a program by number or name:

- `/haarp 5` — activate Thunderstorm by number
- `/haarp thunderstorm` — by name
- `/haarp activate THUNDERSTORM` — explicit syntax

Other useful commands:

| Command | What it does |
|---|---|
| `/haarp` | Show the colour-coded menu |
| `/haarp <1-14>` | Activate by program number |
| `/haarp <name>` | Activate by program name (fuzzy match) |
| `/haarp status` | Show the active program + remaining time + current world hour |
| `/haarp cancel` | End the active program early |
| `/haarp programs` | Detailed descriptions of all 14 programs |
| `/haarp help` | Compact reference page |

Per-player cooldowns mean each player has their own activation timer
on each program. If you've just used Thunderstorm, you can't trigger
it again for three minutes — but a friend on the same server still can.

## What's new in v3.0.3

A long-standing silent bug got fixed. Per-player attribution and
cooldowns now actually work — previously the mod was treating every
command as if it came from console, so cooldowns were globally shared
and `/haarp status` always showed "Activated by: Console" regardless
of who triggered the program. Full details in the changelog.

## What it isn't

- **Not a forecast system.** HAARP is direct manual control, not
scheduled weather. Set the weather and it stays until the timer
expires or you cancel. Pair with **Turning Seasons** if you want
automatic seasonal cycles.
- **Not a permission system.** Anyone with chat access can run
`/haarp` and trigger weather. If your server needs op-only weather
control, configure that through Hytale's permission system — HAARP
doesn't add its own gating beyond the cooldowns.
- **Not a custom weather pack.** All 14 programs use vanilla Hytale
weather IDs (Zone1_Rain_Light, Zone3_Snow_Storm, Blood_Moon, etc.).
HAARP picks them, it doesn't define them.
- **No GUI menu** — the interface is chat-only, command-driven. With
Hytale Update 5's chat autocomplete, that's a faster experience
than it sounds.

## Compatibility

- **Hytale Update 4 and later** — wildcard `ServerVersion` declared,
stays current as Hytale ships future updates
- **Plays alongside other gameplay mods.** HAARP only writes to
Hytale's weather resource, doesn't touch worldgen, blocks, or
entities.
- **Fights with mods that also override weather.** If you run HAARP
alongside **Turning Seasons** (also mine), whichever calls the
weather API last wins. Practical impact: HAARP's manual override
takes precedence as long as you keep activating programs;
Turning Seasons takes back over once HAARP's program expires
and the next season transition hits. Not a bug, just a "they
share the same control surface" interaction.

If you're running other mods of mine, they're designed to feel
authored by the same hand:

- **Project Sakura** — a peaceful cherry-blossom fragment dimension
- **Turning Seasons** — automatic seasonal atmospheric variety
- **Structure Atlas** — passive discovery of generated structures

## Installation

1. Download `HAARP-3.0.3.jar`
2. Drop it into your Hytale Mods folder
(`%APPDATA%\Hytale\UserData\Mods\` on Windows)
3. Launch Hytale, create or load a world, and enable
**HAARP Weather Control** in the world's mod settings
4. In-game: type `/haarp` — the menu appears

No save state to migrate; HAARP's cooldowns are per-session and
in-memory.

## Roadmap

I update this mod when I have something real to add.

**Possible v3.1.0** *(under consideration)*
- Configurable cooldown durations
- Optional per-program permissions
- Custom HUD widget showing active program + remaining time

**Possible v4.0.0** *(speculative)*
- Custom weather definitions if Hytale exposes weather authoring
more deeply
- Scripted weather sequences ("hurricane intro for 30s, then
full storm for 5m, then clearing for 1m")

## A note from the author

HAARP started as a "I want a thunderstorm right now" tool and grew
into the menu it is today because each program I added kept feeling
useful enough to keep. If a program you'd want is missing, drop a
comment on this page — I read all of them.

— LordDionysus