# Overview

The NOVA Framework includes a complete set of free scripts in the `[nova_scripts]` folder. These scripts provide all the core roleplay functionality needed to run a fully functional FiveM server.

## Scripts Summary

| Script              | Description                                                            | Dependencies                |
| ------------------- | ---------------------------------------------------------------------- | --------------------------- |
| **nova\_core**      | Core framework — player management, jobs, economy, callbacks, database | oxmysql                     |
| **nova\_bridge**    | Compatibility layer for ESX, QBCore, vRPex, Creative                   | nova\_core                  |
| **nova\_bank**      | Banking system — deposits, withdrawals, transfers, ATMs                | nova\_core                  |
| **nova\_chat**      | Styled chat with command system                                        | —                           |
| **nova\_garage**    | Vehicle storage, retrieval, and impound                                | nova\_core                  |
| **nova\_hud**       | HUD with health, armor, hunger, thirst, speedometer, progress bar      | nova\_core                  |
| **nova\_inventory** | Drag & drop inventory with weight system                               | nova\_core                  |
| **nova\_multichar** | Character selection and creation                                       | nova\_core                  |
| **nova\_notify**    | Toast notification system                                              | —                           |
| **nova\_shops**     | Clothing, barber, tattoo, and general stores                           | nova\_core, nova\_inventory |

## Installation Order

Scripts must be loaded in the correct order. The recommended load order in your `server.cfg`:

```
# 1. Dependencies
ensure oxmysql

# 2. Core framework (required by all other scripts)
ensure nova_core

# 3. Bridge (if using compatibility mode)
ensure nova_bridge

# 4. Notification system (no dependencies)
ensure nova_notify

# 5. Character selection
ensure nova_multichar

# 6. HUD & Chat
ensure nova_hud
ensure nova_chat

# 7. Inventory (required by shops)
ensure nova_inventory

# 8. Economy & Vehicles
ensure nova_bank
ensure nova_garage

# 9. Shops (depends on inventory)
ensure nova_shops
```

Or use the folder directly:

```
ensure [nova_scripts]
```

{% hint style="info" %}
When using the folder, ensure `nova_core` loads before other nova\_\* scripts. You can control this via alphabetical naming or explicit `ensure` ordering.
{% endhint %}

## Dependency Graph

```
oxmysql
  └── nova_core
        ├── nova_bridge
        ├── nova_notify (standalone, but used by most scripts)
        ├── nova_multichar
        ├── nova_hud
        ├── nova_chat
        ├── nova_inventory
        │   └── nova_shops
        ├── nova_bank
        └── nova_garage
```

## Database Requirements

Before running the framework, execute these SQL files:

1. **nova\_core/sql/nova.sql** — Core framework tables
2. **nova\_bank/sql/bank.sql** — Bank transactions table

## Upgrading to Premium

Some free scripts have premium equivalents with enhanced features. When you purchase a premium script, **remove the free version** to avoid duplication:

| Free Script         | Premium Replacement                          | What Changes                                                               |
| ------------------- | -------------------------------------------- | -------------------------------------------------------------------------- |
| **nova\_multichar** | **nova\_multicharacter** + **nova\_creator** | Basic character selection → cinematic multicharacter with advanced creator |

{% hint style="warning" %}
**Never run both versions at the same time.** Remove the free script from the `[nova_scripts]` folder before adding the premium version to `[nova]`.
{% endhint %}

Scripts like `nova_core`, `nova_inventory`, `nova_bank`, `nova_hud`, `nova_notify`, `nova_chat`, `nova_garage`, `nova_bridge`, and `nova_shops` are **always required** and have no premium replacements.

## Requirements

* **Lua 5.4** — All NOVA scripts require `lua54 'yes'` in fxmanifest
* **oxmysql** — Database operations
* **Node.js** — Not required for the framework itself, only for the Discord bot