# Supplies System

***

### 🚀 Overview

The Codex Supplies System introduces a **dynamic town resupply framework** designed for immersive roleplay servers.

Players with authorized roles (such as **Town Presidents**) manage supplies, coordinate deliveries, and control access to town resources through NPC interactions, prompts, and a custom UI.

The system integrates natively with CodexCore and supports:

* Town-based resource control
* Role-restricted interactions
* NPC-driven resupply points
* Real-time data synchronization

***

### 🔥 Key Features

#### 🌍 Dynamic Resupply System

Automatically manage and trigger resupply events per town based on player roles.

* Only authorized roles (e.g. Presidents, Governors) can manage resupplies
* Keeps town resources balanced and under player control
* Supports multiple towns with independent supply states

***

#### 👥 NPC & Blip Creation

Create and manage dedicated resupply NPCs and map blips:

* Place NPCs at custom coordinates
* Assign resupply roles per NPC
* Display blips for easy discovery

This ensures a realistic and functional resupply network across the map.

***

#### 🛠️ Interactive Prompts

Context-sensitive prompts allow players to interact naturally with resupply NPCs:

* Clean, non-intrusive UI
* Job-based access checks
* Intuitive key prompts for managing supplies

***

#### 💼 Job-Specific Interaction

Role-based access ensures controlled gameplay:

* Only specific jobs (e.g. Presidents) can manage supplies
* Prevents abuse or unauthorized access
* Reinforces roleplay hierarchy and responsibility

***

#### ⚙️ Developer Mode

Includes a built-in **Developer / Debug Mode**:

* Visualize NPC positions
* Inspect supply data in real time
* Test resupply mechanics safely

Perfect for server developers during setup and balancing.

***

#### 🎨 Custom UI Integration

Integrate a fully customizable NUI interface:

* Clean and readable town supply panels
* Live updates of stock and resupply status
* Fully skinnable to match your server theme

***

### 🔧 Additional Benefits

#### 🔧 Modular & Scalable

* Add unlimited towns
* Add new NPCs and resupply roles
* Extend mechanics with custom events

The system grows with your world.

***

#### 🔄 Seamless Integration

Designed to work natively with **CodexCore**:

* Uses CodexCore prompts, blips, jobs, and inventory
* No conflicts with existing Codex systems
* Easy plug-and-play installation

***

#### ⏱️ Real-Time Updates

All supply data updates live:

* Accurate town stock levels
* Instant UI refresh
* Synchronised between players and admins

***

#### 🎮 Enhanced Player Experience

Creates meaningful roleplay loops:

* Leadership roles gain responsibility
* Town economy feels alive
* Player actions visibly impact the world

***

### ⚡ Why Choose Codex Supplies?

#### 🔒 Full Control

Administrators can:

* Restrict access by job and rank
* Control who can trigger resupplies
* Secure town resources from abuse

***

#### 🌟 Professional-Grade System

Built to production standards:

* Optimized performance
* Stable networking
* Clean API integration

Designed for both serious roleplay servers and high-population environments.

***

#### 💡 Fully Customizable

Tailor every aspect:

* Job permissions
* Resupply logic
* NPC behavior
* UI layout

Make the system fit your server — not the other way around.

***

### 🏙️ Use Cases

Codex Supplies is ideal for:

* Town management systems
* Government / presidency roleplay
* Economy-driven servers
* Event-based resupply gameplay

Examples:

* Presidents ordering food and medicine for towns
* Supply convoys unlocking new shops
* Town shortages triggering missions and conflicts

***

### 🎯 Final Notes

Whether you're building a complex roleplay ecosystem or enhancing an existing RedM server, **Codex Supplies** provides:

* Immersive logistics gameplay
* Strong role-based control
* Seamless CodexCore integration

Elevate your RedM world with living towns, meaningful leadership roles, and a fully dynamic resupply system.