Configuración

Qué puedes editar

Abierto (edítalo libremente)	Protegido por escrow
config.lua	El resto del código Lua
server/handlers.lua, client/handlers.lua
sql/, la documentación
locales/ (todos los textos que leen los jugadores en el juego)
html/ (interfaz: plantillas, estilos, traducciones)

Vista rápida

Todo está en config.lua, comentado sección por sección:

Sección	Qué controla
Config.Command, OpenKey, AdminCommand, DefaultLang	Abrir la interfaz, idioma por defecto
Config.ServerFee, MinPrice, MaxPrice, BumpCost, Featured	Economía y comisiones
Config.MaxListingsPerPlayer, MaxImagesPerListing, BannedItems	Límites de anuncios y objetos bloqueados
Config.DeliveryBuyerFee	Extra por elegir un modo de entrega no preferido
Config.Auction, Config.Auctions	Duraciones, incrementos, anti-snipe, ciega/automática/holandesa/inversa
Config.Rarities, ItemRarities, Categories, ItemCategories	Rarezas, categorías y ajustes manuales
Config.Photo	Alojamiento de fotos, calidad y cámara libre
Config.ItemIcons	De dónde salen los iconos de los objetos
Config.MeetupPoints, Config.Markers	Puntos de recogida y marcadores del mundo
Config.Gameplay	Ofertas flash, lotes, repartidor NPC, seguro y atracos
Config.SkillCheck	El minijuego del atraco
Config.InPersonTrade, Config.Barter	Quedadas y trueques
Config.Storefront, Refunds, Verified, Reports, Wishlist	Funciones sociales
Config.RateLimits, Cleanup	Anti-spam y limpieza de datos
Config.Discord, Config.Admin	Logs y acceso de administración
Config.Notify, Config.OnDeliveryRobbed	Tus notificaciones y tu aviso a la policía

Cada opción se explica más abajo.

Comandos y acceso

• Config.Command = 'market'
• Config.OpenKey = 'F6'
• Config.AdminCommand = 'marketadmin'

Esto permite abrir el marketplace con F6 o con /market, y el panel admin con /marketadmin.

El panel admin requiere el permiso ACE marketplace.admin. Si el grupo de administración del servidor es group.admin, añade en server.cfg:

server.cfg

add_ace group.admin marketplace.admin allow

Idioma por defecto

• Config.DefaultLang = 'en'

El idioma de cada jugador se guarda en su perfil y todo lo que lee lo sigue. Config.DefaultLang se usa para los jugadores que no han elegido idioma y para los textos que no son de un solo jugador (ver sección 24).

Economía

• Config.ServerFee = 0.05
• Config.MinPrice = 10
• Config.MaxPrice = 10000000
• Config.Featured.Cost = 5000
• Config.BumpCost = 500

El sistema aplica comisión de servidor, precio mínimo y máximo, coste por destacar y coste por bump.

Subastas

Config.Auction controla:

• Duración mínima y máxima.
• Incremento mínimo de puja.
• Incremento mínimo porcentual.
• Anti-snipe.

Límites y limpieza

• Config.MaxListingsPerPlayer
• Config.MaxImagesPerListing
• Config.PageSize
• Config.RateLimits
• Config.Cleanup

Estos valores regulan cuantas publicaciones puede tener cada jugador, cuantas imágenes se permiten y la limpieza automática de datos.

Nombre de tienda

Config.ShopName controla:

• Longitud mínima.
• Longitud máxima.
• Patrón de caracteres válidos.

Colores de avatar

Config.AvatarColors define la paleta disponible para el perfil.

Items bloqueados

Config.BannedItems impide publicar items no permitidos como dinero o dinero negro.

Backend de inventario

• Config.InventoryBackend = 'auto'

El sistema intenta detectar el backend disponible.

Sistema de categorías y rarezas

Categorías

Las categorías agrupan items por tipo:

• armas
• munición
• comida
• bebidas
• sustancias
• vehículos
• herramientas
• materiales
• electrónica
• ropa
• otros

Cada categoría tiene:

• label
• labels.es
• labels.en
• icon

La asignación de cada item a su categoría es automática: el server enumera el catálogo de ox_inventory (o la tabla items de ESX) al iniciar y aplica patrones por nombre (definidos en server/categories.lua). El mapa resultante se manda al NUI al abrir la UI.

Config.ItemCategories queda como override opcional para forzar la categoría de items concretos cuyo nombre no encaje con ningún patrón, o para reasignar items que se categorizan mal por defecto.

Rarezas

Las rarezas definen niveles de valor y precio mínimo:

• common
• uncommon
• rare
• epic
• legendary

Cada rareza tiene:

• color
• precio mínimo
• label
• labels.es
• labels.en

Esto se usa tanto para filtros visuales como para restricciones de precio.

Ajustes que conviene no tocar sin entenderlos

• Config.ItemIcons.UrlPatterns: controla los fallbacks visuales de imágenes.
• Config.DeliveryBuyerFee: altera el coste del modo de entrega.
• Config.Gameplay.NPCDelivery: afecta al equilibrio de compras con NPC.
• Config.InPersonTrade: regula la experiencia de trade presencial.
• Config.RateLimits: evita spam y abuso.
• Config.Cleanup: afecta al mantenimiento automático.
• Config.Reports.Reasons: define motivos válidos de reporte.