KQ Outfit-Tasche 2.0

KQ Outfit Bag 2.0 - Portable Wardrobe System for FiveM

Give players complete clothing flexibility with this innovative portable outfit system. Drop a bag anywhere, access your saved outfits with a unique real-time preview interface, and change clothes on the fly without visiting clothing stores. Perfect for undercover operations, quick disguises, event outfit changes, or simply convenience in realistic roleplay scenarios.

What Makes KQ Outfit Bag Special

Unlike traditional clothing systems that force players to visit stores or wardrobes, KQ Outfit Bag 2.0 delivers portable clothing access with a unique preview system that shows exactly how outfits will look before applying:

• Unique Real-Time Preview System - See outfit changes live on your character before confirming - no surprises, no regrets
• Full & Partial Outfit Application - Apply complete outfit sets or cherry-pick individual clothing pieces (hat from one outfit, jacket from another)
• Flexible Interaction Methods - Choose between target system (ox_target, qb-target) or traditional 3D text prompts
• Fully Standalone Architecture - Core functionality works independently; framework integration is optional enhancement
• Automatic Bag Management - Forgotten bags automatically despawn after configured timeout to prevent world clutter
• Customizable UI Colors - Match interface colors to your server branding through simple config changes

Key Features

• Portable Outfit Storage - Carry your wardrobe in inventory, deploy bags anywhere for instant clothing access
• Real-Time Outfit Preview - Revolutionary preview system shows outfit changes on your character before applying
• Mix & Match Clothing - Apply complete outfits or select individual pieces from different saved looks
• Target System Support - Full ox_target and qb-target integration with optional 3D text fallback
• Framework Compatible - Usable items work with ESX and QBCore; core features work standalone
• Multi-Character Support - Properly handles outfit storage across multiple characters on same account
• Smart Despawn System - Automatically removes forgotten bags after configured time period
• UI Customization - Configure interface colors through config file without touching code
• Performance Optimized - Minimal resource usage even with multiple active bags in world

How It Works

Basic Usage Flow

1. Erhalte einen Outfit-Beutel: Erhalte einen Beutel-Item von einem Admin, einem Shop oder einem Starter-Pack
2. Deploye den Beutel: Verwende das Beutel-Item, um ein physisches Beutel-Prop an deinem Standort zu platzieren
3. Zugang zum Kleiderschrank: Interagiere mit dem Beutel über das Zielsystem oder die 3D-Text-Abfrage
4. Vorschau der Outfits: Durchsuche die gespeicherten Outfits mit Echtzeit-Vorschau auf deinem Charakter
5. Anwenden des Outfits: Wähle das komplette Outfit oder einzelne Kleidungsstücke
6. Packe den Beutel: Nimm den Beutel auf, um ihn zurück in deinen Inventar zu legen oder ihn für das automatische Despawnen liegen zu lassen

Erweiterte Funktionen

• Teilweises Anwenden des Outfits: Wähle bestimmte Kleidungsstücke (Hemd, Hose, Schuhe, Zubehör) aus verschiedenen gespeicherten Outfits
• Outfit-Verwaltung: Speichere neue Outfits direkt über die Beutel-Schnittstelle oder verwaltet sie über Kleiderläden
• Schneller Wechsel: Wechsle zwischen gespeicherten Outfits in Sekunden für Undercover-Arbeit oder Event-Teilnahme
• Beutel-Berechtigungen: Konfiguriere, wer die Beutel verwenden kann (alle Spieler, bestimmte Jobs, VIP-Stufen)

Ideal für

• Undercover Polizei - Wechsle schnell von der Uniform zu ziviler Kleidung für verdeckte Operationen
• Kriminelle Verkleidungen - Ändere die Outfits zwischen Verbrechen, um identifiziert zu werden
• Event-Teilnahme - Schnelle Outfit-Wechsel für Auto-Shows, Rennen, Partys, formelle Veranstaltungen
• Rollenspiel-Szenarien - Wechsle in Arbeitsuniformen, formelle Kleidung oder Freizeitkleidung kontextbezogen
• Mode-Enthusiasten - Zugang zu deinem gesamten Kleiderschrank ohne zu Kleiderläden zu reisen
• Modeling/Photography - Schneller Outfit-Wechsel für Mode-Shootings oder Werbeinhalte

Technische Spezifikationen

• Kernsystem: Vollständig standalone (kein Framework erforderlich)
• Framework-Unterstützung: ESX- und QBCore-verwendbare Items (optional)
• Zielsysteme: ox_target, qb-target, 3D-Text (konfigurierbar)
• Multi-Character: Outfit-Trennung pro Charakter unterstützt
• Leistung: 0,00-0,01 ms pro aktiver Beutel-Instanz
• UI-Framework: Benutzerdefiniertes NUI mit konfigurierbaren Farbschemata
• Beutel-Modell: Realistisches Duffel-Beutel-Prop mit richtiger Physik

Installation

1. Lade KQ Outfit Bag 2.0 von deiner FiveMX-Downloadseite herunter
2. Entpacke den Ressourcenordner in den ressourcen-Ordner
3. Konfiguriere die Einstellungen in config.lua:
   • Wähle das Interaktionsverfahren (Ziel vs. 3D-Text)
   • Setze den Beutel-Despawn-Timer
   • Konfiguriere die UI-Farben
   • Aktiviere die Framework-Integration, wenn ESX/QBCore verwendet wird
4. Füge das verwendbare Item deiner ESX/QBCore-Item-Datenbank hinzu
5. Füge ensure kq-outfit-bag zu server.cfg hinzu
6. Starte den Server und teste das Beutel-Deployment

Framework-Integration

ESX-Item-Konfiguration

Füge zu deiner ESX-Item-Datenbank hinzu:

INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
('outfit_bag', 'Outfit Beutel', 1, 0, 1);

QBCore-Item-Konfiguration

Füge zu qb-core/shared/items.lua hinzu:

['outfit_bag'] = {
    ['name'] = 'outfit_bag',
    ['label'] = 'Outfit Beutel',
    ['weight'] = 1000,
    ['type'] = 'item',
    ['image'] = 'outfit_bag.png',
    ['unique'] = false,
    ['useable'] = true,
    ['shouldClose'] = true,
    ['description'] = 'Tragbarer Kleiderschrank für Outfit-Wechsel'
}

Konfigurationsoptionen

• Interaktionssystem: Wähle Ziel (ox_target/qb-target) oder 3D-Text-Abfragen
• Despawn-Timer: Setze die automatische Beutel-Entfernung nach einer bestimmten Zeit (Standard: 10 Minuten)
• UI-Farben: Passe die primäre Farbe, die Akzentfarbe, die Textfarben über die Konfiguration an
• Vorschau-Geschwindigkeit: Passe die Aktualisierungsrate der Echtzeit-Vorschau an
• Berechtigungen: Konfiguriere Job-Einschränkungen oder mache sie für alle Spieler verfügbar
• Beutel-Grenzen: Setze die maximale Anzahl von Beuteln pro Spieler oder in der Welt

Was macht dieses System einzigartig

Das Echtzeit-Vorschau-System unterscheidet KQ Outfit Bag von anderen Kleidungsskripten. Statt Outfits blind anzuwenden und zu hoffen, dass sie richtig aussehen, sehen Spieler genau, wie jedes Outfit aussehen wird, bevor sie die Änderung bestätigen. In Kombination mit der teilweisen Outfit-Anwendung (mische Stücke aus verschiedenen gespeicherten Looks) schafft dies eine unerreichte Kleidungsflexibilität. Das automatische Despawn-Feature löst das gemeinsame Problem von vergessenen Beuteln, die die Welt verunreinigen, während die anpassbaren UI-Farben es den Servern ermöglichen, eine konsistente Branding über alle Schnittstellen hinweg aufrechtzuerhalten.

Verwendungsszenarien

Undercover-Detektiv: Der Beamte wechselt von der Polizeiuniform zu ziviler Kleidung an einem privaten Ort, bevor er verdächtige Kriminelle anspricht. Verwende die Vorschau, um sicherzustellen, dass das zivile Outfit natürlich aussieht.

Bankraub-Crew: Kriminelle wechseln nach dem Raub von Raubkleidung zu sauberer ziviler Kleidung. Jedes Crew-Mitglied entfaltet den Beutel in einem sicheren Haus, wechselt die Kleidung und entsorgt die Beutel.

Autoshow-Teilnehmer: Der Enthusiast kommt in legerer Kleidung, entfaltet den Outfit-Beutel auf dem Veranstaltungsgelände,