## 📋 Overview

**CY-Jobcreator** is a fully-featured, all-in-one job creation and management system for **RedM** servers running **VORP Core**. Create, configure, and manage unlimited custom jobs **entirely in-game** — no code, no config editing, no restarts needed.

From a simple ranch to a full sheriff department with accounting, crafting, shops, and task boards — everything is set up through a beautiful **Western-themed NUI** in minutes.
---

## 🖼️ Preview

https://youtu.be/BwTrAx5jsGM

## ✨ Features at a Glance

| Feature | Description |

|---------|-------------|

| 🎨 **Western UI** | Fully styled NUI with saloon-inspired design, Cinzel fonts, and parchment aesthetics |

| 👔 **Job CRUD** | Create, edit, duplicate, and delete jobs with a tabbed interface |

| 📍 **8 Position Types** | Boss, Storage, Duty, Cloakroom, Vehicle, Horse, Shop, Crafting, Task Board |

| 🏆 **Unlimited Ranks** | Define as many ranks as you want, each with individual salary & permissions |

| 💰 **Salary System** | Fixed interval or worktime-based, with conditions (on-duty, in-zone, not AFK) |

| 🏦 **Company Accounts** | Deposit, withdraw, salary-from-account, full transaction history |

| 📦 **Job Storage** | Private or public stashes with per-rank withdraw/deposit permissions (VORP Inventory) |

| 🔨 **Crafting System** | In-game recipe manager, 30+ animations, grade restrictions, beautiful workbench UI |

| 🏪 **Shop System** | Employees stock items → customers buy via NPC menu, dynamic pricing |

| 📋 **Task System** | Boss creates tasks → employees accept & complete → boss verifies & pays out |

| 🐎 **Vehicles & Horses** | Per-job vehicle/horse lists, rank restrictions, auto-despawn on logout |

| 👕 **Cloakroom** | Saved outfit system for work uniforms |

| 👥 **Boss Menu** | Hire/fire, promote/demote, salary management, accounting, storage & task management |

| 🗺️ **Blip System** | Automatic map markers with customizable sprites and colors |

| 🌐 **Multilingual** | Full German & English localization out of the box |

| 🐛 **Debug System** | Toggle debug prints per-module via config |

---

## 🔨 Crafting System

The crafting system comes with a **redesigned two-panel Workbench UI**:

• 🔍 **Search bar** to filter recipes in real-time

• 📋 **Recipe sidebar** with cards showing result, craft time, and ingredient count

• 📄 **Detail panel** with ingredients list, result preview, and amount selector (+/−)

• ⏱️ **Standalone progress bar** with cancel option

• 🎭 **30+ crafting animations** (hammering, cooking, sawing, mining, farming, etc.)

• 🔒 **Grade-locked recipes** — restrict recipes to specific job ranks

• ✏️ **In-game Recipe Manager** — create, edit, and delete recipes without touching any files

---

## 🏪 Shop System

• Employees can place items from their inventory into a **shop display** with custom pricing

- Customers interact with the shop point and browse available items via VORP menu

- Dynamic pricing — each employee sets their own price per item

• Sales revenue goes to the **company account** (if enabled)

- Full buy/sell flow with quantity selection

---

## 📋 Task System

• **Boss creates tasks** via in-game popup (title, description, required item, reward)

• **Employees browse** the task board and accept available tasks

• **Mark as complete** when done — task goes to boss for **verification**

• **Boss verifies** and reward is paid out automatically

- Tasks can require specific items and amounts

---

## 👥 Boss Menu & Society System

The boss menu and duty toggle are combined into a **single interaction point**:

• Press **G** → Opens Boss Menu (manage employees, salary, accounting, storage, tasks)

• Press **F** → Toggle Duty (clock in/out)

• Boss menu modules are **individually toggleable** per job

• Only players at or above the configured **boss rank** can see the boss option

---

## 💰 Salary & Accounting

• **Fixed interval** or **worktime-based** payment

- Configurable conditions: only when on-duty, only in work zone, not when AFK

• **Company account** with deposit/withdraw and full transaction history

- Salary can be paid from the company account (realistic economy)

- Boss can manage salary rates per rank in-game

---

## 📦 Storage System

• Integrates with **VORP Inventory** custom inventories

• **Private** (employees only) or **Public** (shop display) modes

- Configurable storage size (in kg)

• **Per-rank permissions** for withdraw and deposit

- Auto-registers with VORP Inventory on job creation — no manual setup needed

---

## 🐎 Vehicles & Horses

• Define available vehicles and horses **per job** with labels

• **Rank restrictions** — lock certain vehicles to higher ranks

• Automatic **despawn on logout/disconnect**

- Spawn/store via interaction point with VORP menu

---

## 📍 Interaction Points

Set up to **8 different interaction points** per job, all configurable in-game:

| Point | Function |

|-------|----------|

| 🏢 Boss Menu | Society management (combined with duty toggle) |

| 📦 Storage | Open job stash |

| 👕 Cloakroom | Change into work outfit |

| 🚗 Vehicle Spawn | Spawn/store job vehicles |

| 🐎 Horse Spawn | Spawn/store job horses |

| 🏪 Shop | Employee shop display |

| 🔨 Crafting | Open workbench with recipe list |

| 📋 Task Board | Browse and accept tasks |

---

## 🛠️ Modules

Every feature is a **toggleable module** that can be enabled/disabled per job:

```

✅ Storage          ✅ Salary System     ✅ Applications

✅ Work Time        ✅ Tasks             ✅ Vehicles

✅ Horses           ✅ Shop              ✅ Crafting

✅ Cloakroom        ✅ Company Banking

```

---

## 🎮 Commands

| Command | Description |

|---------|-------------|

| `/jobcreator` | Opens the Job Creator admin UI |

| `/setjob [playerID] [jobID] [grade]` | Sets a player's job and grade |

| `/recipemanager [jobID]` | Opens the recipe manager for a job |

| `/joblist` | Lists all registered jobs |

| `/jobinfo [jobID]` | Shows detailed info about a job |

| `/editjob [jobID]` | Opens the UI to edit a specific job |

---

## 📝 Dependencies

| Resource | Required |

|----------|----------|

| [vorp_core](https://github.com/VORPCORE/vorp-core-lua) | ✅ Yes |

| [vorp_inventory](https://github.com/VORPCORE/vorp_inventory-lua) | ✅ Yes |

| [vorp_menu](https://github.com/VORPCORE/vorp_menu) | ✅ Yes |

| [oxmysql](https://github.com/overextended/oxmysql) | ✅ Yes |

---

## ⚙️ Configuration

Everything is configured via `config.lua`:

```lua

Config.Debug = false                    -- Toggle debug prints

Config.AdminGroups = { "admin", "superadmin", "owner" }

Config.Language = 'en'                  -- 'de' or 'en'

Config.InteractionDistance = 2.5        -- Prompt interaction range

Config.MarkerDistance = 10.0            -- Blip visibility range

Config.DefaultMaxEmployees = 10

Config.DefaultSalaryInterval = 30       -- minutes

Config.DefaultStorageSize = 100         -- kg

```

All UI labels, notifications, prompts, and menu texts are fully localizable in the locale tables.

---

## 💾 Database

The resource uses the following tables (auto-created):

| Table | Purpose |

|-------|---------|

| `job_registry` | Stores all job configurations as JSON |

| `job_shop_items` | Shop display items placed by employees |

| `job_accounts` | Company account balances |

| `job_transactions` | Full transaction history |

| `job_recipes` | Crafting recipes per job |

| `job_tasks` | Task board entries |

| `job_duty_log` | Duty clock-in/out history |

Compatible with **MySQL** and **MariaDB**.

---