> For the complete documentation index, see [llms.txt](https://k0ssek-scripts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://k0ssek-scripts.gitbook.io/docs/scripts/halloween.md).

# Halloween

A Halloween event: a séance, the Phantom hunt, a cursed bear, trick or treat, a witch's cauldron and a Horror Director.

**kossek\_halloween** (The Curse) is a Halloween event for FiveM. Players summon **the Phantom** at an altar: a burning car with no driver that hunts one player, the one who carries **the Mark**. Everyone else it passes through like a ghost. The Marked player gets rid of the Mark by tackling someone else, and every pass wounds the Phantom, so the players beat it together.

Around the hunt: a cursed teddy bear that can only be given away, trick or treat at 349 houses, graves to dig, a witch's cauldron with a roulette and a server-wide goal, decorations, and an admin panel with a Horror Director.

Current version: **1.0.0**. What it contains is in the [Changelog](/docs/scripts/halloween/changelog.md).

## Features

| Feature                  | Details                                                                                                                                                                             |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **The séance**           | Players light candles at an altar; the last to light carries the Mark. The circle's size sets the Phantom's health and the loot tier. Vessels let small groups and one player play. |
| **The Phantom**          | A burning driverless car, or a burning rider, that charges the Marked player and knocks them down. No damage, no real explosions. A player or an admin can drive it.                |
| **The Witching Hour**    | City lights out and a red tint inside the hunt's zone, for its players only. Works with any weather script or none.                                                                 |
| **The cursed bear**      | It cannot be dropped, turns up near its holder, gets hungry, pays when another player accepts it, bites when it starves. A Book of the Bear at every grave.                         |
| **Trick or treat**       | 349 houses: knock at the front door (254) or wave at the letterbox. Two safe knocks a day, then the greedy get tricks.                                                              |
| **Graves**               | One safe dig a day, then a zombie for the greedy.                                                                                                                                   |
| **The witch's cauldron** | Bank candy, brew Cursed Pumpkins, the roulette, ash for a Relic, a shop, milestones, a dated trophy and the server's brew, with a notice board.                                     |
| **Fair rewards**         | Daily limits with diminishing returns per source, guaranteed milestones, safe and classic loot presets.                                                                             |
| **Horror Director**      | An admin panel that runs the night by hand.                                                                                                                                         |
| **In-game creators**     | Altars, vessels, graves, cauldrons and houses placed in game, with defaults on the standard map.                                                                                    |
| **Decorations**          | Pumpkins, gravestones, skeletons, ghosts and more placed with a live preview, seen by every player.                                                                                 |
| **Profiles**             | `casual`, `balanced`, `serious`, a `mundane` text set, and a scare switch for every player.                                                                                         |
| **Five custom props**    | The cauldron, the candy pail, the ritual circle, the notice board and the lectern.                                                                                                  |
| **Multi-framework**      | ESX, QBCore and QBX; six inventories; ox\_target, qb-target or keys; four weather bridges.                                                                                          |
| **Localization**         | English, Polish, German, French, Spanish, Italian, Czech, Swedish.                                                                                                                  |

## Editable files

These are not encrypted:

* `config/` - all settings, the default places and the 349 houses
* `bridge/` - framework, inventory, target and weather integrations
* `locales/` - every text players see
* `__INSTALL/` - the items for each inventory and their pictures

## Where to go next

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Installation</strong></td><td>Requirements, the five items, start order, admin access and the places to check.</td><td><a href="/docs/scripts/halloween/installation.md">Installation</a></td></tr><tr><td><strong>Gameplay</strong></td><td>What players do during the night, step by step.</td><td><a href="/docs/scripts/halloween/gameplay.md">Gameplay</a></td></tr><tr><td><strong>Admin Tools</strong></td><td>The admin panel, the Horror Director, the creators, decorations and the schedule.</td><td><a href="/docs/scripts/halloween/admin-tools.md">Admin Tools</a></td></tr><tr><td><strong>Configuration</strong></td><td>The config files and the options worth changing first.</td><td><a href="/docs/scripts/halloween/configuration.md">Configuration</a></td></tr><tr><td><strong>Compatibility</strong></td><td>Frameworks, inventories, targets, weather scripts and anti-cheats.</td><td><a href="/docs/scripts/halloween/compatibility.md">Compatibility</a></td></tr><tr><td><strong>Changelog</strong></td><td>What each version changed.</td><td><a href="/docs/scripts/halloween/changelog.md">Changelog</a></td></tr></tbody></table>

{% hint style="info" %}
Need some help? Create a ticket on our [Discord](https://discord.gg/eZN5ycvPVs).
{% endhint %}
