UniqueFamily Docs
Scripts

How to use

Updated May 22, 2026

Verwendung

Das Script bietet neuen Spielern ein interaktives Willkommenssystem mit Starter-Belohnungen und einem optionalen City Guide.


Willkommens-NPC finden

Neue Spieler können den konfigurierten NPC auf der Karte finden.

Je nach Konfiguration:

  • wird ein Blip auf der Karte angezeigt
  • kann optional ein Marker sichtbar sein
  • kann über Target oder normale Interaktion interagiert werden

Willkommens-Geschenk abholen

Normale Interaktion

  1. Gehe zum NPC
  2. Drücke die angezeigte Taste (E)
  3. Das Geschenk-Menü öffnet sich

Target System

  1. Schaue den NPC an
  2. Nutze die ox_target oder qb-target Interaktion
  3. Klicke auf Willkommens-Geschenk abholen

Starter-Paket auswählen

Spieler können zwischen zwei Optionen wählen:

Ohne Stadt Guide

  • Starter-Items erhalten
  • Startgeld erhalten
  • Apartment erhalten
  • Belohnungen direkt bekommen

Mit Stadt Guide

  • Starter-Items erhalten
  • Startgeld erhalten
  • Leihfahrzeug erhalten
  • Interaktive Stadt-Tour starten
  • Bonusbelohnungen nach Abschluss erhalten

City Guide

Beim Start des City Guides:

  • erscheinen Checkpoints auf der Karte
  • wird automatisch ein Fahrzeug gespawnt
  • werden Blips und Wegpunkte gesetzt
  • wird der Fortschritt angezeigt

Beispiel:

Fortschritt: 3/11

Checkpoints besuchen

  1. Fahre zum markierten Ort
  2. Betrete den Checkpoint
  3. Interagiere mit dem Zielpunkt
  4. Das nächste Ziel wird automatisch gesetzt

Guide abschließen

Nach Abschluss des City Guides:

  • erhält der Spieler Bonusbelohnungen
  • kann das Fahrzeug dauerhaft übertragen werden
  • wird das Apartment automatisch vergeben
  • wird der Guide als abgeschlossen gespeichert
Spieler können den City Guide nur einmal abschließen.

Fahrzeug Besitz

Wenn aktiviert:

  • wird das Guide-Fahrzeug automatisch in die Garage übertragen
  • wird ein Kennzeichen generiert
  • erhält der Spieler Fahrzeugschlüssel

Apartment System

Wenn aktiviert:

  • erhält der Spieler automatisch ein Starter-Apartment
  • erfolgt die Zuweisung über das konfigurierte Property-System

Cooldown System

Das Script besitzt einen integrierten Cooldown:

  • verhindert Spam
  • verhindert mehrfaches Abholen
  • schützt vor Exploits

Wichtige Hinweise

  • Das Willkommens-Geschenk kann nur einmal abgeholt werden
  • Alle Belohnungen werden serverseitig überprüft
  • Fortschritte werden in der Datenbank gespeichert
  • Unterstützte Systeme werden automatisch erkannt

Alle NPCs, Belohnungen, Fahrzeuge und Checkpoints können vollständig über die config.lua angepasst werden.