EXCLUSIVE RUST PLUGIN Rust Fireworks Show 1.0.7

Rust Fireworks Show​

Features​

Core Functionality​

• Two Independent Schedulers - Time-based shows (specific hours) + Automatic shows (fixed intervals)
• Random Colors - Each firework randomly selects from 5 vibrant colors (Champagne, Green, Blue, Violet, Red)
• Smart Spawn Placement - Spawn near players, at monuments, or fully random map locations
• Monument Support - 29 whitelisted safe, above-ground monuments (airfield, harbor, radtown, etc.)
• Flexible Positioning - Manual player location, specific coordinates, or automatic placement
• Loot Drops - Configurable probability and item quantities that fall from explosions
• Visual Feedback - Green map markers show show locations in real-time
• Dual Firing Modes - Cumulative staggered delays (natural) or independent random (chaotic)

Advanced Options​

• Water Detection - Prevent spawning in water bodies (optional)
• Time Window Support - Overnight time windows (e.g., 7:50 PM to 7:50 AM)
• Probability Control - Independent dice roll chances for each scheduler type
• Player Proximity - Shows can spawn around active players or completely random
• Grid References - Console logging with Rust map grid coordinates
• Server Time - Uses server game time (not local machine time)

Installation​

Installation Steps​

1. Download rFireworkShow.cs from the latest release
2. Place in your Rust server's oxide/plugins/ directory
3. Reload the plugin or restart your server
4. Configure settings in the generated oxide/config/rFireworksShow.json

Configuration​

Display & Effect Settings​

Automatic Show Settings​

Time-Based Show Settings​

Available Firework Colors​

Color	Prefab
Champagne	mortarchampagne.prefab
Green	mortargreen.prefab
Blue	mortarblue.prefab
Violet	mortarviolet.prefab
Red	mortarred.prefab

Commands​

Chat Commands​

/fs [count] - Manual Show Trigger​

Spawn fireworks at your player location
Requires: Admin
Optional: Firework count (default: config value)
Example: /fs 10 → Spawns 10 fireworks

/fs x y z [count] - Show at Coordinates​

Spawn fireworks at specific map coordinates
Requires: Admin
Example: /fs 1000 100 2000 15 → Spawns 15 fireworks at those coords

/fsrand - Random Show (Test Mode)​

Test automatic show behavior with random center point
Requires: Admin
Uses same logic as scheduled automatic shows
Picks random player proximity or random map location

/fsrand local - Show at Your Feet​

Spawn fireworks at your current location (for testing)
Requires: Admin
Useful for testing effects and positioning

/fsrand x y z - Random Show at Coordinates​

Spawn fireworks with show logic at specific coordinates
Requires: Admin
Example: /fsrand 1000 100 2000 → Random show at those coords

/fstoggle - Toggle Automatic Shows​

Enable/disable automatic scheduled shows on-the-fly
Requires: Admin
Toggles: AutomaticShowsEnabled setting
Messages: "automatic shows are now ENABLED" or "DISABLED"
Saves config and restarts scheduler

Console Commands​

rf.reload - Reload Configuration​

Reload plugin settings without restarting server
Usage: Can be run from server console or by admins in-game
Effect: Restarts show scheduler with new settings

Permissions​

How It Works​

Time-Based Shows​

1. Check Time Window - Continuously monitors if current time is between TimeBasedStartHour and TimeBasedShowEndHour
2. Wait Outside Window - If outside time range, scheduler pauses and checks again
3. Roll Dice Inside Window - When inside time window, rolls dice with TimeBasedShowsDiceRollChancePercent chance
4. Spawn Show - If dice succeeds, spawns show at configured location type
5. Repeat - Tries again every TimedShowIntervalMinSeconds to TimedShowIntervalMaxSeconds (randomized)

• Between 7:50 PM and 7:50 AM: attempts every 15-30 seconds with 75% success rate
• Between 7:50 AM and 7:50 PM: scheduler sleeps (no attempts)

Automatic Shows​

1. Check Players - If Minimum online players required to spawn a show is > 0, skips if online count is below threshold
2. Wait Interval - Pauses for AutomaticShowsIntervalMinSeconds to AutomaticShowsIntervalMaxSeconds (randomized)
3. Roll Dice - Rolls dice with AutomaticShowsDiceRollChancePercent chance
4. Spawn Show - If dice succeeds, spawns show at configured location type
5. Repeat - Cycle continues indefinitely

Spawn Location Logic​

1. Monument Spawning - If OnlySpawnAtMonuments is true, randomly picks one of 29 whitelisted monuments
2. Player Proximity - If SpawnAtRandomPlayersMapLocation is true, spawns near a random active player
3. Random Map - Falls back to random map location
4. Water Check - If OnlySpawnOnLand is true, validates location isn't in water (retries up to 40 times)
5. Final Fallback - Uses center of map if all else fails

Console Output​

Local Show[21.82]: Grid(R13) - Location(782.99, 51.10, 168.09) with 6 fireworks.[/FONT][/COLOR][/FONT][/FONT][/COLOR][/FONT][/FONT][/COLOR][/FONT][/FONT][/COLOR][/FONT]
[FONT=Mona Sans VF][COLOR=rgb(240, 246, 252)][FONT=Monaspace Neon][FONT=Mona Sans VF][COLOR=rgb(240, 246, 252)][FONT=Monaspace Neon][FONT=Mona Sans VF][COLOR=rgb(240, 246, 252)][FONT=Monaspace Neon][FONT=Mona Sans VF][COLOR=rgb(240, 246, 252)][FONT=Monaspace Neon]Random Show: Grid(H5) - Monument(Airfield) with 15 fireworks.
AutomaticShow: Grid(A1) - Location(50.00, 80.00, 120.00) with 3 fireworks.
TimeBasedShow[19.50]: Monument(Harbor) - Grid(M8) with 12 fireworks.

Format Breakdown​

• Grid calculations use Rust's MapHelper API for accuracy
• Times use server game time (TOD_Sky.Instance.Cycle.Hour) not local machine time
• Times match the in-game time shown to players for precise scheduling

Tips & Configuration Guide​

Loot Drop System​

• Each firework has an independent LootDropChance roll
• On success, randomly picks one item type from LootDropItems dictionary
• Rolls quantity between min/max for that item
• Loot spawns 200 feet above firework location and falls naturally to ground

Firing Modes​

• Fireworks fire with cumulative delays of 0.1-1.5 seconds between each
• Creates natural, chaotic rhythm (more realistic)
• Show duration varies based on cumulative delays
• Better for immersion and visual appeal

• Each firework fires with independent random delay (0-2 seconds)
• Creates unpredictable pattern
• All fireworks complete in ~2 seconds
• Better for rapid-fire effects

Monument Spawning​

• Large: airfield_1, excavator_1, launch_site_1, military_tunnel_1, powerplant_1, trainyard_1, water_treatment_plant_1
• Medium: bandit_town, compound, junkyard_1, nuclear_missile_silo, radtown_small_3
• Small: fishing_village_a/b/c, gas_station_1, harbor_1/2, lighthouse, mining_quarry_a/b/c, oilrig_1/2, satellite_dish, sphere_tank, stables_a/b, supermarket_1, warehouse
• Special: arctic_research_base_a, desert_military_base_a/b/c/d, ferry_terminal_1

• fishing_village_a, fishing_village_b, fishing_village_c (coastal villages)
• oilrig_1, oilrig_2 (oil platforms)
• During random spawning (/fsrand), water monuments have a 50% chance to be selected when enabled

Player Proximity Spawning​

• Randomly picks one active player
• Generates random angle around player (0-360°)
• Random distance from player (0 to PlayerSelectionRadius units)
• Creates shows near players for better engagement

Time Format​

• 7:50 PM to midnight ✓
• Midnight to 7:50 AM ✓

Support & Community​

• Discord Support - Join our community for help and discussions

Development & Testing Server​

• Server: Darktidia Solo Only | Monthly | 2x | 50% Upkeep | No BP Wipes
• Find Server: View on BattleMetrics