Subscribe to download
Zens New Year Fireworks

This mod launches fireworks on New Years Eve at midnight. It's purely intended for server owners and is a server-side mod.

Technically it can spawn fireworks at any date/time, but the default config it generates will automatically set it for New Years.

You need to specify your timezone in the JSON config, and then when the clock strikes midnight at the specified date and time for your server then fireworks will spawn and launch near every player and/or every static location you specify in the config.

Yes, it will aggro zombies and give away player locations, so use at your own discretion and tweak the min/max spawn distance (or only enable static fireworks at certain locations).


This mod can be installed as a server-side only mod. Just install it server-side before New Years Eve and remove it afterwards.


When you run the server for the first time after this mod is installed it will automatically generate a JSON config file in your server profiles folder (server_root/profiles/Zenarchist/ZenNewYearsConfig.json)

Inside this JSON file you can configure the settings for the fireworks.

The timezone (day/month/hour/minute/second) is your server's local timezone. So for me, I set mine to December 31st 2024, hour 23 minute 59 second 55 to trigger fireworks to start launching at 5 seconds to midnight on New Years Eve of 2025.

You can also add any static positions you want to spawn fireworks (eg. trader zones, cities etc).

Here's a description of each setting:

Message: The text chat message to send to all players on the server.
TriggerDay: The day of the month to trigger (eg. 1 = 1st)
TriggerMonth: The month to trigger (eg. 1 = January)
TriggerYear: The year to trigger. The mod will automatically detect next year for this setting (eg. 2024 currently).
TriggerHour: The hour to trigger in 24hrs (eg. 0 = midnight)
TriggerMinute: The minute to trigger (eg. 0 = the first minute)
TriggerSecond: The second to trigger (eg. 55 = 5 seconds before next minute)
PlayerFireworksCount: How many fireworks to spawn on each player (will not spawn more than 1 cluster per nearby player)
MinFireworksDistance: Minimum distance in meters to spawn fireworks
MaxFireworksDistance: Maximum distance in meters to spawn fireworks
MinFireworksTime: Minimum delay for triggering fireworks effect
MaxFireworksTime: Maximum delay for triggering fireworks effect (in milliseconds)
StaticFireworksCount: How many fireworks to spawn at each static location
MinStaticFireworksDistance: Same as MinFireworksDistance but for static positions
MaxStaticFireworksDistance: Same as MaxFireworksDistance but for static positions
StaticFireworkSpawns: List of static spawn locations (eg. traders, cities etc - go wild)
SpawnObject: What type of fireworks to spawn. If you run the mod this year for 2024 it will spawn Anniversary fireworks, for any other year it'll be normal fireworks unless you override this setting.

To disable the text message sent to players, set Message to "".

To restrict the mod to only use static locations, set PlayerFireworksCount to zero.

To disable static locations, remove all entries from StaticFireworkSpawns.

I have no idea how many fireworks this game can handle so be careful if you set the Player/Static count to anything above 10.

The mod will automatically detect if fireworks are being launched close to each other, so if there are large groups of players near each other then only one cluster of fireworks will spawn for them.


You can repack this mod if you like, and do anything else you want with it for that matter. The source code is on my GitHub at www.zenarchist.com


All my mods are free and open source, but it takes an enormous amount of time to put some of these mods together. If I've helped you out, please consider helping me buy my next coffee! I don't expect it, but I very much appreciate it.

https://buymeacoffee.com/zenarchist

Enjoy!