HazardChaos

HazardChaos (PEAK) — v0.1.16

Spawns Dynamite, Tornado, Tumbleweed, and now Troublemaker entities (Zombies, Scoutmaster, Bees, Scorpions) dynamically near players. Optionally hands Tornado control to the game's AI, and shows per-type spawn timers.

Runs only in Level_* scenes (e.g., Level_1) — not in Airport/Title/Pretitle.

Features

Per-type schedulers

Independent intervals, TTLs, and caps for each hazard type.

Smart placement

Forward-cone from the chosen player anchor, ground raycast, collision checks; optional line-of-sight (LoS).

Multiplayer aware

• Only the MasterClient (host) performs spawns → all clients see them.
• Configurable anchor selection modes to decide whose vicinity to target.
• Optional capacity scaling per additional player.

Tornado AI hand-off

If the vanilla TornadoSpawner + RPCA_InitTornado path exists, the game's AI takes over; otherwise the mod's mover is used (reliable fallback with parent-drive).

Burst spawns

Configure how many Dynamite/Tumbleweed to spawn at once per tick.

Grace period

Optional protection window after level load before any timers start.

Overlay / Settings

• Compact overlay with independent timers (per hazard), live counts, and status (F9 toggle).
• In-game Settings window (F11) to edit config live; Save writes to.cfg.

Performance: Large scales & particles are GPU-heavy. Lower Scale/Radius or enable HardPause if FPS drops.

NEW in v0.1.15

Troublemaker Mode

A new game mode that spawns random hostile entities near players instead of environmental hazards.

Available Troublemaker Entities:

• Mushroom Zombie (1-2 per spawn)
• Spawns near player and wakes up immediately
• Configurable lifetime (30-300s)
• Spawn chance: 0-100%

• Scoutmaster
• Teleports 1-2 meters from player
• Note: May run away instead of chasing (vanilla AI behavior)
• Spawn chance: 0-100%

• Bee Swarm
• Spawns angry bees that chase players
• Configurable anger duration
• Spawn chance: 0-100%

• Scorpion (1-3 per spawn)
• Multiple scorpions spawn near player
• Automatically "woken up" to start moving
• Spawn chance: 0-100%

Game Modes (updated):

• Off — No spawns
• NormalOnly — Only environmental hazards (Dynamite, Tornado, Tumbleweed)
• ChallengeOnly — Only challenge events (Challenge Tornado/Tumbleweed)
• TroublemakerOnly — Only Troublemaker entities
• Both — Normal + Challenge
• All — Normal + Challenge + Troublemaker

Behavior:

• One random Troublemaker entity spawns per interval (configurable: 30-300s with jitter)
• Sequential spawn chance: If the first entity fails its spawn chance, the next enabled entity is tried (in random order) until something spawns
• Each entity type can be individually enabled/disabled
• Spawn distances configurable per entity type (closer than normal hazards for better engagement)

**Tunables (section Troublemaker.*):

• Interval / Random Jitter (global timing)
• Per-entity: Enabled, Spawn Chance (%), spawn distances, counts, lifetimes

How it behaves in multiplayer

• Only the MasterClient schedules/spawns.
• Spawn positions are chosen near an anchor (configurable):
• HostOnly | RandomPlayer | RoundRobin | NearestToHostCamera
• With Host proximity enabled, spawns that would land far away from the host are re-anchored to the host's vicinity.
• All players are affected by hazards; spectators are handled via the camera anchor.

Controls (Hotkeys)

| Hotkey | Action | Scope |

|--------|----------------------------------|-----------|

| F6 | Spawn Tornado near anchor | host only |

| F7 | Spawn Dynamite near anchor | host only |

| F8 | Spawn Tumbleweed near anchor | host only |

| F9 | Toggle overlay UI | local |

| F10 | Toggle version watermark | local |

| F11 | Toggle Settings window | host only |

Default Settings (from code)

Intervals (independent per type)

• Dynamite: 15 s
• Tornado: 90 s
• Tumbleweed: 12 s
• Troublemaker: 90 s

TTLs

• Dynamite: 10 s
• Tornado: 120 s
• Tumbleweed: 20 s

Caps (concurrency limits)

• Global: 6
• Dynamite: 2
• Tornado: 1
• Tumbleweed: 3

Burst counts