Agency-Blackmarket: Diseña una economía clandestina sin desestabilizar el servidor

Por qué la mayoría de los scripts de mercado negro fallan

Un script de mercado negro mal diseñado es la forma más rápida de destrozar la economía de un servidor. Si es demasiado barato, todos se convierten en criminales. Si es demasiado caro, nadie lo usa. Si es demasiado seguro, no hay riesgo. Si es demasiado arriesgado, los jugadores se agotan. Agency-Blackmarket se diseñó priorizando el equilibrio de la economía, y dejando la lista de funciones en segundo lugar.

Precios dinámicos según la demanda

Los precios de cada artículo varían según cuántos jugadores lo hayan comprado recientemente. La oferta y la demanda se gestionan automáticamente: si todo el servidor está comprando AR-15, el precio se duplica en cuestión de horas. Cuando baja la demanda, los precios se normalizan lentamente. Esto crea ritmos de mercado naturales en lugar de listas de precios fijas.

El factor de riesgo

Cada visita al mercado negro tiene una probabilidad configurable de activar un aviso policial, una emboscada o un encuentro con un NPC rival. El riesgo aumenta según el tamaño de la compra. Los jugadores astutos aprenden a dividir las compras grandes entre varias visitas. Los menos cuidadosos son atrapados y pierden su botín. Esta tensión mantiene interesante el RP ilegal.

Herramientas de administración

Cada transacción se registra con el ID del jugador, el artículo, el precio y la marca de tiempo. Los admins pueden consultar de un vistazo la economía sumergida del servidor, establecer precios mínimos o desactivar temporalmente artículos específicos. Por eso las comunidades de RP profesionales confían en nosotros para sus scripts de economía principales: no solo vendemos funciones, también incluimos la capa de gestión que permite mantenerlas en funcionamiento a gran escala.

Se integra con tus trabajos

Agency-Blackmarket expone eventos a los que pueden responder Agency-Minerjob, Agency-Admin y tus scripts de policía. El ecosistema se potencia con cada incorporación: cada script es útil por sí solo, pero juntos crean comportamientos emergentes sistémicos que no podrías programar a mano.

Instalación y configuración

Agency-Blackmarket requiere oxmysql para registrar transacciones y guardar los precios dinámicos. Importa blackmarket.sql, copia la carpeta del recurso y añade ensure agency-blackmarket a server.cfg. Las coordenadas de ubicación se definen en config.lua, el recurso incluye seis coordenadas predeterminadas para el mercado negro repartidas por el mapa predeterminado de GTA V, que puedes reemplazar por las posiciones de tus MLO personalizados.

Los artículos disponibles para la venta deben existir en el registro de artículos de tu framework. La configuración incluye una lista predeterminada de artículos; añadir o eliminar artículos es tan sencillo como editar una tabla de configuración.

Opciones de configuración

El config.lua te da control total sobre la economía y los ajustes de riesgo:

• Catálogo de artículos, define cada artículo, su precio base, precio mínimo, precio máximo y factor de elasticidad de la demanda.
• Ventana de demanda, cuántas horas del historial de compras analiza el algoritmo de precios. Valor predeterminado: 6 horas.
• Eventos de riesgo, configura la probabilidad de despacho policial, emboscada y aparición de NPC rivales según el umbral del importe de la compra.
• Rotación de ubicaciones, las ubicaciones del mercado negro pueden rotar según un horario, lo que obliga a los jugadores a mantenerse al tanto de las redes de información dentro del juego para encontrar la ubicación actual.
• Anulación administrativa de precios, los administradores sénior pueden establecer manualmente precios mínimos o máximos temporales por artículo durante eventos económicos.
• Retención del registro de transacciones, cuántos días se conserva el historial de compras. Valor predeterminado: 30 días.

Compatibilidad con frameworks

El paquete incluye adaptadores para QBCore y ESX. Para standalone, implementa cuatro funciones de configuración: entregar artículos, retirar dinero, activar alertas policiales y la restricción de acceso opcional según el trabajo. El motor de precios, el sistema de eventos de riesgo, la gestión de ubicaciones y las herramientas de administración son totalmente independientes del framework.

Por qué esto importa para el roleplay

Una economía ilegal que funciona sin demasiados riesgos termina convirtiéndose en una rutina de compras. El sistema de riesgo de Agency-Blackmarket está diseñado específicamente para que cada compra importante parezca una decisión, no una transacción. El jugador que dedica diez minutos a planificar una compra grande de armas, explorar la ubicación, elegir el momento de acercarse y decidir si llevar refuerzos, está creando un RP mejor que quien simplemente abre un menú y pulsa comprar.

Los precios dinámicos generan escasez de forma natural, sin intervención de los administradores. Cuando todo el servidor se prepara para un conflicto planeado, el aumento del precio de las armas se hace evidente para todos los jugadores que consultan el mercado. Los personajes criminales astutos aprenden a comprar antes de que se dispare la demanda. Este comportamiento económico emergente añade una profundidad estratégica que los menús con precios fijos y programados nunca pueden ofrecer.

El panel de transacciones para administradores es lo que significa gestionar responsablemente la economía de RP. Cuando la economía ilegal de un servidor no es transparente, los administradores no pueden saber si está equilibrada o rota hasta que los jugadores empiezan a quejarse. Con visibilidad completa de las transacciones, puedes ver en tiempo real si un jugador o grupo está comprando de forma desproporcionada e intervenir antes de que el desequilibrio arruine el ecosistema criminal del servidor.

Preguntas frecuentes

¿Puedo hacer que ciertos artículos solo estén disponibles para determinadas organizaciones criminales?

Sí. Cada artículo del catálogo admite un campo requiredFlag . Los jugadores que tengan esa marca activada, gestionada mediante Agency-Admin o tu propio sistema, pueden ver y comprar el artículo; los demás lo ven atenuado y con la etiqueta "restringido". Así se crea un mercado negro por niveles, donde los roles criminales de mayor rango acceden a un inventario mejor.

¿Cómo funciona el evento de emboscada?

Cuando se activa una emboscada, aparece un grupo de NPC hostiles en la ubicación del mercado negro y ataca inmediatamente al jugador. La cantidad de NPC y su equipamiento varían según el importe de la compra que activó el evento. Los jugadores que sobreviven a la emboscada conservan su compra; quienes no lo consiguen la pierden y pasa al sistema de botín. Está diseñado para ser duro, el riesgo tiene que ser real.

¿Se pueden exportar los datos de precios para analizarlos externamente?

El registro de transacciones en oxmysql se puede consultar directamente. También ofrecemos un export del servidor exports['agency-blackmarket']:GetPriceHistory(item, hours) que devuelve una tabla con capturas de precios. Conéctalo a cualquier herramienta de panel externo si quieres ver gráficos de la economía ilegal de tu servidor a lo largo del tiempo.

¿Cómo evito que un jugador manipule el sistema de demanda para alterar los precios?

Configura Config.PerPlayerDemandCap = true y Config.MaxPlayerDemandWeight = 0.3. Esto limita cuánto puede influir el historial de compras de un solo jugador en el precio global. Un comprador todavía puede manipular la demanda, pero necesita una coordinación sostenida entre varios jugadores para mover los precios de forma significativa.

Requisitos

• Servidor FiveM (QBCore, ESX o standalone)
• oxmysql
• cuenta de cfx.re con una licencia válida de Agency-Blackmarket
• Opcional: Agency-Admin (para un panel integrado de supervisión de transacciones)

Eventos económicos de temporada mediante los controles de precios del panel de administración

Las herramientas de precios para administradores de Agency-Blackmarket permiten diseñar eventos económicos. Estos son algunos enfoques que funcionan bien:

Evento de carrera armamentista: Reduce los precios de las armas un 30% durante 48 horas y anúncialo dentro del personaje mediante las transmisiones de noticias de los NPC. Esto crea una breve ventana de mayor actividad criminal a la que la policía puede prepararse para responder. La ventana se cierra antes de que la economía se desestabilice.

Choque de suministro: Desactiva temporalmente una categoría de artículos, por ejemplo, que no haya explosivos durante una semana. La escasez genera acaparamiento, comercio clandestino entre jugadores e interacciones de rol en torno a la falta de existencias. Restablece la disponibilidad y observa cómo se normaliza el mercado.

Introducción de contrabando nuevo: Lanza un artículo nuevo a un precio alto y con una baja caída de demanda. Los primeros en adoptarlo pagan un precio premium; cuando otros jugadores lo descubren, la demanda aumenta y los precios se disparan antes de normalizarse. El historial de precios cuenta cómo tu comunidad adoptó el artículo nuevo.

Estos eventos económicos no requieren que programes una lógica personalizada, son cambios en la configuración del administrador. Esa accesibilidad es precisamente la idea: los administradores de servidores que no son desarrolladores pueden organizar eventos económicos interesantes usando solo el panel de administración de Agency-Blackmarket.