ds-santaclausevent

# ds-santaclausevent

QBCore/ESX Santa Claus event

## What it does

- Spawns an aggressive Santa Claus NPC at configurable locations and intervals.

- Adds an optional blip on the map when Santa Claus spawns.

- Rewards the player who kills Santa Claus (cash + optional item).

- Admin whitelist system to manually spawn Santa Claus.

- Cooldown system for auto-spawns with admin commands to enable/disable.

- Client notifications are framework-aware (supports QBCore, ESX, ox_lib, okokNotify, and chat fallback).

## Installation

1. Drop the `ds-santaclausevent` folder into your server's `resources/` directory.

2. Add `ensure ds-santaclausevent` to your `server.cfg`.

3. Restart your server.

## Admin Commands

- `/spawnsantaclaus` - Manually spawn Santa Claus (admin only)

- `/santa_check_admin` - Check if you are admin or not

- `/santa_cooldown_on` - Enable auto-spawn cooldown

- `/santa_cooldown_off` - Disable auto-spawn cooldown

- `/santa_cooldown_status` - Check the current cooldown status

## Configuration

- `Config.SantaClausModel` – Change to a custom Santa Claus ped model if desired.

- `Config.SpawnLocations` – Add/remove coordinates for Santa Claus spawn points.

- `Config.Despawn.Time` – Time in minutes before Santa Claus despawns automatically.

- `Config.Cooldown.Enabled` – Set to `true` to enable cooldown between auto-spawns.

- `Config.Cooldown.Time` – Cooldown duration in minutes.

- `Config.SantaClausStats` – Customize Santa's health, accuracy, combat behavior, and aggression.

- `Config.NotifySystem` – Force a notification system (`ox`, `okok`, `qb`, `esx`, or `chat`) or leave `"auto"` to detect automatically.

## Notes / Tips

- Make sure your admin Discord IDs are added in `Config.IsAdmin`.

- Client notifications now use a unified system via `ClientNotify()` for consistency.

- Works with both QBCore and ESX frameworks; standalone mode is also supported.