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:

1. Mushroom Zombie (1-2 per spawn)

   • Spawns near player and wakes up immediately
   • Configurable lifetime (30-300s)
   • Spawn chance: 0-100%

2. Scoutmaster

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

3. Bee Swarm

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

4. 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)

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 (per tick)

• Dynamite: 2
• Tumbleweed: 3

Tornado fallback movement

• MoveSpeed: 10 m/s
• RetargetSeconds: 3.0 s

Challenge — Tumbleweed (defaults)

• Scale 4, SpeedMult 3, Retarget 1.5 s

Troublemaker (defaults)

• Interval: 90 s, Jitter: 20 s
• Zombie: 30% chance, 1-2 count, 120s lifetime, 5-12m spawn distance
• Scoutmaster: 15% chance, 60s chase time
• BeeSwarm: 25% chance, 20s anger time, 4-10m spawn distance
• Scorpion: 30% chance, 1-3 count, 3-8m spawn distance

Adjust any of the keys above to fit your session or server rules.