CodeM-Handelsskript (ESX/QB)

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

Das CodeM Trading Script ermöglicht sicheren und intuitiven Spieler-zu-Spieler-Handel auf Ihrem FiveM-Server. Dieses umfassende Handelssystem bietet Echtzeit-Gegenstandstausch, Währungstransaktionen, Vier-Augen-Bestätigung, Betrugsschutz, Protokollierung des Handelsverlaufs, eine moderne Benutzeroberfläche, distanzbasierten Handel und vollständige Framework-Integration. So entsteht ein sicherer Marktplatz, auf dem Spieler Gegenstände, Fahrzeuge und Geld direkt und ohne Admin-Eingriff oder riskantes Drop-Trading tauschen können.

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 – Split-Screen-Oberfläche, die Ihre Angebote auf der einen Seite und die Angebote Ihrer Partner auf der anderen Seite mit klarer visueller Trennung anzeigt.
• 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 – Konfigurieren Sie Gegenstände, die nicht gehandelt werden können (Admin-Werkzeuge, Spezialgegenstände, Questgegenstände)
• 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. Laden Sie das CodeM Trading Script-Paket aus Ihrer Kaufbestätigung herunter.
2. Extrahieren Sie die Ressource in das Ressourcenverzeichnis Ihres Servers.
3. Importieren Sie die bereitgestellte SQL-Datei, um eine Datenbanktabelle für den Handelsverlauf zu erstellen.
4. Konfigurieren Sie die Framework-Einstellungen in config.lua (ESX/QBCore Detektion)
5. Legen Sie Handelsdistanzbeschränkungen, Bestätigungs-Timeouts und Abkühlphasen fest.
6. Konfigurieren Sie Geldtransferlimits und gesperrte Artikel
7. Passen Sie die Farben und Positionen der Benutzeroberfläche an das Serverdesign an.
8. Hinzufügen Codem-Handel sicherstellen zu server.cfg
9. Server neu starten und Handel zwischen zwei Spielern testen
10. Überprüfen Sie, ob alle Elemente unter Beibehaltung der Metadaten korrekt übertragen wurden.

Framework-Kompatibilität

• ✅ ESX-Vermächtnis – Vollständige Integration mit ESX-Inventar, Geldsystemen (Bargeld/Schwarzgeld) und Spielerdaten
• ✅ QBCore – 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: Erleichtern Sie den Handel zwischen verschiedenen Branchen, beispielsweise wenn Mechaniker Ersatzteile von Zulieferern kaufen oder Köche 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

Beinhaltet lebenslange Updates mit neuen Funktionen, Framework-Kompatibilitätsaktualisierungen, Sicherheitspatches und Fehlerbehebungen. Die umfassende Dokumentation deckt Installation, Konfiguration, Integration des Inventarsystems, Fehlerbehebung und Best Practices für das Wirtschaftsmanagement ab. Aktiver Support per Ticketsystem für technische Hilfe und Unterstützung bei Anpassungen. Regelmäßige Updates fügen von der Community gewünschte Funktionen wie Fahrzeughandel, Handelsvorlagen und erweiterte Filterung hinzu.

Verwandte ESX-Skripte

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