@Verified✅ 

# PH_DrivingSchool | Feature Overview

PH_DrivingSchool is a modern ESX/QB driving school built for servers that want more than a basic test marker.

It gives your players a full academy flow, clear progression, and practical exams that actually feel alive.

## Core Features

- Modern NUI theory exam with progress tracking, result screen, and responsive layout.

- Dedicated academy menu UI with license cards, prices, lock/completed states, and requirement hints.

- Live practical HUD (speed, speed limit, route progress, zone, grade, penalty points, focus alerts).

- Examiner-driven practical flow: walk to the exam vehicle, board, guide the route, and call out segments.

- Optional examiner voice callouts with text fallback.

- Dynamic route selection per license, with anti-repeat route picks between runs.

- License-specific checkpoint shaping, so each class feels different and not copy-pasted.

- Random focus segments with weighted penalties for stronger replay value.

- Per-license difficulty tuning (focus segment count, range, and penalty multiplier).

- End-of-test debrief with route name, runtime, grade, and fault breakdown.

## Licensing System (US Progression)

Includes a full progression roadmap from learner permit to advanced CDL endorsements:

- Learner Permit (`dmv`)

- Class C Driver License (`drive`)

- Class M Motorcycle License (`drive_bike`)

- CDL Class C (`drive_cdl_c`)

- CDL Class B (`drive_bus`)

- CDL Class A (`drive_truck`)

- CDL Passenger Endorsement (P) (`drive_passenger`)

- CDL School Bus Endorsement (S) (`drive_school_bus`)

- CDL Tanker Endorsement (N) (`drive_tanker`)

- CDL Hazmat Endorsement (H) (`drive_hazmat`)

- CDL Doubles/Triples Endorsement (T) (`drive_double_triple`)

- CDL Tanker + Hazmat Endorsement (X) (`drive_hazmat_tanker`)

## Gameplay & Balance Controls

- Penalty point system for speeding, collisions, and abandoning the exam vehicle.

- Theory retake cooldown to stop instant retry spam.

- Spawn safety with multiple fallback vehicle spawn points to reduce multiplayer conflicts.

- Optional trailer spawning/attachment support for licenses that need it.

- MPH or KM/H support (imperial/metric toggle).

## Integration & Compatibility

- Built for `es_extended` + `oxmysql`.

- Optional `ox_target` academy NPC interaction (with fallback marker/prompt flow).

- Notification system adapter:

  - Auto-select (`PH_Notify` -> `okokNotify` -> `ox_lib` -> ESX fallback)

  - Or force your preferred notify system.

- Optional PH_Licenses sync to auto-issue mapped license cards on pass.

- Own storage table: `ph_dmv_licenses`.

- Legacy migration/sync support with `user_licenses` for compatibility.

## Localization

- Locale-ready text system across UI, menus, labels, callouts, and question banks.

- Includes 13 locales out of the box:

  - `de`, `en`, `es`, `fi`, `fr`, `hu`, `it`, `nl`, `pl`, `sr`, `sv`, `tr`, `zh-cn`

## Why It Feels Better In-Game

Players don�t just click through a menu and get a pass/fail popup.

They move through a real academy loop with guided practical tests, route variety, meaningful scoring pressure, and a clear long-term license path.

That gives driving licenses actual value on your server instead of feeling like a one-time checklist.

Video Preview **SOON**