Configuración
Qué puedes editar
Sección titulada «Qué puedes editar»| Abierto (edítalo libremente) | Protegido por escrow |
|---|---|
config.lua |
El resto del código Lua |
server/handlers.lua, client/handlers.lua |
|
bridge/server/, bridge/client/ (un adaptador por framework) |
|
sql/, la documentación |
|
locales/ (todos los textos que leen los jugadores en el juego) |
|
html/ (interfaz: plantillas, estilos, traducciones) |
Vista rápida
Sección titulada «Vista rápida»Todo está en config.lua, comentado sección por sección:
| Sección | Qué controla |
|---|---|
Config.Framework, InventoryBackend |
Framework e inventario (los dos se detectan solos) |
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
Sección titulada «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:
add_ace group.admin marketplace.admin allowIdioma por defecto
Sección titulada «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
Sección titulada «Economía»Config.ServerFee = 0.05Config.MinPrice = 10Config.MaxPrice = 10000000Config.Featured.Cost = 5000Config.BumpCost = 500
El sistema aplica comisión de servidor, precio mínimo y máximo, coste por destacar y coste por bump.
Subastas
Sección titulada «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
Sección titulada «Límites y limpieza»Config.MaxListingsPerPlayerConfig.MaxImagesPerListingConfig.PageSizeConfig.RateLimitsConfig.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
Sección titulada «Nombre de tienda»Config.ShopName controla:
- Longitud mínima.
- Longitud máxima.
- Patrón de caracteres válidos.
Colores de avatar
Sección titulada «Colores de avatar»Config.AvatarColors define la paleta disponible para el perfil.
Items bloqueados
Sección titulada «Items bloqueados»Config.BannedItems impide publicar items no permitidos como dinero o dinero negro.
Backend de inventario
Sección titulada «Backend de inventario»Config.InventoryBackend = 'auto'
Con 'auto' se usa ox_inventory si esta arrancado; si no, el inventario del
propio framework (el nativo de ESX o qb-inventory). Puedes forzar
'ox_inventory', 'esx' o 'qb-inventory'. Con ox_inventory y
qb-inventory el anuncio retira exactamente el slot que eligio el vendedor y
conserva su metadata (número de serie, munición, durabilidad…).
Framework
Sección titulada «Framework»Config.Framework = 'auto'
Al arrancar, el recurso busca qbx_core, qb-core o es_extended, en ese
orden (Qbox trae una capa de compatibilidad que se hace pasar por qb-core,
por eso se mira primero), y escribe el resultado en la consola. Pon 'esx',
'qb' o 'qbx' solo para forzar uno.
Todo lo que depende del framework esta en bridge/server/<framework>.lua y
bridge/client/<framework>.lua: jugadores e identificadores (identifier en
ESX, citizenid en QBCore y Qbox), efectivo, trabajos, notificaciones, eventos
de carga y cierre de personaje y vehículos en propiedad. Estos ficheros van sin
cifrar para que puedas adaptarlos a un framework modificado.
Los vehículos anunciados los custodia el marketplace hasta que se venden o se
cancela el anuncio. En ESX el dueño en owned_vehicles pasa a ser
marketplace. En QBCore y Qbox, player_vehicles.citizenid tiene una clave
foranea hacia players, así que el vehículo se queda con citizenid y
license vacios, y recibe la licencia del nuevo dueño al entregarse.
Sistema de categorías y rarezas
Sección titulada «Sistema de categorías y rarezas»Categorías
Sección titulada «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:
labellabels.eslabels.enicon
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, o los items compartidos de QBCore) 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
Sección titulada «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.eslabels.en
Esto se usa tanto para filtros visuales como para restricciones de precio.
Ajustes que conviene no tocar sin entenderlos
Sección titulada «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.