Script de trading de CodeM (ESX/QB)

Script de Comercio de CodeM – Sistema Seguro de Intercambio de Artículos y Moneda entre Jugadores

El Script de Comercio de CodeM permite el comercio seguro e intuitivo entre jugadores en tu servidor FiveM. Este sistema de comercio integral incluye intercambio de artículos en tiempo real, transacciones de moneda, requisitos de doble confirmación, protecciones contra estafas, registro de historial de comercio, interfaz moderna UI, comercio basado en distancia y integración completa del marco – creando un mercado seguro donde los jugadores pueden intercambiar artículos, vehículos y dinero directamente sin intervención del administrador o comercio de riesgo por drop-trading.

Qué está incluido

Este paquete de comercio completo incluye una interfaz de ventana de comercio segura que muestra las ofertas de ambas partes, intercambio de artículos que admite cualquier artículo del inventario con controles de cantidad, comercio de dinero con límites configurables, sistema de doble confirmación que requiere que ambos jugadores acepten, actualizaciones de comercio en tiempo real cuando se añaden o eliminan artículos, cancelación de comercio que permite a cualquiera de las partes abortar, protecciones contra estafas que previenen la duplicación de artículos y exploits, seguimiento del historial de comercio para transacciones completadas, comercio basado en distancia que requiere proximidad física, mecanismos de tiempo de espera que previenen comercios abiertos indefinidamente y registro completo para resolución de disputas.

Características principales

• Ventana de Comercio Segura – Interfaz de pantalla dividida que muestra tus ofertas en un lado y las ofertas de tu socio en el otro con una separación visual clara
• Intercambio de Artículos – Intercambia cualquier artículo del inventario con selección de cantidad, verificación de peso y preservación de metadatos (accesorios de armas, durabilidad, etc.)
• Comercio de Dinero – Intercambia efectivo junto con artículos con límites de transacción mínimos/máximos configurables y soporte para dinero negro (ESX)
• Doble Confirmación – Ambos jugadores deben hacer clic en Aceptar antes de que se ejecute el comercio, evitando transacciones apresuradas o accidentales
• Actualizaciones en tiempo real – La ventana de comercio se actualiza instantáneamente cuando se añaden/eliminan artículos, mostrando las ofertas actuales antes de la confirmación final
• Cancelación de Comercio – Cualquiera de las partes puede cancelar el comercio en cualquier momento antes de la confirmación final con devolución automática de los artículos
• Protección contra Duplicación – Validación del lado del servidor previene exploits de duplicación de artículos y manipulación del inventario
• Requisitos de Distancia – Los jugadores deben estar dentro de una proximidad configurable para iniciar y mantener comercios, evitando intentos de estafa remotos
• Solicitudes de Comercio – Envía solicitudes de comercio a jugadores cercanos mostrando una notificación que pueden aceptar o rechazar
• Historial de Comercio – Registro completo de todos los comercios completados con marcas de tiempo, artículos intercambiados y participantes para resolución de disputas
• Sistema de Tiempo de Espera – Los comercios se cancelan automáticamente después de un período de inactividad configurable, evitando comercios colgados indefinidamente
• Verificación de Peso – Verifica que ambos jugadores tengan suficiente capacidad de inventario antes de permitir la ejecución del comercio
• Sistema de lista negra – Configura los artículos que no se pueden comerciar (herramientas de administración, artículos especiales, objetos de misión)
• Tiempos de espera para el comercio – Períodos de espera opcionales entre comercio para evitar el comercio por spam o la manipulación del mercado
• Efectos sonoros – Retroalimentación auditiva para solicitudes de comercio, adición de artículos, confirmaciones y finalizaciones

Perfecto para

• Servidores económicos – Permite una economía impulsada por los jugadores con intercambio directo de artículos y moneda sin vendedores NPC
• Servidores Roleplay – Soporta escenarios de comercio realistas como el rol de comerciante, transacciones comerciales y ventas de artículos personales
• Servidores de Supervivencia – Esencial para el comercio de recursos, intercambios de equipo y cooperación comunitaria
• Servidores públicos – Evita el engaño a través del comercio de caída proporcionando un mecanismo de intercambio seguro y transparente
• Comunidades en Lista Blanca – Facilita la interacción y el comercio de los jugadores en comunidades cerradas
• Trabajo Sistemas – Soporta transacciones comerciales como la compra de suministros a mayoristas o la venta de productos a clientes

Flujo de trabajo del proceso de comercio

Iniciar comercio: El jugador se acerca a otro jugador (dentro de un radio configurable, típicamente 3-5 metros) y abre el menú de comercio seleccionando al jugador objetivo. El objetivo recibe una notificación con el nombre del comerciante y puede aceptar o rechazar. Al aceptar, se abre la ventana de comercio para ambos jugadores simultáneamente.

Añadir ofertas: Cada jugador añade de forma independiente artículos de su inventario y/o dinero a su lado del comercio. A medida que se añaden los artículos, aparecen en tiempo real en las ventanas de comercio de ambos jugadores. Los jugadores pueden eliminar artículos antes de la confirmación final. Las comprobaciones de peso aseguran que el jugador receptor tenga espacio en el inventario.

Fase de confirmación: Cuando ambos jugadores están satisfechos con las ofertas, cada uno hace clic en el botón Aceptar. La primera aceptación muestra el estado Esperando al otro jugador. Una vez que ambos aceptan, comienza una breve cuenta regresiva (3-5 segundos) que permite una revisión final. Cualquier jugador puede cancelar aún durante la cuenta regresiva.

Ejecución del comercio: Después de la cuenta regresiva, los artículos y el dinero se transfieren simultáneamente entre los inventarios. El servidor valida todas las transferencias evitando la duplicación. Aparece una notificación de éxito para ambos jugadores. La ventana de comercio se cierra automáticamente. La transacción se registra en el historial.

Cancelación: Cualquier jugador puede hacer clic en Cancelar en cualquier momento antes de la cuenta regresiva final. Todos los artículos ofrecidos regresan instantáneamente a sus dueños originales. La ventana de comercio se cierra con una notificación de cancelación.

Protecciones anti-engaño

Validación del lado del servidor: Todas las operaciones de comercio se ejecutan en el lado del servidor con comprobaciones de validación que aseguran que los jugadores realmente poseen los artículos ofrecidos, que existe suficiente espacio en el inventario para los artículos recibidos, que las cantidades de dinero son exactas y dentro de los límites, que los artículos no se duplican durante la transferencia y que los metadatos se preservan correctamente. Las pantallas del lado del cliente se verifican contra la autoridad del servidor, evitando la manipulación.

Sistema de confirmación: El requisito de doble confirmación evita estafas de cambio rápido donde los comerciantes cambian las ofertas en el último segundo. La cuenta regresiva de 3-5 segundos después de que ambos aceptan proporciona una oportunidad de revisión final. Las actualizaciones en tiempo real muestran exactamente qué está ofreciendo cada jugador antes de la ejecución.

Aplicación de la distancia: Las operaciones de comercio se cancelan automáticamente si los jugadores se alejan demasiado durante la transacción, evitando situaciones en las que un jugador se aleja durante el comercio. La verificación de proximidad se ejecuta continuamente durante todo el proceso de comercio.

Registro de comercio: Los registros completos de transacciones permiten a los administradores investigar intercambios disputados, verificar qué se intercambió, identificar intentos de estafa y resolver conflictos con pruebas. Los registros incluyen identificadores de jugadores, artículos intercambiados, cantidades, marcas de tiempo y estado de éxito/cancelación del intercambio.

Especificaciones técnicas

• Actuación: ~0.015ms impacto en el servidor, operaciones e inventario de validación optimizados
• Base de datos: Almacena el historial de comercio con datos de los participantes, artículos intercambiados y marcas de tiempo de la transacción
• Sistemas de inventario: Compatible con ox_inventory, qb-inventory, qs-inventory, esx_inventory y soluciones personalizadas
• Tecnología de interfaz de usuario: Interfaz moderna NUI con diseño reactivo y sincronización en tiempo real
• Seguridad: Validación del lado del servidor de todas las operaciones para evitar exploits y duplicaciones
• Tamaño del archivo: Aproximadamente 6 MB incluyendo activos UI, efectos de sonido y configuración

Instalación

1. Descarga el paquete de scripts de comercio de CodeM desde tu confirmación de compra
2. Extrae el recurso al directorio de recursos de tu servidor
3. Importar el archivo SQL proporcionado para crear la tabla de la base de datos de historial de comercio
4. Configura la configuración del marco en config.lua (ESX/QBCore detección)
5. Establezca límites de distancia de comercio, tiempos de espera de confirmación y períodos de enfriamiento
6. Configure límites de transferencia de dinero y artículos en lista negra
7. Personalizar colores y posiciones de UI para que coincidan con el tema del servidor
8. Agregar ensure codem-trading al servidor.cfg
9. Reinicia el servidor y prueba el comercio entre dos jugadores
10. Verificar que todos los artículos se transfieran correctamente con preservación de metadatos

Compatibilidad del marco

• ✅ ESX Legacy – Integración completa con el inventario ESX, sistemas de dinero (efectivo/dinero negro) y datos del jugador
• ✅ QBCore – Soporte completo para QB con metadatos de inventario, manejo de efectivo y gestión de jugadores
• ✅ QBOX – Compatible con características modernas del marco QBOX
• ✅ Standalone – Puede operar con marcos personalizados a través de la configuración del puente de inventario

Opciones de configuración

• Distancia de comercio: Establece la distancia máxima entre jugadores para iniciar y mantener operaciones de comercio (por defecto: 3-5 metros)
• Tiempo de espera de confirmación: Duración de la cuenta regresiva después de que ambos acepten antes de la ejecución (predeterminado: 3-5 segundos)
• Tiempo de inactividad: Anular automáticamente los intercambios después de X minutos de inactividad (predeterminado: 2-5 minutos)
• Límites de dinero: Establezca los montos mínimos y máximos de efectivo por intercambio, evitando microtransacciones o transferencias excesivas
• Tiempo de espera de comercio: Requiere X segundos entre operaciones de comercio consecutivas por jugador (opcional, previene spam)
• Artículos en la lista negra: Definir artículos que no pueden ser intercambiados (herramientas de administrador, artículos de misión, armas especiales)
• Efectos sonoros: Activar/desactivar la retroalimentación de audio y personalizar archivos de sonido
• Personalización de UI: Ajuste los colores, posiciones, transparencia y estilo para que coincidan con la estética del servidor

Historial de comercio y registro

Cada intercambio completado se registra en la base de datos con información comprehensiva incluyendo ambos identificadores de jugador (licencia, steam, etc.), todos los artículos intercambiados con cantidades, cantidades de dinero transferidas, hora exacta y estado de éxito del intercambio. Los administradores pueden consultar el historial de intercambios para investigar actividad sospechosa, resolver disputas de jugadores sobre artículos perdidos, rastrear actividad del mercado y artículos populares, identificar posibles exploits o patrones inusuales, y proporcionar evidencia para apelaciones de baneo o informes.

Integración opcional de webhook Discord envía notificaciones en tiempo real de operaciones de comercio de alto valor (umbral configurable) ayudando a los administradores a monitorear la economía para manipulación o intentos de RMT (comercio de dinero real).

Posibilidades de Integración

• Tienda Scripts: Los dueños de negocios pueden intercambiar existencias de inventario a sus tiendas en lugar de usar comandos de administración
• Sistemas de trabajo: Facilitar el comercio de trabajo a trabajo como mecánicos comprando piezas a proveedores o chefs comprando ingredientes
• Sistemas de Pandillas: Los miembros de la pandilla intercambian armas, drogas o recursos dentro de la organización
• Scripts de vivienda: Comerciar artículos de mobiliario, llaves de propiedad o decoraciones de vivienda entre jugadores
• Vehículo Scripts: Intercambia la propiedad de vehículos a través del sistema de comercio (si está configurado para soportar elementos de vehículos)
• Sistemas de artesanía: Los jugadores intercambian materias primas o bienes elaborados que apoyan las cadenas de producción

Lo que lo hace destacar

El script de comercio de CodeM Trading elimina la peligrosa práctica del comercio de caída donde los jugadores dejan caer artículos en el suelo esperando que otro jugador pague. El comercio de caída es fácilmente explotable: los jugadores pueden escapar con los artículos, terceros pueden agarrar los artículos caídos o los estafadores pueden afirmar que nunca recibieron los bienes. Este script proporciona un intercambio seguro, transparente y simultáneo donde nadie puede tomar los artículos sin dar las ofertas acordadas. La interfaz en tiempo real muestra exactamente qué está ofreciendo cada jugador antes de la ejecución, evitando estafas de señuelo y cambio. La confirmación dual con cuenta regresiva evita decisiones apresuradas. Lo más importante, la validación del lado del servidor hace que las explotaciones y la duplicación sean imposibles, creando un entorno de comercio confiable incluso en servidores públicos.

Mejora de la economía

El comercio seguro permite una economía impulsada por jugadores genuinos donde los jugadores se especializan en la recolección, elaboración o reventa, creando dinámicas de mercado. Los recolectores de recursos venden materias primas a los elaboradores, quienes venden productos terminados a los consumidores, estableciendo cadenas de suministro. El descubrimiento de precios ocurre de manera natural a través de la negociación en lugar de precios fijos de NPC. El comercio crea interacción social: los jugadores deben comunicarse, negociar y encontrarse en persona en lugar de usar casas de subastas impersonales. Esto genera roleplay orgánico y construcción de comunidad.

Ejemplos de casos de uso

Comerciante Roleplay: El jugador establece un puesto en el mercado y comercia con los clientes utilizando este sistema. Los clientes exploran el inventario, negocian precios y completan intercambios seguros. El comerciante rastrea las ventas a través del historial de intercambios y gestiona el inventario.

Tratos de drogas: El criminal vende drogas a otro jugador a través del sistema de comercio. Ambas partes confirman las cantidades y el pago antes de la ejecución. Si policía interrumpir, cualquiera puede cancelar el comercio instantáneamente. No hay evidencia caída para recopilar.

Ventas de equipo: El mecánico elabora piezas de vehículos y las comercia con los clientes. El cliente paga en efectivo, recibe las piezas, la transacción está completa. El mecánico tiene prueba de venta en el historial de comercio si el cliente disputa más tarde.

Comercio de Recursos: El minero vende mineral al artesano. El artesano procesa en barras y vende al armero. El armero fabrica armas y vende a los miembros de la banda. Cadena de producción completa facilitada por el comercio seguro.

Funciones de administración

Los administradores del servidor tienen controles especiales, incluyendo la visualización de la base de datos completa del historial de intercambios, la búsqueda de intercambios por identificador de jugador, el filtrado por tipo de artículo o valor, la exportación de registros de intercambios para análisis, la identificación de patrones de intercambio sospechosos y, opcionalmente, el bloqueo de jugadores específicos para comerciar (enfriamiento o lista negra). El panel de administración proporciona información sobre la economía del servidor, incluyendo los artículos más intercambiados, los valores promedio de las transacciones y la actividad de intercambio por hora del día.

Soporte y actualizaciones

La documentación completa cubre la instalación, configuración, integración del sistema de inventario, resolución de problemas y las mejores prácticas para la gestión económica. Soporte activo a través del sistema de tickets para asistencia técnica y ayuda con la personalización. Las actualizaciones regulares añaden características solicitadas por la comunidad, como el comercio de vehículos, plantillas de comercio y filtrado avanzado.

Relacionados ESX Scripts

• Guión de planta de marihuana
• Guión del FiveM Motel
• Robo de cajero automático (explosión de C4, animación de perforación)
• Wais HUD V5 (ESX/QB)