# Overview

NOVA Framework premium scripts provide advanced functionality for a professional roleplay server. These scripts are located in the `resources/[nova]` folder and extend the framework with specialized systems.

## Scripts Summary

| Script                   | Description                                                      | Dependencies                              |
| ------------------------ | ---------------------------------------------------------------- | ----------------------------------------- |
| **nova\_admin**          | Admin panel — teleport, bans, items, vehicles, salary management | nova\_core, nova\_inventory               |
| **nova\_ambulancejob**   | Ambulance job — revive, heal, health check                       | nova\_core, nova\_target                  |
| **nova\_creator**        | Character creator — appearance, clothing, tattoos                | nova\_core                                |
| **nova\_dealership**     | Vehicle dealership — buy, test drive, rental                     | nova\_core, nova\_garage                  |
| **nova\_deathscreen**    | Death and respawn system                                         | nova\_core, nova\_notify                  |
| **nova\_fuel**           | Fuel system — gas stations, jerry can                            | nova\_core, nova\_notify                  |
| **nova\_grupos**         | Groups/gangs — organizations, roles, bank, stash, farms          | nova\_core                                |
| **nova\_interactions**   | Player/vehicle interactions — rob, loot, keys, trunk             | nova\_core, nova\_target, nova\_inventory |
| **nova\_loading**        | Custom loading screen                                            | —                                         |
| **nova\_mdt**            | Mobile Data Terminal for law enforcement                         | nova\_core                                |
| **nova\_multicharacter** | Advanced multicharacter — cinematic, music, effects              | nova\_core                                |
| **nova\_policejob**      | Police job — cuffs, escort, search, jail, fines                  | nova\_core, nova\_target, nova\_inventory |
| **nova\_radio**          | In-game radio with frequency channels                            | nova\_core, nova\_inventory, pma-voice    |
| **nova\_target**         | Raycast targeting system (third-eye)                             | —                                         |

{% hint style="danger" %}
**IMPORTANT — Replacing Free Scripts**

Some premium scripts **replace** their free equivalents. When you purchase a premium script, you **must remove** the corresponding free script from `[nova_scripts]` to avoid conflicts and duplication.
{% endhint %}

| Premium Script           | Replaces (Free)                       | Action Required                                                    |
| ------------------------ | ------------------------------------- | ------------------------------------------------------------------ |
| **nova\_multicharacter** | nova\_multichar                       | Remove `nova_multichar` from `[nova_scripts]`                      |
| **nova\_creator**        | Character creation in nova\_multichar | Remove `nova_multichar` (use nova\_multicharacter + nova\_creator) |

{% hint style="danger" %}
**Never run both the free and premium version of the same functionality at the same time.** This will cause conflicts, duplicated menus, and unexpected behavior.
{% endhint %}

## Installation

{% hint style="warning" %}
Premium scripts require the free scripts (especially `nova_core`) to be loaded first. Make sure `[nova_scripts]` is ensured before `[nova]` in your server.cfg.
{% endhint %}

### Step 1: Update `[nova_scripts]`

If you purchased scripts that **replace** free ones, remove the free versions first:

```
# Inside [nova_scripts] folder:
# ✅ KEEP these (always required):
#   nova_core, nova_bridge, nova_bank, nova_chat,
#   nova_garage, nova_hud, nova_inventory, nova_notify, nova_shops
#
# ❌ REMOVE these if you have the premium version:
#   nova_multichar  → replaced by nova_multicharacter + nova_creator
```

### Step 2: Add Premium Scripts

Add the premium scripts folder to your `server.cfg`:

```
# Free scripts first (always required)
ensure [nova_scripts]

# Premium scripts after
ensure [nova]
```

Or load individual scripts:

```
# Free scripts first
ensure [nova_scripts]

# Premium scripts
ensure nova_target
ensure nova_loading
ensure nova_multicharacter
ensure nova_creator
ensure nova_deathscreen
ensure nova_fuel
ensure nova_admin
ensure nova_interactions
ensure nova_policejob
ensure nova_ambulancejob
ensure nova_mdt
ensure nova_dealership
ensure nova_grupos
ensure nova_radio
```

## Load Order

```
[nova_scripts]    ← Free scripts (must load first)
│   nova_core            (ALWAYS required — never remove)
│   nova_bridge          (keep)
│   nova_bank            (keep)
│   nova_chat            (keep)
│   nova_garage          (keep)
│   nova_hud             (keep)
│   nova_inventory       (keep)
│   nova_notify          (keep)
│   nova_shops           (keep)
│   ❌ nova_multichar    (REMOVE if using nova_multicharacter)
│
└── [nova]               ← Premium scripts
      ├── nova_target          (standalone, no deps)
      ├── nova_loading         (standalone)
      ├── nova_multicharacter  (replaces nova_multichar)
      ├── nova_creator         (nova_core)
      ├── nova_deathscreen     (nova_core, nova_notify)
      ├── nova_fuel            (nova_core, nova_notify)
      ├── nova_admin           (nova_core, nova_inventory)
      ├── nova_interactions    (nova_core, nova_target, nova_inventory)
      ├── nova_policejob       (nova_core, nova_target, nova_inventory)
      ├── nova_ambulancejob    (nova_core, nova_target)
      ├── nova_mdt             (nova_core)
      ├── nova_dealership      (nova_core, nova_garage)
      ├── nova_grupos          (nova_core)
      └── nova_radio           (nova_core, nova_inventory, pma-voice)
```

## Additional Database Requirements

Some premium scripts require additional SQL tables. Check each script's documentation for specific SQL files that need to be executed.