CodeM-Handelsskript (ESX/QB)

CodeM Trading Script – Sicheres System für den Tausch von Gegenständen und Währungen zwischen Spielern

Der CodeM Trading Script ermöglicht sicheres und intuitives Spieler-zu-Spieler-Handeln auf deinem FiveM-Server. Dieses umfassende Handelssystem bietet Echtzeit-Artikel-Austausch, Währungsgeschäfte, doppelte Bestätigungspflicht, Anti-Betrug-Schutz, Handelsverlaufsprotokollierung, modernes UI-Interface, distanzbasierten Handel und vollständige Framework-Integration – und schafft so einen sicheren Marktplatz, auf dem Spieler Artikel, Fahrzeuge und Geld direkt austauschen können, ohne dass ein Admin eingreifen oder riskante Drop-Trades durchgeführt werden müssen.

Im Leistungsumfang enthalten

Dieses Komplettpaket für den Handel beinhaltet eine sichere Handelsfenster-Oberfläche, die die Angebote beider Parteien anzeigt, einen Gegenstandstausch, der alle Inventargegenstände mit Mengensteuerung unterstützt, Geldhandel mit konfigurierbaren Limits, ein Zwei-Faktor-Authentifizierungssystem, das die Annahme durch beide Spieler erfordert, Echtzeit-Aktualisierungen des Handels, sobald Gegenstände hinzugefügt oder entfernt werden, die Möglichkeit, den Handel abzubrechen, sodass jede Partei dies tun kann, Schutzmaßnahmen gegen Betrug, die die Duplizierung von Gegenständen und Exploits verhindern, eine Handelshistorie zur Verfolgung abgeschlossener Transaktionen, distanzbasierten Handel, der physische Nähe erfordert, Timeout-Mechanismen, die unbegrenzt offene Handelsgeschäfte verhindern, und eine umfassende Protokollierung zur Streitbeilegung.

Hauptmerkmale

• Sicheres Handelsfenster – Geteilte Bildschirmansicht, die deine Angebote auf einer Seite und die Angebote deines Partners auf der anderen Seite mit klarer visueller Trennung zeigt
• Artikeltausch – Handel mit beliebigen Inventargegenständen unter Berücksichtigung von Mengenauswahl, Gewichtsprüfung und Metadatenerhaltung (Waffenaufsätze, Haltbarkeit usw.).
• Geldhandel – Bargeld kann zusammen mit Artikeln umgetauscht werden, wobei Mindest-/Höchsttransaktionslimits und Schwarzgeldunterstützung vorhanden sind (ESX)
• Doppelte Bestätigung – Beide Spieler müssen auf „Akzeptieren“ klicken, bevor der Handel ausgeführt wird, um überstürzte oder versehentliche Transaktionen zu verhindern.
• Echtzeit-Updates – Das Handelsfenster aktualisiert sich sofort, wenn Artikel hinzugefügt oder entfernt werden, und zeigt das aktuelle Angebot vor der endgültigen Bestätigung an.
• Stornierung des Handels – Beide Parteien können den Handel jederzeit vor der endgültigen Bestätigung stornieren; die Ware wird automatisch zurückgesendet.
• Kopierschutz – Serverseitige Validierung verhindert Manipulationen durch Duplizierung von Artikeln und Inventarmanipulation
• Abstandsanforderungen – Die Spieler müssen sich in einem konfigurierbaren Umkreis befinden, um Transaktionen zu initiieren und aufrechtzuerhalten, um Betrugsversuche aus der Ferne zu verhindern.
• Handelsanfragen – Sende Handelsanfragen an Spieler in der Nähe und zeige ihnen an, dass sie diese annehmen oder ablehnen können.
• Handelsgeschichte – Vollständiges Protokoll aller abgeschlossenen Transaktionen mit Zeitstempeln, ausgetauschten Artikeln und Teilnehmern zur Streitbeilegung
• Timeout-System – Trades werden nach einer konfigurierbaren Inaktivitätsperiode automatisch abgebrochen, wodurch unbegrenzt hängende Trades verhindert werden.
• Gewichtsprüfung – Überprüft, ob beide Spieler über ausreichend Inventarkapazität verfügen, bevor der Handel zugelassen wird.
• Blacklist-System – Konfiguriere Artikel, die nicht gehandelt werden können (Admin-Tools, spezielle Artikel, Quest-Objekte)
• Handelsabklingzeiten – Optionale Abkühlphasen zwischen den Trades zur Verhinderung von Spam-Trading oder Marktmanipulation
• Soundeffekte – Audio-Feedback für Handelsanfragen, Artikel-Hinzufügungen, Bestätigungen und Abschlüsse

Perfekt für

• Economy-Server – Ermöglicht eine spielergesteuerte Wirtschaft mit direktem Gegenstands- und Währungstausch ohne NPC-Händler.
• Rollenspielserver – Unterstützt realistische Handelsszenarien wie Händler-Rollenspiele, Geschäftstransaktionen und den Verkauf persönlicher Gegenstände.
• Survival-Server – Unerlässlich für den Rohstoffhandel, den Ausrüstungstausch und die Zusammenarbeit in der Gemeinschaft.
• Öffentliche Server – Verhindert Betrug durch Drop-Trading durch einen sicheren und transparenten Handelsmechanismus
• Auf die Whitelist gesetzte Gemeinschaften – Ermöglicht die Interaktion und den Handel zwischen Spielern in geschlossenen Gemeinschaften.
• Arbeit Systeme – Unterstützt Geschäftstransaktionen wie den Einkauf von Waren bei Großhändlern oder den Verkauf von Produkten an Kunden

Handelsprozess-Workflow

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

Angebotserweiterung: Jeder Spieler fügt unabhängig Gegenstände aus seinem Inventar und/oder Geld zu seinem Handelsangebot hinzu. Die hinzugefügten Gegenstände erscheinen in Echtzeit in den Handelsfenstern beider Spieler. Spieler können Gegenstände vor der endgültigen Bestätigung entfernen. Gewichtsprüfungen stellen sicher, dass der empfangende Spieler über ausreichend Inventarplatz verfügt.

Bestätigungsphase: Wenn beide Spieler mit den Angeboten zufrieden sind, klicken sie jeweils auf „Annehmen“. Bei der ersten Annahme wird der Status „Warten auf anderen Spieler“ angezeigt. Sobald beide angenommen haben, startet ein kurzer Countdown (3–5 Sekunden) zur finalen Überprüfung. Jeder Spieler kann den Vorgang während des Countdowns noch abbrechen.

Handelsausführung: Nach Ablauf des Countdowns werden Gegenstände und Geld gleichzeitig zwischen den Inventaren transferiert. Der Server prüft alle Transfers, um Duplikate zu verhindern. Beide Spieler erhalten eine Erfolgsmeldung. Das Handelsfenster schließt sich automatisch. Die Transaktion wird im Verlauf protokolliert.

Stornierung: Beide Spieler können jederzeit vor Ablauf des Countdowns auf „Abbrechen“ klicken. Alle angebotenen Gegenstände gehen sofort an ihre ursprünglichen Besitzer zurück. Das Handelsfenster schließt sich mit der Abbruchbenachrichtigung.

Betrugsschutz

Serverseitige Validierung: Alle Transaktionen werden serverseitig mit Validierungsprüfungen durchgeführt, um sicherzustellen, dass die Spieler die angebotenen Gegenstände tatsächlich besitzen, ausreichend Inventarplatz für den Empfang der Gegenstände vorhanden ist, die Geldbeträge korrekt und innerhalb der Grenzen liegen, Gegenstände während der Übertragung nicht dupliziert werden und die Metadaten korrekt erhalten bleiben. Clientseitige Anzeigen werden mit den Servereinstellungen abgeglichen, um Manipulationen zu verhindern.

Bestätigungssystem: Die doppelte Bestätigungspflicht verhindert Betrugsversuche, bei denen Händler ihre Angebote in letzter Sekunde ändern. Der 3- bis 5-sekündige Countdown nach beidseitiger Annahme bietet die Möglichkeit zur abschließenden Überprüfung. Echtzeit-Updates zeigen genau an, was jeder Teilnehmer vor der Ausführung anbietet.

Abstandskontrolle: Der Handel wird automatisch abgebrochen, wenn sich die Spieler während der Transaktion zu weit voneinander entfernen. Dadurch wird verhindert, dass ein Spieler während des Handels flieht. Die Näheprüfung läuft während des gesamten Handelsvorgangs kontinuierlich.

Handelsprotokollierung: Vollständige Transaktionsprotokolle ermöglichen es Administratoren, strittige Transaktionen zu untersuchen, die ausgetauschten Gegenstände zu überprüfen, Betrugsversuche zu erkennen und Konflikte anhand von Beweisen beizulegen. Die Protokolle enthalten Spielerkennungen, gehandelte Gegenstände, Mengen, Zeitstempel und den Status (erfolgreich/storniert).

Technische Spezifikationen

• Leistung: Serverauswirkungen von ca. 0,015 ms, optimierte Bestandsverwaltung und Validierung
• Datenbank: Speichert die Handelshistorie mit Teilnehmerdaten, getauschten Artikeln und Transaktionszeitstempeln
• Inventarsysteme: Kompatibel mit ox_inventory, qb-inventory, qs-inventory, esx_inventory und kundenspezifischen Lösungen
• UI-Technologie: Moderne NUI-Oberfläche mit responsivem Design und Echtzeitsynchronisation
• Sicherheit: Serverseitige Validierung aller Operationen zur Verhinderung von Exploits und Duplikaten
• Dateigröße: Ungefähr 6 MB inklusive UI-Elemente, Soundeffekte und Konfiguration

Installation

1. Lade das CodeM Trading Script-Paket von deiner Kaufbestätigung herunter
2. Entpacke die Ressource in das Verzeichnis "resources" deines Servers
3. Importiere die bereitgestellte SQL-Datei, um die Trade-History-Datenbanktabelle zu erstellen
4. Konfiguriere die Framework-Einstellungen in config.lua (ESX/Abonnieren Detektion)
5. Richte Handelsentfernungsobergrenzen, Bestätigungszeitlimits und Abklingzeiten ein
6. Konfiguriere Geldtransferlimits und gesperrte Artikel
7. Passe UI-Farben und -Positionen an, um sie an das Server-Theme anzupassen
8. Hinzufügen Codem-Handel sicherstellen zu server.cfg
9. Server neu starten und Handel zwischen zwei Spielern testen
10. Überprüfe, ob alle Artikel mit Metadaten-Erhaltung korrekt übertragen werden

Framework-Kompatibilität

• ✅ ESX-Vermächtnis – Vollständige Integration mit ESX-Inventar, Geldsystemen (Bargeld/Schwarzgeld) und Spielerdaten
• ✅ Abonnieren – Umfassende QB-Unterstützung mit Inventarmetadaten, Bargeldabwicklung und Spielerverwaltung
• ✅ QBOX – Kompatibel mit modernen QBOX-Framework-Funktionen
• ✅ Standalone – Kann über die Konfiguration der Inventarbrücke mit benutzerdefinierten Frameworks arbeiten.

Konfigurationsoptionen

• Handelsdistanz: Maximalen Abstand zwischen Spielern festlegen, um Handelsvorgänge zu initiieren und aufrechtzuerhalten (Standard: 3-5 Meter).
• Bestätigungszeitüberschreitung: Countdown-Dauer nach beidseitiger Bestätigung vor der Ausführung (Standard: 3-5 Sekunden)
• Inaktivitäts-Timeout: Automatische Stornierung von Transaktionen nach X Minuten ohne Aktivität (Standard: 2-5 Minuten).
• Geldlimits: Festlegung von Mindest- und Höchstbeträgen pro Transaktion, um Mikrotransaktionen oder übermäßige Überweisungen zu verhindern.
• Handelsabklingzeit: Wartezeit von X Sekunden zwischen aufeinanderfolgenden Trades pro Spieler festlegen (optional, verhindert Spam).
• Auf der schwarzen Liste stehenden Artikel: Definiere Gegenstände, die nicht gehandelt werden können (Verwaltungswerkzeuge, Questgegenstände, Spezialwaffen).
• Soundeffekte: Audio-Feedback aktivieren/deaktivieren und Audiodateien anpassen
• UI-Anpassung: Farben, Positionen, Transparenz und Stil an die Serverästhetik anpassen

Handelsgeschichte & Protokollierung

Jeder abgeschlossene Handel wird mit umfassenden Informationen in der Datenbank protokolliert. Diese Informationen umfassen Spielerkennungen (Lizenz, Steam usw.), alle getauschten Gegenstände mit Mengen, die transferierten Geldbeträge, den genauen Zeitstempel und den Handelsstatus. Administratoren können die Handelshistorie einsehen, um verdächtige Aktivitäten zu untersuchen, Streitigkeiten zwischen Spielern über fehlende Gegenstände beizulegen, Marktaktivitäten und beliebte Gegenstände zu verfolgen, potenzielle Exploits oder ungewöhnliche Muster zu identifizieren und Beweise für Einsprüche gegen Sperren oder Meldungen zu liefern.

Die optionale Discord-Webhook-Integration sendet Echtzeitbenachrichtigungen über Transaktionen mit hohem Wert (konfigurierbarer Schwellenwert) und hilft Administratoren so, die Wirtschaft auf Manipulationsversuche oder RMT-Versuche (Handel mit echtem Geld) zu überwachen.

Integrationsmöglichkeiten

• Shop-Skripte: Geschäftsinhaber können ihren Lagerbestand in ihren Filialen manuell übertragen, anstatt administrative Befehle zu verwenden.
• Jobsysteme: Erlaube Job-zu-Job-Handel, wie z. B. Mechaniker, die Teile von Lieferanten kaufen, oder Köche, die Zutaten erwerben
• Gangsysteme: Bandenmitglieder handeln innerhalb der Organisation mit Waffen, Drogen oder Ressourcen.
• Wohnskripte: Tausche Möbelstücke, Hausschlüssel oder Wohndekorationen zwischen Spielern.
• Fahrzeugskripte: Fahrzeugbesitz über ein Handelssystem tauschen (sofern für die Unterstützung von Fahrzeugartikeln konfiguriert).
• Crafting-Systeme: Die Spieler handeln mit Rohstoffen oder hergestellten Waren und unterstützen so Produktionsketten.

Was es auszeichnet

Das CodeM Trading Script beseitigt die gefährliche Praxis des Drop-Tradings, bei der Spieler Gegenstände einfach auf den Boden legen und auf eine Bezahlung durch andere Spieler hoffen. Drop-Trading ist leicht ausnutzbar: Spieler können mit den Gegenständen fliehen, Dritte können die abgelegten Gegenstände einsammeln oder Betrüger können behaupten, die Ware nie erhalten zu haben. Dieses Skript ermöglicht einen sicheren, transparenten und simultanen Handel, bei dem niemand Gegenstände ohne ein vereinbartes Angebot erhalten kann. Die Echtzeit-Oberfläche zeigt vor der Ausführung genau an, was jeder Spieler anbietet, und verhindert so Lockvogelangebote. Die doppelte Bestätigung mit Countdown verhindert übereilte Entscheidungen. Vor allem aber macht die serverseitige Validierung Exploits und Duplizierung unmöglich und schafft so eine vertrauenswürdige Handelsumgebung, selbst auf öffentlichen Servern.

Wirtschaftsförderung

Sicherer Handel ermöglicht eine authentische, von Spielern gesteuerte Wirtschaft, in der sich Spieler auf Sammeln, Herstellen oder Weiterverkaufen spezialisieren und so Marktdynamiken schaffen. Rohstoffsammler verkaufen Rohstoffe an Handwerker, die wiederum fertige Produkte an Konsumenten verkaufen und so Lieferketten etablieren. Die Preisbildung erfolgt auf natürliche Weise durch Verhandlungen und nicht durch feste Preise von NPCs. Handel fördert soziale Interaktion – Spieler müssen kommunizieren, verhandeln und sich persönlich treffen, anstatt unpersönliche Auktionshäuser zu nutzen. Dies führt zu organischem Rollenspiel und dem Aufbau einer Gemeinschaft.

Anwendungsbeispiele

Händler-Rollenspiel: Der Spieler eröffnet einen Marktplatzstand und handelt über dieses System mit Kunden. Kunden können das Angebot durchstöbern, Preise verhandeln und sichere Transaktionen abschließen. Der Händler verfolgt die Verkäufe anhand der Handelshistorie und optimiert so den Lagerumschlag.

Drogengeschäfte: Ein Krimineller verkauft Drogen über das Handelssystem an einen anderen Spieler. Beide Parteien bestätigen Menge und Bezahlung vor der Ausführung. Polizei Unterbrechung, beide Seiten können den Handel sofort abbrechen. Es gibt keine Beweismittel zu sammeln.

Geräteverkauf: Der Mechaniker fertigt Fahrzeugteile an und verkauft sie an Kunden. Der Kunde bezahlt bar, erhält die Teile, die Transaktion ist abgeschlossen. Der Mechaniker hat einen Verkaufsnachweis in seiner Historie, falls der Kunde später Einwände erhebt.

Rohstoffhandel: Ein Bergmann verkauft Erz an einen Handwerker. Dieser verarbeitet es zu Barren und verkauft es an einen Waffenschmied. Der Waffenschmied stellt daraus Waffen her und verkauft sie an Bandenmitglieder. Die gesamte Produktionskette wird durch sicheren Handel ermöglicht.

Admin-Funktionen

Serveradministratoren verfügen über spezielle Kontrollmöglichkeiten, darunter die Einsicht in die vollständige Handelshistorie, die Suche nach Transaktionen anhand der Spieler-ID, das Filtern nach Artikeltyp oder -wert, der Export von Handelsprotokollen zur Analyse, die Identifizierung verdächtiger Handelsmuster und optional die Sperrung bestimmter Spieler (Cooldown oder Blacklist). Das Admin-Panel bietet Einblicke in die Serverökonomie, einschließlich der meistgehandelten Artikel, der durchschnittlichen Transaktionswerte und der Handelsaktivität im Tagesverlauf.

Support und Updates

Comprehensive documentation covers installation, configuration, inventory system integration, troubleshooting, and best practices for economy management. Active support via ticket system for technical assistance and customization help. Regular updates add community-requested features like vehicle trading, trade templates, and advanced filtering.

Verwandte ESX-Skripte

• Marihuana-Dope-Pflanzenskript
• FiveM Motel-Skript
• Geldautomatenraub (C4-Explosion, Bohranimation)
• Wais HUD V5 (ESX/QB)