Fireworks
A configurable firework catalogue — rockets, ground batteries and a hand-held launcher — plus an automatic show for your events.
- Version
- 1.2.2
- Resource
- SF-Fireworks
Overview#
Rockets
A trail climbing into the sky, then a burst at altitude.
Ground batteries
A prop is placed, the fuse crackles, then it goes off.
Hand-held launcher
Held in the hand with the arm raised. Aim with the mouse, click to fire, five shots, a random colour each time.
The launcher cannot hurt anyone
Whatever Config.Damage says. No explosion at all — particles and sound only, not even for the person firing.
Automatic show
/fireworkshow plays a full sequence at your position, timing and offsets included.
Forbidden zones
Hospital, prison, anywhere you decide fireworks have no business being.
Your own catalogue
Every firework declares its mode, its native effect, its colour, its size, its altitude and its fuse.
Five languages
French, English, Spanish, German and Italian, in files that stay editable after escrow.
Dependencies#
| Resource | Required | What for |
|---|---|---|
ox_lib | Required | Interface and shared helpers |
Installation#
- Drop
SF-Fireworksinto yourresourcesfolder. - Declare the items — see
ITEMS.md. - Add the line below to your
server.cfg, after ox_lib and your framework. - Check
Config.AdminGroupsso your staff reach the admin commands.
ensure ox_lib ensure SF-Fireworks
Configuration#
| Setting | Default | What it does |
|---|---|---|
Config.Fireworks | — | The catalogue: mode, effect, colour, size, altitude, fuse, prop |
Config.Launcher | — | Prop, hand position, animations, shot count, effects and colours |
Config.Trail | — | The rocket trail |
Config.Show.sequence | — | The show: which firework, what delay, what offset |
Config.ForbiddenZones | — | Where fireworks are refused |
Config.Cooldown | — | Delay between two launches |
Config.MaxSimultaneous | — | Ceiling on effects running at once |
Config.Damage | false | Makes rockets and batteries dangerous. Never affects the launcher. |
Commands#
| Command | What it does |
|---|---|
/fireworks | The menu of fireworks you own |
/launcher | Take out the hand-held launcher |
/fireworkshow | (admin) Play the full sequence at your position |
/sf_fireworks_giveitem | (admin) Give an item: <id|me> <item> <amount> |
/fwadjust | (Config.Debug) Place the prop in the hand with the mouse |
/sf_fireworks_debug | (console) Bridges and state |