Instalación

Requisitos

Recurso	Para qué
es_extended (ESX Legacy)	Framework
oxmysql	Base de datos
screenshot-basic	Fotos de los anuncios
MySQL o MariaDB	Guarda todo
API key de Imgbb gratuita	Aloja las fotos (cómo conseguirla)

Opcional: ox_inventory (se detecta solo; también se usan sus iconos de objetos). El inventario estándar de ESX también funciona.

Paso a paso

1. Descarga el recurso

Después de comprarlo, entra en portal.cfx.re → Assets → Granted Assets, descarga sl-marketplace y pon la carpeta en tu directorio resources (por ejemplo resources/[scripts]/sl-marketplace).

Importante: el script está protegido con el Asset Escrow de Cfx. Solo funciona en un servidor cuya license key (sv_licenseKey) pertenezca a la misma cuenta de Cfx que lo compró. No borres el archivo .fxap que viene con el recurso.

2. Consigue tu API key de Imgbb

Las fotos de los anuncios se suben a Imgbb, que es gratis:

1. Crea una cuenta en imgbb.com.
2. Abre api.imgbb.com y pulsa Get API key.
3. Copia la key; la usarás en el paso 4.

3. Importa la base de datos

Importa sql/marketplace.sql en la base de datos de tu servidor (HeidiSQL, phpMyAdmin o la línea de comandos):

mysql -u usuario -p tu_base_de_datos < sql/marketplace.sql

4. Configura el server.cfg

Añade estas líneas. El orden de los ensure importa.

server.cfg

# Key del alojamiento de fotos (solo servidor — nunca en config.lua)
set sl_marketplace_imgbb_key "TU_API_KEY_DE_IMGBB"

# Permiso del panel de admin para tu grupo de staff
add_ace group.admin marketplace.admin allow

ensure oxmysql
ensure screenshot-basic
ensure es_extended
ensure sl-marketplace

Opcional — logs de Discord:

server.cfg

set sl_marketplace_discord_webhook "TU_URL_DE_WEBHOOK_DE_DISCORD"

…y pon Config.Discord.Enabled = true en config.lua.

Usa set para estos secretos, nunca setr ni sets: esos se los enviarían a los jugadores.

5. Ajusta config.lua (opcional)

Con los valores por defecto ya funciona. Los cambios más habituales:

• Config.DefaultLang — 'en' (por defecto) o 'es' para los jugadores que no hayan elegido idioma, y para los logs de Discord.
• Config.OpenKey / Config.Command — cómo abren el marketplace los jugadores.
• Config.ServerFee, Config.MinPrice, Config.MaxPrice — tu economía.
• Config.MeetupPoints — dónde están los puntos de recogida.
• Config.Gameplay.NPCDelivery — coste del repartidor, seguro y atracos.
• Config.Notify — conecta tu sistema de notificaciones.

6. Arranca y prueba

Reinicia el servidor y mira la consola por si hay errores. En el juego:

1. Pulsa F6 (o escribe /market) y crea tu tienda.
2. Publica algo y cómpralo con otro jugador.
3. Con un admin, escribe /marketadmin.

Actualizar

1. Haz copia de tu base de datos y de tu config.lua.
2. Sustituye los archivos del recurso, conservando tu config.lua y tus cambios en los handlers.lua.
3. Ejecuta solo las migraciones SQL posteriores a tu versión, en orden (sql/migrate_*.sql). Están en sql/ y llevan en el nombre la versión que las necesita (migrate_1.15.sql, …).
4. Lee el CHANGELOG: algunas versiones renombran ajustes. Compara tu config.lua con el nuevo para recoger las opciones nuevas.