Mitch-Seasonal Effects Hub 22.2.0

Images now automatically added to install. No longer need to manually upload the images folder

This release introduces a long-requested feature: user-selectable seasonal effects, implemented in a way that is fully compatible with XenForo 2.3.x and safe for live boards.


🚀 New: User Seasonal Effects Settings

Users can now choose how seasonal visuals behave on their own account:

Holiday effects (ACP-controlled active holiday)
Weather overlay
Off (disable all seasonal visuals)

The setting is:
Stored per user
Persistent across sessions
Exportable with the add-on
Independent of custom profile fields

A new front-end settings page is available and linked directly from the Account Preferences sidebar.

🧠 Admin Control & Overrides

Admins retain full control:
The existing Automatic holiday selection master switch continues to act as a global override.
When automatic holiday selection is enabled, it may override user preferences (by design).
When disabled, user preferences apply cleanly.
This behavior is documented to avoid confusion.


🛠 Technical Notes
Uses a dedicated column on xf_user_option (no profile fields)
No edits to _output or PAGE_CONTAINER
No entity listeners
Fully compatible with XenForo 2.3.7
Template logic is cleanly gated to prevent effect “stickiness” when switching modes
Safe for live upgrades

🔄 Upgrade Notes
This is a drop-in update.
Existing installations will continue to behave exactly as before unless admins enable user choice.
No data loss, no schema conflicts.

Fixed missing template

This is one of the biggest upgrades yet — your forum now reacts to the time of day, the weather, and even the sky above.

✨ 🔥 NEW DAY / NIGHT SYSTEM — FULLY LIVE!
Your forum now changes personality depending on the time:


🌞 Day Mode Enhancements
Soft atmospheric tinting
New sun sprite with subtle animation
Optional daytime airplanes that fly across the screen (image-based, not CSS!)



🌙 Night Mode Enhancements
Beautiful animated moon glow effect
True starfield background with density control (Low / Medium / High)
Optional orbiting satellites that traverse the screen for a dynamic night sky
Night brightness control — adjust how dark nighttime should appear
Your community will literally see the forum “go to sleep” and “wake up” with the world.


🌦 Smarter Weather Effects
The weather overlay has been upgraded across the board:


☁️ Improved Condition Detection
Mist, haze, smoke, and similar conditions now intelligently switch to Clouds when cloud cover is high.
No more “always stuck on mist.”


🧊 More Realistic Visual Layers
Updated fog behavior
Improved cloud sprites
Smoother transitions between weather states



🔮 Mini Forecast Panel Enhanced
The forecast overlay at the top now displays cleaner condition labels and formatting.

❄️ Winter Snow Improvements
Snow accumulation system started (experimental)
Cleaner snow fade-in/out behavior
Upgraded snowflake animations

🛠 Under-the-Hood Improvements
Template cleanup & performance tweaks
Better handling of geolocation errors
Reduced overlay stacking to eliminate ghost elements


⭐ What’s Coming Next
More realistic snow-bank buildup
Melt cycle
Better shape-mapped snow at the bottom of the screen

Additional plane & satellite variations

Release Notes – Seasonal Effects Suite Update: Day/Night Mode + Weather Forecast Overlay

✅ Concise Version (Short + User-Friendly)

New Features

Automatic Day/Night Mode
Forum visuals now adapt to local time or real sunrise/sunset data from OpenWeather.
Includes smooth ambient lighting, moon/sun overlays, and configurable brightness levels.
Enhanced Night Environment
Added dynamic twinkling stars across the entire screen and optional moon image overlay.
Weather Forecast Overlay (NEW!)
The OpenWeather API now displays real weather conditions, temperature, and location directly on the forum.
Supports rain, snow, fog, clouds, and clear skies with matching animations + image sprites.

Improvements

Seasonal effects and weather effects now coexist seamlessly without visual overlap.
New admin options for brightness, color depth, and effect intensity.
Performance optimizations reduce CPU load across all animated overlays.

Fixes

Weather and holiday effects no longer override each other.
Adjusted brightness levels to prevent overly dark night mode.


🌟 Full Detailed Release Notes (Professional / Developer-Focused)

🎉 Major Feature Additions

🌗 1. Advanced Day/Night Mode

A brand-new system that adjusts the forum’s atmosphere based on:

Local system time
Automatic sunrise/sunset using OpenWeather
Manual override (Force Day / Force Night)

Features include:

Soft global tinting for both day & night.
Night sky populated with animated, randomized twinkling stars across the entire viewport.
Optional image-based moon and sun overlays replacing CSS shapes.
Fully integrated with all existing Seasonal & Weather overlays.
CSS brightness tuned to preserve forum readability while still giving an immersive night ambience.

🌤️ 2. Weather Forecast Overlay (Powered by OpenWeather API)

Users now see a small, elegant weather forecast label, showing:


Current temperature
City / location
Weather description (e.g., “Light Rain”, “Overcast Clouds”)

The overlay automatically syncs with the animated weather effects.

Supported conditions:

🌧️ Rain (CSS raindrops + image sprites)
❄️ Snow (CSS flakes + snowflake icons)
🌫️ Fog/Mist (CSS fog + optional fog icons)
☁️ Overcast/Cloudy (CSS drifting clouds + icon overlays)
☀️ Clear skies (sunburst effect + sun icon)

All conditions scale with the global Intensity Setting.

🛠️ Enhancements & Improvements
🌌 Night Mode Visual Upgrades

Expanded starfield now covers the entire viewport, not just upper header.
More natural star twinkling with randomized timing + variable brightness.
Reduced background darkening to improve content visibility.

⚙️ New Admin Options

Day/Night mode toggle & override
Brightness control for night shading
Enable/disable moon + sun image overlays
Custom star density selector
OpenWeather API style (CSS-only vs. image-enhanced overlays)

🚀 Performance Improvements

All overlays now use optimized DOM batching.
Reduced layout thrashing by consolidating animations.
Improved visibility checks to prevent off-screen animations from wasting resources.

🐞 Bug Fixes

Fixed issue where weather icons would not render if holiday effects were disabled.
Corrected layering so stars and weather effects no longer disappear behind XenForo UI elements.
Adjusted z-index relationships across all effect types for consistent behavior.
Fixed over-darkening of night mode on some themes.
Ensured fallback behavior when OpenWeather API returns errors.

📦 Developer Notes

Fully backwards compatible with all previous versions.
Template updated with new modular regions for easier overrides.
All star, moon, and sun overlays autogenerate on DOM load for max compatibility.
Weather forecast supports graceful failure messaging when API conditions are invalid.