🎮 Nexon Roleplay — FiveM Script Collection

Moduláris, framework-független FiveM scriptek a Nexon Roleplay szerverhez.
Minden resource az nxn- előtagot használja, egységes dizájnrendszerrel és teljes export-kompatibilitással.

---

📦 Resourcek

🔧 Core

Resource	Leírás
nxn-database	Központi adatbázis-kezelő modul minden script számára
nxn-example	Boilerplate / sablon resource új scriptek készítéséhez

🖼️ UI / HUD

Resource	Leírás
nxn-loading	Betöltőképernyő és szerver-csatlakozás UI
nxn-notify	Értesítési rendszer — toastok, alertek, visszajelzések
nxn-hud	Fő HUD rendszer — élet, páncél, egyéb státusz indikátorok
nxn-minimap	Minimap testreszabás és kezelés
nxn-location-hud	Helyszín megjelenítő HUD elem (utcanév, kerület)
nxn-vehicle-hud	Jármű HUD — sebesség, üzemanyag, fordulatszám kijelzés

👤 Karakter & Identitás

Resource	Leírás
nxn-identity	Karakteridentitás kezelése (név, születési dátum, stb.)
nxn-needs	Karakter szükségletek rendszere (éhség, szomjúság, stb.)
nxn-licenses	Jogosítványok és engedélyek kezelése
nxn-inventory	Inventory / tárgykezelő rendszer
nxn-cityhall	Városháza rendszer — ügyintézés, iratok, karakterkezelés

💼 Munka & Foglalkoztatás

Resource	Leírás
nxn-job	Munkahelyek kezelése — foglalkozások, szerepkörök, besorolás
nxn-jobwork	Munkafeladatok rendszere — aktiválható munkafolyamatok
nxn-delivery	Kézbesítői munkakör rendszer
nxn-unemployment	Munkanélküli segély és állami támogatás kezelése

💰 Gazdaság & Kereskedelem

Resource	Leírás
nxn-finance	Pénzügyi rendszer — központi gazdasági logika
nxn-bank	Banki műveletek — számlakezelés, utalás, egyenleg
nxn-shop	Üzlet / bolt rendszer — termékek vásárlása és eladása
nxn-food	Étel és ital rendszer — fogyasztás, szükségletek kielégítése

🚗 Járművek

Resource	Leírás
nxn-vehicles	Jármű adatbázis és alapkezelés
nxn-vehicleshop	Jármű vásárlás — showroom, vétel, finanszírozás
nxn-garage	Garázsrendszer — jármű tárolás, ki- és beparkoltatás
nxn-keys	Járműkulcs rendszer — kulcsosztás, zár/nyit
nxn-trunk	Jármű csomagtartó — tárolt tárgyak kezelése
nxn-fuel	Üzemányag rendszer — fogyasztás, feltöltés logika
nxn-gasstation	Benzínkut interakció — feltöltés, fizetés
nxn-engine	Jármű motor kezelése — motor indítás, leállítás és állapot logika
nxn-seatbelt	Biztonsági öv rendszer — állapot nyilvántartás és logika
nxn-autoseatbelt	Automatikus biztonsági öv felcsatolása járműbe szállásnál
nxn-seatbelt-extras	Kiegészítők az nxn-seatbelt scripthez
nxn-antiwanted	Körözöttség (wanted level) automatikus kezelése és blokkolása

🔓 Bűnözés

Resource	Leírás
nxn-cartheft	Autólopás rendszer — jármű eltulajonítási mechanika
nxn-hotwire	Drótokosolás (hotwire) — jármű indítása kulcs nélkül

🌍 Világ

Resource	Leírás
nxn-signs	Közúti és egyéb táblák megjelenítése a világban
nxn-npcconversation	NPC párbeszéd és interakció rendszer

---

🏗️ Architektúra

• Framework-független — minden script önállóan működik, nem igényel ESX / QBCore integrációt
• Export-alapú kommunikáció — a resourcek egymás exportjain keresztül kommunikálnak
• Egységes dizájnrendszer — minden UI a közös dizájn-dokumentáció alapján épül fel
• Ikon-könyvtár: Huge Icons
• Minden resourcehoz tartozik konfigurációs fájl és HTML dokumentáció

---

🚀 Telepítés

1. Klónozd vagy töltsd le a repót
2. Másold a kívánt nxn-* mappákat a szervered resources/ könyvtárába
3. Add hozzá a resourceket a server.cfg fájlhoz az ajánlott sorrendben:

# Core
ensure nxn-database

# UI / HUD
ensure nxn-loading
ensure nxn-notify
ensure nxn-hud
ensure nxn-minimap
ensure nxn-location-hud
ensure nxn-vehicle-hud

# Karakter & Identitás
ensure nxn-identity
ensure nxn-needs
ensure nxn-licenses
ensure nxn-inventory
ensure nxn-cityhall

# Munka & Foglalkoztatás
ensure nxn-job
ensure nxn-jobwork
ensure nxn-delivery
ensure nxn-unemployment

# Gazdaság & Kereskedelem
ensure nxn-finance
ensure nxn-bank
ensure nxn-shop
ensure nxn-food

# Járművek
ensure nxn-vehicles
ensure nxn-vehicleshop
ensure nxn-garage
ensure nxn-keys
ensure nxn-trunk
ensure nxn-fuel
ensure nxn-gasstation
ensure nxn-engine
ensure nxn-seatbelt
ensure nxn-autoseatbelt
ensure nxn-seatbelt-extras
ensure nxn-antiwanted

# Bűnözés
ensure nxn-cartheft
ensure nxn-hotwire

# Világ
ensure nxn-signs
ensure nxn-npcconversation

⚠️ Az nxn-database resourcet mindig elsőként kell elindítani, mivel a többi script etől függ.

---

🛠️ Fejlesztés

Új resource létrehozásához használd az nxn-example boilerplate-et sablonként.
Minden új scriptnek meg kell felelnie a következő követelményeknek:

• nxn- előtag a resource nevében
• Saját config.lua konfigurációs fájl
• Export funkciók más resourcek számára
• HTML dokumentáció a dizájn-dokumentáció stílusában
• Kompatibilitás a többi nxn-* scripttel

Részletek a hozzájárulási útmutatóban és a magatartási kódexben.

A dizájnrendszer részletei a design-guide.html fájlban találhatók.

---

📄 Licensz

Ez a projekt GNU General Public License v3 alatt került kiadásra. Lásd: LICENSE.

---

Nexon Roleplay · FiveM Roleplay Server · Made with ❤️ in Hungary