# 🎃 GhostDemon Trick-or-Treat System

### 💵 Price: $20.00 USD

Bring Halloween to your RedM server with a complete **Trick-or-Treat progression system** designed for VORP-based servers!

Players can travel from town to town, knock on configured doors, collect Halloween candy and rewards, earn XP, unlock new towns, encounter tricks, and compete against other players on a persistent Halloween leaderboard.

Whether you're running a seasonal Halloween event or want a reusable holiday activity for your community, **GhostDemon Trick-or-Treat** gives your players a fun progression-based activity to keep them exploring the county.

---

## 👻 FEATURES

### 🎃 Complete Trick-or-Treat System

Players can approach configured Halloween houses and press **G** to knock on the door.

Each interaction can result in:

🍬 Halloween rewards

💰 Money rewards

⭐ Trick-or-Treat XP

👻 A surprise "Trick"

🚪 Door cooldowns

🎃 Level progression

The system includes server-side validation to prevent players from simply triggering rewards from anywhere.

---

## ⭐ 9 LEVEL PROGRESSION SYSTEM

Players begin at **Level 1** and progress through **9 Halloween levels** by earning Trick-or-Treat XP.

Each level unlocks access to another town:

**Level 1** — Tumbleweed

**Level 2** — Armadillo

**Level 3** — Strawberry

**Level 4** — Van Horn

**Level 5** — Rhodes

**Level 6** — Annesburg

**Level 7** — Valentine

**Level 8** — Blackwater

**Level 9** — Saint Denis

Players must progress through the Halloween event to unlock access to additional towns.

This creates a natural progression system rather than allowing players to immediately access every location.

---

## 🏆 HALLOWEEN LEADERBOARD

A custom in-game NUI leaderboard allows players to see how they are performing against other Trick-or-Treaters.

The interface displays:

🥇 Player ranking

👤 Character name

⭐ Current level

✨ Total XP

📍 Current unlocked town

🎃 Halloween progression

👑 Top 3 medal placements

The leaderboard is designed specifically for the Halloween event and includes a custom dark, spooky visual style.

Players can easily open and close the interface with /trickortreat.

---

## 🍭 HALLOWEEN REWARDS

The resource includes a large collection of Halloween-themed reward items (30 custom items) with sql intagration and pngs sized for inventory .

Included reward item names include:

* Candy Corn

* Chocolate Bar

* Lollipop

* Gummy Worms

* Caramel Apple

* Pumpkin Candy

* Halloween Cookie

* Spooky Cupcake

* Candy Bag

* Ghost Cookie

* Witch Finger

* Bat Candy

* Skull Candy

* Pumpkin Cookie

* Blood Lollipop

* Monster Gummy

* Spider Candy

* Eyeball Candy

* Witch Chocolate

* Graveyard Gummy

* Ghost Pepper

* Pumpkin Spice

* Haunted Cookie

* Spooky Bottle

* Black Cat Candy

* Skeleton Candy

* Zombie Gummy

* Devil Candy

* Halloween Taffy

* Mystery Candy

The included SQL file contains the item definitions for the Halloween reward items (drag and drop).

---

## 💰 LEVEL-BASED MONEY REWARDS

Rewards become more valuable as players progress through the Halloween event.

The configured money ranges increase by level, with Level 1 starting at:

**$1–$3**

and progressing up to Level 9:

**$15–$30**

Money is awarded through the VORP character currency system. ALL editable in cofig.

---

## ✨ XP PROGRESSION

Players earns XP successful Trick-or-Treat interaction in their current progression town**.

The resource uses persistent XP and automatically calculates the player's level from their total XP.

Progress is stored in the database so players can leave the server and return later without losing their Halloween progression. (all editable in config)

---

## 👻 TRICK SYSTEM

Not every door is guaranteed to give a reward!

The system includes a configurable **Trick Chance**, currently configured at what ever you wish.

When a player gets tricked, they receive the Halloween trick outcome instead of the normal reward package.

The Trick system can be enabled or disabled through the configuration. 

---

## 💀 SPOOKY NPC ENCOUNTERS

The Trick system supports a configurable Halloween NPC encounter.

The included configuration allows you to customize:

* NPC model

* Spawn distance

* Health

* Despawn time

* Combat ability

* Combat movement

* Combat range

* Maximum chase distance

* Weapon configuration

This gives servers the ability to turn a simple Trick-or-Treat interaction into a more unpredictable Halloween experience.

---

## 🚪 DOOR COOLDOWN SYSTEM

Doors cannot simply be spammed repeatedly for unlimited rewards.

Each configured door has a player-specific cooldown.

The default cooldown is:

**5 minutes per door** (but can change to what you want in mil seconds)

Players can revisit doors after their cooldown expires. blip will disable and then reappear when door is available again.

Cooldowns are handled server-side and are also synchronized with the client for the player.

---

## 📍 100 CONFIGURED TRICK-OR-TREAT LOCATIONS

The included configuration contains **100 pre-configured Trick-or-Treat door locations** distributed throughout the RedM map.

Locations are assigned to progression towns and include locations in:

* Tumbleweed

* Armadillo

* Strawberry

* Van Horn

* Rhodes

* Annesburg

* Valentine

* Blackwater

* Saint Denis

Each location contains configurable:

📍 Coordinates

🧭 Heading

🏠 Interaction label

🏘️ Assigned town

🔒 Required progression level

You can add, remove, move, or modify locations directly through `config.lua`.

---

## 🗺️ HALLOWEEN BLIPS

Halloween house locations can be displayed using custom map blips.

The configuration allows you to control:

* Blip enabled/disabled

* Blip scale

* Blip label

The blips will disappear after you have knocked for the cooldown and reappear when cool down ends giving player a better understanding where they have been once you level up to the next town you stop getting xp from the past town only the new town will give xp. all blips are hidden until you unlock towns then will appear as you unlock each town tumbleweed is visible immediatly!

## 💾 PERSISTENT PLAYER PROGRESSION

Player Trick-or-Treat progression is stored using the included SQL database table.

Stored information includes:

* Character identifier

* Total XP

* Current level

* Creation timestamp

* Last update timestamp

Progress automatically synchronizes when the player loads into the server.

## 🎃 CONFIGURATION

---

# 📦 WHAT'S INCLUDED

Your purchase includes the complete resource package:

GhostDemon_TrickOrTreat/

│

├── client.lua

├── server.lua

├── config.lua

├── fxmanifest.lua

│

├── html/

│   ├── index.html

│   ├── app.js

│   └── style.css

│

└── SQL/

    └── sql.sql

```

The resource includes the client, server, configuration, NUI leaderboard interface, manifest, and SQL database setup.

---

# 🔧 REQUIREMENTS

This resource is designed for **RedM** and a **VORP-based server**.

### Required:

* VORP Core

* oxmysql

* BLN Notify

---

# 📥 INSTALLATION

### 1. Extract the resource

Place:

```text

GhostDemon_TrickOrTreat

```

inside your server's resources folder.

### 2. Import the SQL

Open:

```text

SQL/sql.sql

```

and import it into your server database.

This creates the Trick-or-Treat progression table and adds the included Halloween reward items.

DRAG N DROP PHOTOS IN TO THE INVENTORY SCRPT

### 4. Configure the resource

Open:

```text

config.lua

```

and customize the settings for your server.

### 5. Add the resource to server.cfg

Add:

```text

ensure GhostDemon_TrickOrTreat

```

after the required dependencies.

### 6. Restart your server

Players can then begin participating in the Halloween Trick-or-Treat event.

---

# ⚙️ EASY TO CUSTOMIZE

This resource was built with customization in mind.

Server owners can adjust the progression, rewards, towns, door locations, cooldowns, XP values, trick chance, NPC behavior, notifications, and leaderboard settings without needing to rebuild the resource.

---

# 🧟 PERFECT FOR

🎃 Halloween Events

👻 Seasonal Server Events

🍬 Community Activities

🏆 Server Leaderboards

⭐ Progression-Based Events

💀 Spooky RP Events

🤠 RedM Halloween Content

Give your players something fun to do while exploring the county during spooky season!

# 💵 PRICE

## 🎃 GhostDemon Trick-or-Treat

### **$20.00 USD**

A complete Halloween Trick-or-Treat event system with:

**100 locations • 9 progression levels • XP system • persistent database progression • town unlocking • random rewards • money rewards • trick system • spooky NPC encounters • Halloween leaderboard • blips • VORP inventory integration • configurable rewards • configurable locations**

---

### 👻 Bring Halloween to your county!

Let your citizens knock on doors, collect candy, earn XP, unlock new towns, chase the leaderboard, and find out whether their next door brings a **TRICK... or a TREAT!** 🎃🍬👻