🌨️ Snow Effect Settings

The snow system has two parts:

1. Overlay (visual particles around players, with “pre-snow” bias in their look direction).
2. Ground placement (thin snow layers) with safety rules (roof respect, WG region blocklist, safe rings).

YAML Configuration

# ❄ Snow effect settings
snow:
  enabled: true
  apply-to-all-players: true        # auto-enable for everyone online
  keep-snow-on-disable: true        # keep thin layers when a player disables the effect
  radius: 24                        # horizontal radius around the player
  density: 40                       # particle burst per tick slice (visual only)
  duration: 0                       # 0 = infinite (seconds per player)
  no-snow-near-player-radius: 1.5   # safe ring around feet
  no-snow-near-entity-radius: 1.25  # avoid placing near interactables/Santa

  presnow:
    bias-front: true
    lookahead-factor: 0.66          # 0.0..2.0 how much to bias ahead

  # Ground placement rules
  respect-roof: true                # no ground snow if player under a ceiling
  blocked-wg-regions:               # particles still show here; only ground snow is blocked
    - santa_zone
    # - market
    # - spawn

Key Options

• enabled: master toggle for the system.
• apply-to-all-players: auto-on globally; set false to only allow opt-in via /snow me on.
• keep-snow-on-disable: if true, turning the system off won’t clean up existing thin layers.
• radius: horizontal effect radius around each player; increase carefully for performance.
• density: purely visual particle volume.
• duration: seconds per player; 0 = infinite.
• no-snow-near-player-radius: prevents placement right at feet (avoid “clip”/annoyance).
• no-snow-near-entity-radius: keeps interactables (e.g., villagers/Santa) clear.
• presnow.bias-front & lookahead-factor: bias overlay particles in the player’s facing direction (windlike feel).
• respect-roof: block ground placement when a solid ceiling is above the player.
• blocked-wg-regions: list of WorldGuard regions where ground snow is blocked (overlay still allowed).

Commands & Permissions

Tips

• Keep radius modest (16–32) for crowded hubs.
• Use blocked-wg-regions for markets/parkours to avoid grief-like layering.
• respect-roof improves immersion (no snow indoors).