207.371
líneas de código
- TypeScript
- Lua
- SQL
- JS
207.371 líneas de código
Son dos productos, no uno: 143.782 líneas en el panel web y 63.589 en el recurso que corre dentro del juego, en 1.068 archivos.
El universo
del juego
empieza aquí.
Moneda, artículos y ventajas conectados al GTA RP: pagados en el sitio, entregados al personaje, sin nadie en el medio.
Next.js 16React 19TypeScriptPrismaMySQLFiveM
Qué es
Del checkout al inventario.
El dinero compra moneda, la moneda compra el ítem, y el ítem queda en el inventario del sitio hasta que el jugador lo pide, entonces llega al personaje, dentro del servidor. Lo que sobra vuelve al mercado.
- 01El dinero compra moneda
- 02La moneda compra el ítem
- 03El ítem llega al servidor
- 04Y vuelve al mercado
La escala
Los números salen del código, no del escaparate.
Todo lo de abajo fue contado en archivos del producto real, en una auditoría de código de agosto de 2026. Nada aquí es estimación.
175
rutas de API
- 98 del panel
175 rutas de API
98 de ellas existen solo para el panel de operación. Más de la mitad de la API es el backoffice, no el escaparate.
54
modelos de datos
- Prisma
- MySQL
54 modelos de datos
Catálogo, pedidos, inventario, moneda y auditoría: la base guarda toda la operación, no solo el carrito.
41
pantallas en el panel del operador
- Pedidos
- Catálogo
- BCoin
- Informes
41 pantallas en el panel del operador
El dueño del servidor cambia precios, arma kits, activa VIP y sigue la entrega sin abrir una línea de código.
5
frameworks en el mismo puente
- vRP
- ESX
- QBCore
- QBox
- standalone
5 frameworks en el mismo puente
El recurso detecta cuál de los cinco usa el servidor y se adapta solo. El único requisito es oxmysql.
Por qué es sistema
Seis decisiones separan una tienda de un sistema.
Ninguna de ellas es una decisión de maquetación. Son seis decisiones leídas directamente en el código del producto, y son ellas las que explican por qué esto es un sistema y no un checkout con tema.
Pedido y entrega
Pagado≠Entregado
7 estados de pedido × 5 de entrega, en dos máquinas separadas, porque en la práctica fallan por separado.
panel › pedidosComando
Qué≠Cómo
El ítem declara give_vehicle; no sabe la sintaxis del servidor. La plantilla lo traduce a addcar {playerId} {model}, y cada plantilla cuenta sus propios usos.
panel › comandosCola
Disparar y olvidar≠Cola durable
Cada comando se guarda con horario, estado y contador de intentos. Si el servidor falla, el intento se cuenta y el error queda guardado, el comando espera, no se pierde.
cola de comandosSaldo
Dos copias≠Una sola fuente
El sitio habla con dos bases de datos, la suya y la del servidor del juego, y el saldo de BCoin se escribe en un solo punto: directo en la base del juego, la fuente de verdad.
base del sitio + base del juegoPago
Tener credencial≠Exponer el método
Credencial técnica en una pestaña, activación comercial en otra. PIX, tarjeta, boleto y PayPal, por tres proveedores: Mercado Pago, AbacatePay y PayPal.
configuración › pagosEliminación
Borrar≠Poder recuperar
Soft delete en 14 dominios, con fecha de eliminación y ventana para expirar. Recuperación central, no destrucción.
panel › papelera
Del checkout a tu personaje.
Cada compra se convierte en un comando en el servidor del juego.
Agrega BCoin
Compra BCoin en nuestro checkout seguro, de forma simple y práctica.Por dentro: el aviso del proveedor de pago se verifica, y el saldo de BCoin cae directo en la base del juego.
Elige tus artículos
Usa tus BCoin para conseguir vehículos, ropa, propiedades y mucho más en la tienda de Blackout.Por dentro: el artículo va al inventario del sitio y espera, el jugador pide la entrega cuando quiere, uno por uno o en lote.
Recíbelo en el juego
Tus artículos se entregan directamente en tu personaje mediante nuestra integración con el servidor.Por dentro: el comando entra en la cola del servidor; si falla, el intento se cuenta y el admin puede reenviar.
El panel en números
Cada parte de la operación tiene su herramienta.
Del informe a la alerta en Discord: lo que el dueño del servidor usa a diario, contado en las pantallas del producto.
14 Pestañas de análisis
Finanzas, pedidos, entregas, jugadores, VIP, gremios y más, con exportación a PDF eligiendo logo, color y tema.
10 Filtros en un solo registro
Pedido, pago, entrega, error, usuario, kit, marketplace, admin, lo que envió el juego y el ID del jugador, con búsqueda y exportación a CSV.
6 Etiquetas de mensaje
Soporte, presupuesto, alianza, feedback, precio de artículo y otro. Y una alerta cuando un artículo aparece en el sitio sin precio.
5 Medios de pago
PIX en dos proveedores, tarjeta, PayPal y boleto, cada uno se activa y desactiva en el panel.
6 Canales de aviso
Uno por tipo de evento: pedidos, pagos aprobados, errores de entrega, cuentas nuevas y acciones del admin, entre otros. La dirección se guarda cifrada.
- 01Informes
- 02Central de logs
- 03Central de contacto
- 04Pagos
- 05Discord
Detrás de la tienda, una operación completa.
Pedidos, catálogo, BCoin, entregas, informes y comunicación en un único panel.
Operación
41 pantallas: pedidos, catálogo, VIP y kits.
Contenido
Catálogo y papelera con 14 tipos de registro.
Integraciones
5 integraciones y 5 medios de pago.
Informes
14 pestañas de análisis y logs por jugador.
Automatización
Vencimiento automático y 6 canales en Discord.
Entrega en el juego
El sitio vende. El servidor del juego entrega.
Cada compra se convierte en un comando en una cola. Si el jugador está desconectado, el servidor se cae o el comando llega mal, nada se pierde: el intento se cuenta, el error queda guardado y el admin decide qué hacer.
- Pagado
- Comando
- Cola
- Servidor
- Personaje
- pagadoPago confirmado por el aviso del proveedor.
- comandoaddcar {playerId} {model}
- validadoComando revisado antes de ejecutarse en el servidor.
- colaPENDING · esperando su hora de ejecución.
- servidorIntento 1 · falló · error guardado.
- servidorIntento 2 · ejecutado.
- personajeArtículo en el juego · e-mail de entrega enviado.
Cuando falla, el admin decide
- ReenviarVuelve a poner el comando en la cola.
- RevertirDeshace una entrega ya hecha.
- ConfirmarDa por cerrada una entrega revisada en el juego.
- ManualEntrega del admin, fuera de la cola.
- ForzarLo ejecuta ahora, sin esperar su hora.
- Comando validadoRevisado antes de ejecutarse, corre dentro de un servidor de juego.
- Un solo cobroSi el aviso del proveedor llega dos veces, la compra no se procesa dos veces.
- Un inventario que esperaEl ítem queda guardado en el inventario del sitio y va al juego cuando el jugador lo pide, uno por uno o en lote.
Marketplace
El artículo repetido no se queda parado en el inventario.
Quien tiene un artículo de más elige: venderlo al sitio al instante, con precio garantizado, o publicarlo para otros jugadores y esperar un precio mejor. Liquidez o precio, y quien compra recibe el artículo dentro del juego.
Vender al sitio
- El sitio lo recompra a un precio calculado por su rareza.
- Precio garantizado, valor menor.
Publicar para jugadores
- Precio sugerido por rareza, para que el anuncio no se salga de la curva.
- Puede ser anónimo; depende de que alguien compre.
- Precio del anuncio
- 400 BC
- Comisión del sitio (5%)
- 20 BC
- El vendedor recibe
- 380 BC
5% es la comisión por defecto del código, y el dueño del servidor puede cambiarla.
- Venta anónimaEl vendedor publica sin mostrar su nombre a quien compra.
- Anuncio con plazoCada anuncio tiene fecha de vencimiento y sale solo.
- Protección del mercadoEl mercado tiene su propio módulo de protección, y el precio sugerido por rareza mantiene el anuncio dentro de la curva.
- Entrega en el juegoQuien compra recibe el artículo en su inventario y lo envía al personaje, como cualquier compra de la tienda.
Las tecnologías
De qué está hecho, pieza por pieza
Una tienda de servidor de GTA RP completa: la vidriera, el carrito, tres formas de pagar, la entrega dentro del juego y el panel del dueño. Elige una pieza para ver qué hace aquí y en qué archivo está.
24tecnologías, en 5 capas
Pantalla
Servidor
Datos
Pago
Integraciones
Dentro del producto
68 pantallas, en cuatro caminos.
Del escaparate al panel: las pantallas del producto, separadas por quién las usa, el jugador comprando, el jugador con sus kits, el operador cuidando la tienda y el dueño mirando los datos.
La tienda · Inicio
Pantalla 1 de 15: Inicio
Prototipo
Se puede entrar y tocar.
El prototipo navegable funciona sin backend: un service worker intercepta las mismas URLs de la API real dentro del navegador y devuelve una base ficticia con el formato que las pantallas ya esperaban. Son 3.154 líneas de datos falsos, con semilla fija, todo visitante ve los mismos gráficos.
Sin login: el visitante entra ya autenticado.
Prototipo listo
Abrir a pantalla completa
Datos ficticios, declarados en la propia interfaz.