UniqueFamily Docs
Scripts

Configuration

Updated May 22, 2026

Alle Einstellungen können in der config.lua Datei angepasst werden.


Allgemeine Einstellungen

Config.Framework = 'auto'
Config.Locale    = 'de'
Config.DarkMode  = true
Config.Debug     = false

Erklärung

  • Framework → Automatische oder manuelle Framework-Erkennung
  • Locale → Sprache der UI (de oder en)
  • DarkMode → Aktiviert das dunkle Design
  • Debug → Aktiviert Debug-Ausgaben in Konsole/F8

Target System

Config.Target = {
    enabled = true,
    system  = 'ox_target',
    icon    = 'fas fa-gift',
    label   = nil,
}

Erklärung

  • enabled → Aktiviert oder deaktiviert das Target-System
  • system → Unterstützt ox_target oder qb-target
  • icon → Icon der Interaktion
  • label → Eigener Text für die Interaktion (nil = automatisch aus Locale)
Wenn kein Target-System verwendet wird, nutzt das Script automatisch eine normale Interaktion.

NPC Einstellungen

Config.NPC = {
    model = 'a_m_m_business_01',
    coords = vector3(-1036.4225, -2731.7300, 20.1693),
    heading = 149.3820,
}

Erklärung

  • model → NPC Modell
  • coords → Position des NPCs
  • heading → Blickrichtung
  • scenario → NPC Animation
  • interactDistance → Interaktionsreichweite

NPC Blip

blip = {
    enabled = true,
    sprite  = 280,
    color   = 2,
    scale   = 0.8,
    name    = 'Willkommens-Geschenk',
}

Erklärung

  • Aktiviert einen Karten-Blip für den NPC
  • Vollständig anpassbar (Icon, Farbe, Größe und Name)

NPC Marker

marker = {
    enabled  = false,
    type     = 2,
}

Erklärung

  • Optionaler Marker über dem NPC
  • Farbe, Größe und Sichtweite anpassbar

Starter Items

Config.StarterItems = {
    {item = 'bread', amount = 10},
    {item = 'water', amount = 10},
}

Erklärung

  • Items, die neue Spieler beim ersten Abholen erhalten
  • Labels werden automatisch über das Framework oder ox_inventory geladen

Starter Geld

Config.StarterMoney = {
    enabled = true,
    amount  = 5000,
    account = 'money',
}

Erklärung

  • enabled → Aktiviert Startgeld
  • amount → Geldbetrag
  • account → Kontotyp (money, bank, black_money)

Starter Fahrzeuge

Config.StarterVehicles = {
    {model = 'tailgater', chance = 50},
    {model = 'fugitive',  chance = 50},
}

Erklärung

  • Zufällige Fahrzeugauswahl für den City Guide
  • chance definiert die Wahrscheinlichkeit
Die Gesamtwahrscheinlichkeit aller Fahrzeuge sollte zusammen 100 ergeben.

Fahrzeug Spawnpunkt

Config.VehicleSpawn = {
    coords  = vector3(-1034.5773, -2727.3464, 20.1685),
    heading = 240.9387,
}

Erklärung

  • Spawnposition für das City-Guide-Fahrzeug

Fahrzeugschlüssel

Config.VehicleKeys = {
    enabled = true,
}

Erklärung

  • Übergibt Spielern automatisch Fahrzeugschlüssel
  • Unterstützt eigene Key-Systeme über die GiveKey Funktion

City Guide Belohnungen

Config.CityGuideRewards = {
    vehicleOwnership = true,
    deleteVehicle    = true,
}

Erklärung

  • vehicleOwnership → Fahrzeug wird dauerhaft übertragen
  • deleteVehicle → Fahrzeug wird nach Abschluss despawnt

City Guide Checkpoints

Config.CityGuide = {
    {
        id = 1,
        name = 'Fahrschule',
        coords = vector3(...),
    },
}

Erklärung

  • Definiert alle Stationen des City Guides
  • Jede Station besitzt:
    • Namen
    • Beschreibung
    • Koordinaten
    • eigenen Blip
Du kannst unbegrenzt viele Checkpoints hinzufügen.

Garagen System

Config.GarageConfig = {
    enabled = true,
    type = 'vms_garagesv2',
}

Unterstützte Systeme

  • vms_garagesv2
  • esx
  • qb
  • custom

Erklärung

  • Überträgt das Fahrzeug nach dem Guide automatisch in die Garage
  • Unterstützt eigene Transfer-Funktionen

Kennzeichen Generierung

GeneratePlate = function()
    return 'NH ' .. math.random(10000, 99999)
end

Erklärung

  • Erstellt automatisch ein Kennzeichen
  • Vollständig anpassbar

Apartment System

Config.PropertyConfig = {
    enabled = true,
}

Erklärung

  • Gibt Spielern automatisch ein Starter-Apartment
  • Unterstützt eigene Property-Systeme über GivePropertyFunction

Benachrichtigungen

Config.Notify = {
    system = 'esx',
}

Unterstützte Systeme

  • esx
  • qb
  • custom

Erklärung

  • Unterstützt eigene Notification-Systeme
  • Eigene Client- und Server-Notifications möglich

Anti-Exploit Cooldown

Config.InteractionCooldown = 5

Erklärung

  • Cooldown zwischen Interaktionen in Sekunden
  • Verhindert Spam und Exploits
Ein zu niedriger Cooldown kann Spam oder unnötige Serverlast verursachen.