CodeM Handels-Skript (ESX/QB)

CodeM Trading Script - Sicheres Spieler-zu-Spieler Item & Währungsaustausch System

CodeM Trading Script ermöglicht sicheren und intuitiven Spieler-zu-Spieler Handel auf deinem FiveM Server. Dieses umfassende Handelssystem bietet Echtzeit-Itemaustausch, Währungstransaktionen, doppelte Bestätigung, Anti-Scam-Schutz, Handelshistorie-Protokollierung, eine moderne UI-Oberfläche, Distanz-basierten Handel und vollständige Framework-Integration - wodurch ein sicherer Marktplatz entsteht, auf dem Spieler Items, Fahrzeuge und Geld direkt austauschen können, ohne Admin-Intervention oder riskanten Drop-Trading.

Was ist enthalten?

Dieses komplette Handelspaket beinhaltet eine sichere Handelsfenster-Oberfläche, die die Angebote beider Parteien anzeigt, Item-Austausch, der alle Inventar-Items mit Mengensteuerung unterstützt, Geldhandel mit konfigurierbaren Limits, ein doppeltes Bestätigungssystem, das die Zustimmung beider Spieler erfordert, Echtzeit-Handelsaktualisierungen, wenn Items hinzugefügt oder entfernt werden, Handelsabbruch, der es jeder Partei erlaubt, abzubrechen, Anti-Scam-Schutz, der Item-Duplizierung und Exploits verhindert, Handelshistorie-Tracking abgeschlossener Transaktionen, Distanz-basierter Handel, der physische Nähe erfordert, Timeout-Mechanismen, die unbegrenzt offene Trades verhindern, und umfassende Protokollierung zur Streitbeilegung.

Hauptmerkmale

• Sicheres Handelsfenster - Split-Screen-Oberfläche, die deine Angebote auf der einen Seite und die Angebote des Partners auf der anderen Seite mit klarer visueller Trennung anzeigt
• Item-Austausch - Handle alle Inventar-Items mit Mengenauswahl, Gewichtsüberprüfung und Metadaten-Erhaltung (Waffenaufsätze, Haltbarkeit usw.)
• Geldhandel - Tausche Bargeld neben Items mit konfigurierbaren Mindest-/Maximaltransaktionslimits und Schwarzgeld-Unterstützung (ESX)
• Doppelte Bestätigung - Beide Spieler müssen auf Akzeptieren klicken, bevor der Handel ausgeführt wird, um übereilte oder versehentliche Transaktionen zu verhindern
• Echtzeit-Updates - Das Handelsfenster wird sofort aktualisiert, wenn Items hinzugefügt/entfernt werden, und zeigt die aktuellen Angebote vor der endgültigen Bestätigung an
• Handelsabbruch - Jede Partei kann den Handel jederzeit vor der endgültigen Bestätigung abbrechen, wobei die Items automatisch zurückgegeben werden
• Anti-Duplizierungs-Schutz - Serverseitige Validierung verhindert Item-Duplizierungs-Exploits und Inventar-Manipulation
• Distanzanforderungen - Spieler müssen sich in konfigurierbarer Nähe befinden, um Trades zu initiieren und aufrechtzuerhalten, um Remote-Scam-Versuche zu verhindern
• Handelsanfragen - Sende Handelsanfragen an Spieler in der Nähe, die eine Benachrichtigung erhalten, die sie annehmen oder ablehnen können
• Handelshistorie - Vollständiges Protokoll aller abgeschlossenen Trades mit Zeitstempeln, ausgetauschten Items und Teilnehmern zur Streitbeilegung
• Timeout-System - Trades werden nach einem konfigurierbaren Inaktivitätszeitraum automatisch abgebrochen, um unbegrenzt hängende Trades zu verhindern
• Gewichtsüberprüfung - Überprüft, ob beide Spieler über ausreichend Inventarkapazität verfügen, bevor die Handelsausführung zugelassen wird
• Blacklist-System - Konfiguriere Items, die nicht gehandelt werden können (Admin-Tools, spezielle Items, Quest-Objekte)
• Handels-Cooldowns - Optionale Cooldown-Perioden zwischen Trades, um Spam-Trading oder Marktmanipulation zu verhindern
• Soundeffekte - Audio-Feedback für Handelsanfragen, Item-Hinzufügungen, Bestätigungen und Abschlüsse

Perfekt für

• Economy Server - Ermöglicht eine spielergesteuerte Wirtschaft mit direktem Item- und Währungsaustausch ohne NPC-Händler
• Roleplay Server - Unterstützt realistische Handelsszenarien wie Händler-Rollenspiele, Geschäftstransaktionen und persönliche Item-Verkäufe
• Survival Server - Essentiell für den Ressourcenhandel, den Ausrüstungsaustausch und die Zusammenarbeit in der Community
• Öffentliche Server - Verhindert Scamming durch Drop-Trading, indem ein sicherer, transparenter Austauschmechanismus bereitgestellt wird
• Whitelisted Communities - Erleichtert die Spielerinteraktion und den Handel in geschlossenen Communities
• Job Systeme - Unterstützt Geschäftstransaktionen wie den Kauf von Vorräten von Großhändlern oder den Verkauf von Produkten an Kunden

Trading Prozess Workflow

Handel initiieren: Ein Spieler nähert sich einem anderen Spieler (innerhalb eines konfigurierbaren Radius, typischerweise 3-5 Meter) und öffnet das Handelsmenü, indem er den Zielspieler auswählt. Das Ziel erhält eine Benachrichtigung mit dem Namen des Händlers und kann annehmen oder ablehnen. Nach der Annahme öffnet sich das Handelsfenster für beide Spieler gleichzeitig.

Angebote hinzufügen: Jeder Spieler fügt unabhängig voneinander Items aus seinem Inventar und/oder Geld zu seiner Seite des Handels hinzu. Wenn Items hinzugefügt werden, erscheinen sie in Echtzeit in den Handelsfenstern beider Spieler. Spieler können Items vor der endgültigen Bestätigung entfernen. Gewichtsüberprüfungen stellen sicher, dass der empfangende Spieler über Inventarplatz verfügt.

Bestätigungsphase: Wenn beide Spieler mit den Angeboten zufrieden sind, klickt jeder auf die Schaltfläche Akzeptieren. Die erste Annahme zeigt den Status "Warten auf anderen Spieler" an. Sobald beide akzeptieren, beginnt ein kurzer Countdown (3-5 Sekunden), der eine letzte Überprüfung ermöglicht. Jeder Spieler kann während des Countdowns noch abbrechen.

Handelsausführung: Nach dem Countdown werden Items und Geld gleichzeitig zwischen den Inventaren übertragen. Der Server validiert alle Übertragungen, um Duplizierung zu verhindern. Für beide Spieler erscheint eine Erfolgsmeldung. Das Handelsfenster schließt sich automatisch. Die Transaktion wird in der Historie protokolliert.

Abbruch: Jeder Spieler kann jederzeit vor dem endgültigen Countdown auf Abbrechen klicken. Alle angebotenen Items werden sofort an die ursprünglichen Besitzer zurückgegeben. Das Handelsfenster schließt sich mit einer Abbruchmeldung.

Anti-Scam-Schutz

Serverseitige Validierung: Alle Trades werden serverseitig mit Validierungsprüfungen ausgeführt, die sicherstellen, dass die Spieler tatsächlich die angebotenen Items besitzen, ausreichend Inventarplatz für den Empfang von Items vorhanden ist, die Geldbeträge korrekt und innerhalb der Limits liegen, Items während der Übertragung nicht dupliziert werden und Metadaten korrekt erhalten bleiben. Clientseitige Anzeigen werden anhand der Serverautorität verifiziert, um Manipulationen zu verhindern.

Bestätigungssystem: Die doppelte Bestätigung verhindert schnelle Switch-Scams, bei denen Händler in letzter Sekunde Angebote ändern. Der 3-5-Sekunden-Countdown nach der Annahme durch beide bietet eine letzte Überprüfungsmöglichkeit. Echtzeit-Updates zeigen genau, was jeder Spieler vor der Ausführung anbietet.

Distanzdurchsetzung: Trades werden automatisch abgebrochen, wenn sich Spieler während der Transaktion zu weit voneinander entfernen, um Situationen zu vermeiden, in denen ein Spieler während des Handels wegläuft. Die Näheprüfung wird während des gesamten Handelsprozesses kontinuierlich durchgeführt.

Handelsprotokollierung: Vollständige Transaktionsprotokolle ermöglichen es Admins, strittige Trades zu untersuchen, zu überprüfen, was ausgetauscht wurde, Scam-Versuche zu identifizieren und Konflikte mit Beweisen zu lösen. Die Protokolle enthalten Spieler-IDs, gehandelte Items, Mengen, Zeitstempel und den Handelsstatus (Erfolg/Abbruch).

Technische Spezifikationen

• Performance: ~0.015ms Serverauslastung, optimierte Inventaroperationen und Validierung
• Datenbank: Speichert die Handelshistorie mit Teilnehmerdaten, ausgetauschten Items und Transaktionszeitstempeln
• Inventarsysteme: Kompatibel mit ox_inventory, qb-inventory, qs-inventory, esx_inventory und benutzerdefinierten Lösungen
• UI Technologie: Moderne NUI-Oberfläche mit responsivem Design und Echtzeit-Synchronisation
• Sicherheit: Serverseitige Validierung aller Operationen zur Verhinderung von Exploits und Duplizierung
• Dateigröße: Ungefähr 6 MB einschließlich UI-Assets, Soundeffekte und Konfiguration

Installation

1. Lade das CodeM Trading Script-Paket aus deiner Kaufbestätigung herunter
2. Entpacke die Ressource in das Ressourcenverzeichnis deines Servers
3. Importiere die bereitgestellte SQL-Datei, um die Datenbanktabelle für die Handelshistorie zu erstellen
4. Konfiguriere die Framework-Einstellungen in config.lua (ESX/QBCore Erkennung)
5. Richte Handelsdistanzlimits, Bestätigungs-Timeouts und Cooldown-Perioden ein
6. Konfiguriere Geldtransferlimits und geblacklistete Items
7. Passe die UI-Farben und -Positionen an das Server-Theme an
8. Füge ensure codem-trading zu server.cfg hinzu
9. Starte den Server neu und teste den Handel zwischen zwei Spielern
10. Überprüfe, ob alle Items korrekt mit Metadaten-Erhaltung übertragen werden

Framework-Kompatibilität

• ✅ ESX Legacy - Volle Integration mit ESX Inventar-, Geldsystemen (Bargeld/Schwarzgeld) und Spielerdaten
• ✅ QBCore - Vollständige QB Unterstützung mit Inventar-Metadaten, Bargeldhandling und Spielerverwaltung
• ✅ QBOX - Kompatibel mit modernen QBOX Framework-Funktionen
• ✅ Standalone - Kann mit benutzerdefinierten Frameworks über eine Inventar-Bridge-Konfiguration betrieben werden

Konfigurationsoptionen

• Handelsdistanz: Lege die maximale Distanz zwischen Spielern fest, um Trades zu initiieren und aufrechtzuerhalten (Standard: 3-5 Meter)
• Bestätigungs-Timeout: Countdown-Dauer nach der Annahme durch beide vor der Ausführung (Standard: 3-5 Sekunden)
• Inaktivitäts-Timeout: Automatisches Abbrechen von Trades nach X Minuten Inaktivität (Standard: 2-5 Minuten)
• Geldlimits: Lege minimale und maximale Bargeldbeträge pro Trade fest, um Mikrotransaktionen oder übermäßige Überweisungen zu verhindern
• Handels-Cooldown: Erfordert X Sekunden zwischen aufeinanderfolgenden Trades pro Spieler (optional, verhindert Spam)
• Blacklisted Items: Definiere Items, die nicht gehandelt werden können (Admin-Tools, Quest-Items, Spezialwaffen)
• Soundeffekte: Aktiviere/deaktiviere Audio-Feedback und passe Sounddateien an
• UI-Anpassung: Passe Farben, Positionen, Transparenz und Styling an die Server-Ästhetik an

Handelshistorie & Protokollierung

Jeder abgeschlossene Trade wird mit umfassenden Informationen in der Datenbank protokolliert, einschließlich beider Spieler-IDs (Lizenz, Steam usw.), aller ausgetauschten Items mit Mengen, übertragener Geldbeträge, dem genauen Zeitstempel und dem Handelsstatus (Erfolg). Admins können die Handelshistorie abfragen, um verdächtige Aktivitäten zu untersuchen, Spielerstreitigkeiten über fehlende Items zu lösen, die Marktaktivität und beliebte Items zu verfolgen, potenzielle Exploits oder ungewöhnliche Muster zu identifizieren und Beweise für Ban-Einsprüche oder -Meldungen bereitzustellen.

Die optionale Discord Webhook-Integration sendet Echtzeit-Benachrichtigungen über hochwertige Trades (konfigurierbarer Schwellenwert), um Admins bei der Überwachung der Wirtschaft auf Manipulationen oder RMT-Versuche (Real Money Trading) zu unterstützen.

Integrationsmöglichkeiten

• Shop Scripts: Ladenbesitzer können Inventarbestände an ihre Shops handeln, anstatt Admin-Befehle zu verwenden
• Job Systeme: Erleichtere den Job-to-Job-Handel, z. B. Mechaniker, die Teile von Lieferanten kaufen, oder Köche, die Zutaten kaufen
• Gang Systeme: Gangmitglieder tauschen Waffen, Drogen oder Ressourcen innerhalb der Organisation aus
• Housing Scripts: Handle Möbel-Items, Hausschlüssel oder Hausdekorationen zwischen Spielern
• Vehicle Scripts: Tausche Fahrzeugbesitz über das Handelssystem aus (falls für die Unterstützung von Fahrzeug-Items konfiguriert)
• Crafting Systems: Spieler handeln Rohstoffe oder hergestellte Güter, um Produktionsketten zu unterstützen

Was es auszeichnet

CodeM Trading Script eliminiert die gefährliche Praxis des Drop-Trading, bei dem Spieler Items auf den Boden fallen lassen und hoffen, dass der andere Spieler bezahlt. Drop-Trading ist leicht auszunutzen - Spieler können mit Items weglaufen, Dritte können fallengelassene Items greifen oder Betrüger können behaupten, sie hätten die Ware nie erhalten. Dieses Skript bietet einen sicheren, transparenten, gleichzeitigen Austausch, bei dem niemand Items nehmen kann, ohne die vereinbarten Angebote zu machen. Die Echtzeit-Oberfläche zeigt genau, was jeder Spieler vor der Ausführung anbietet, um Bait-and-Switch-Betrug zu verhindern. Die doppelte Bestätigung mit Countdown verhindert übereilte Entscheidungen. Am wichtigsten ist, dass die serverseitige Validierung Exploits und Duplizierung unmöglich macht und eine vertrauenswürdige Handelsumgebung auch auf öffentlichen Servern schafft.

Wirtschaftliche Verbesserung

Sicheres Trading ermöglicht eine echte spielergesteuerte Wirtschaft, in der sich Spieler auf das Sammeln, Herstellen oder Weiterverkaufen spezialisieren und so eine Marktdynamik schaffen. Ressourcensammler verkaufen Rohstoffe an Handwerker, die fertige Produkte an Konsumenten verkaufen und so Lieferketten aufbauen. Die Preisfindung erfolgt auf natürliche Weise durch Verhandlungen und nicht durch feste NPC-Preise. Trading schafft soziale Interaktion - Spieler müssen kommunizieren, verhandeln und sich persönlich treffen, anstatt unpersönliche Auktionshäuser zu nutzen. Dies erzeugt organisches Rollenspiel und Community-Building.

Anwendungsbeispiele

Händler-Rollenspiel: Ein Spieler errichtet einen Marktstand und handelt mit Kunden über dieses System. Kunden durchsuchen das Inventar, verhandeln Preise und schließen sichere Trades ab. Der Händler verfolgt die Verkäufe über die Handelshistorie und verwaltet den Inventarumschlag.

Drogengeschäfte: Ein Krimineller verkauft Drogen über das Handelssystem an einen anderen Spieler. Beide Parteien bestätigen Mengen und Zahlung vor der Ausführung. Wenn die Polizei unterbricht, kann jeder den Handel sofort abbrechen. Keine fallengelassenen Beweismittel zum Sammeln.

Ausrüstungsverkäufe: Ein Mechaniker fertigt Fahrzeugteile und handelt sie an Kunden. Der Kunde bezahlt bar, erhält die Teile, die Transaktion ist abgeschlossen. Der Mechaniker hat einen Verkaufsnachweis in der Handelshistorie, falls der Kunde später Einwände erhebt.

Ressourcenhandel: Ein Bergmann verkauft Erz an einen Handwerker. Der Handwerker verarbeitet es zu Barren und verkauft es an einen Waffenschmied. Der Waffenschmied fertigt Waffen und verkauft sie an Gangmitglieder. Vollständige Produktionskette, die durch sicheres Trading ermöglicht wird.

Admin-Funktionen

Serveradministratoren haben spezielle Kontrollen, einschließlich der Anzeige der vollständigen Handelshistorie-Datenbank, der Suche nach Trades nach Spieler-ID, der Filterung nach Item-Typ oder -Wert, des Exports von Handelsprotokollen zur Analyse, der Identifizierung verdächtiger Handelsmuster und der optionalen Sperrung bestimmter Spieler vom Handel (Cooldown oder Blacklist). Das Admin-Panel bietet Einblicke in die Serverwirtschaft, einschließlich der am häufigsten gehandelten Items, der durchschnittlichen Transaktionswerte und der Handelsaktivität nach Tageszeit.

Support & Updates

Beinhaltet lebenslange Updates mit neuen Funktionen, Framework-Kompatibilitätsupdates, Sicherheitspatches und Bugfixes. Die umfassende Dokumentation behandelt Installation, Konfiguration, Inventarsystemintegration, Fehlerbehebung und Best Practices für das Wirtschaftsmanagement. Aktiver Support über das Ticket-System für technische Unterstützung und Anpassungshilfe. Regelmäßige Updates fügen von der Community gewünschte Funktionen wie Fahrzeughandel, Handelsvorlagen und erweiterte Filterung hinzu.

Verwandte ESX Scripts

• Marijuana Dope Plant Script
• FiveM Motel script
• ATM Robbery (C4 explosion, Drilling animation)
• Wais HUD V5 (ESX/QB)