Instalación

Antes de empezar#

Antes de instalar Outfit Bag, asegúrate de que tu servidor cumple los requisitos mínimos. Solo un recurso es obligatorio; todo lo demás es opcional y se detecta solo.

Todo lo específico del framework o de terceros está detrás de un pequeño archivo bridge, y el recurso elige el correcto mirando lo que ya está en ejecución:

Cada integración opcional se degrada en silencio. Si falta un recurso, el script recurre a su propia versión de esa parte; nada da error. Integraciones tiene los detalles y cómo fijar una a mano.

Descargar Outfit Bag#

Después de comprar Outfit Bag, el recurso se vincula automáticamente a tu cuenta de CFX Portal.

Inicia sesión en el CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Outfit Bag.

Después de extraer la descarga, deberías tener lo siguiente:

qs-outfitbag/
├── shared/config.lua    -- the settings you edit
├── locales/             -- 28 translations, editable
├── client/custom/       -- framework and target bridges, editable
├── server/custom/       -- framework bridges and database queries, editable
├── client/ · server/    -- the core (encrypted)
├── html/                -- the bag window
└── fxmanifest.lua
[image]/
└── outfitbag.png        -- the inventory icon for the item

La carpeta debe llamarse qs-outfitbag. El script comprueba su propio nombre al iniciarse; una copia renombrada muestra You have renamed the script! y después bloquea el servidor a propósito.

Instalar el recurso#

Mueve la carpeta qs-outfitbag al directorio resources de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:

resources/
└── [qs]/
    └── qs-outfitbag/

Una vez copiada, abre tu server.cfg y asegúrate de que todas las dependencias (y todo lo que deba detectar) se inicien antes que Outfit Bag:

ensure oxmysql

# Framework
ensure es_extended
# ensure qb-core
# ensure qbx_core

# Inventory and target
ensure ox_inventory
ensure ox_target

# Clothing (optional, only for persistence)
# ensure illenium-appearance

ensure qs-outfitbag

El orden de carga importa. La detección solo ve los recursos que ya están iniciados, así que un framework o target que se inicie después de Outfit Bag no se encuentra y esa parte funciona en modo standalone.

La base de datos#

No hay ningún archivo SQL que importar. Outfit Bag crea su única tabla la primera vez que oxmysql está listo, y nunca toca nada más de tu base de datos.

Los atuendos pertenecen al jugador, no a una bolsa. Cada bolsa que coloca un jugador abre la misma lista, y esa lista sobrevive a reinicios, ítems perdidos y bolsas nuevas. Las bolsas colocadas en sí no se guardan: Uso explica su ciclo de vida.

Añadir el ítem#

La bolsa es un ítem de inventario llamado outfitbag. Regístralo en tu inventario y después copia outfitbag.png de la carpeta [image] de la descarga a la carpeta de imágenes de tu inventario.

['outfitbag'] = {
    label = 'Outfit Bag',
    weight = 1000,
    stack = true,
    close = true,
    description = 'A portable bag for storing and changing outfits anywhere.',
},

['outfitbag'] = {
    ['name'] = 'outfitbag',
    ['label'] = 'Outfit Bag',
    ['weight'] = 1000,
    ['type'] = 'item',
    ['image'] = 'outfitbag.png',
    ['unique'] = false,
    ['useable'] = true,
    ['shouldClose'] = true,
    ['combinable'] = nil,
    ['rare'] = 'common',
    ['description'] = 'A portable bag for storing and changing outfits anywhere.'
},

outfitbag = {
    name = 'outfitbag',
    label = 'Outfit Bag',
    weight = 1000,
    type = 'item',
    image = 'outfitbag.png',
    unique = false,
    useable = true,
    shouldClose = true,
    combinable = nil,
    description = 'A portable bag for storing and changing outfits anywhere.'
},

INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`)
VALUES ('outfitbag', 'Outfit Bag', 1, 0, 1);

Configurar el recurso#

Todo lo que configuras está en un único archivo, shared/config.lua. El framework y el target se detectan por ti; el resto son unos pocos valores:

Los valores que conviene revisar primero:

Config.Language = 'en'                          -- any code from locales/
Config.ItemName = 'outfitbag'                   -- must match your inventory item
Config.BagModel = 'reh_prop_reh_bag_outfit_01a' -- the bag prop
Config.PersistOutfitToClothing = false          -- keep false if clothes are items

El Config.DefaultBags incluido contiene un ejemplo: una bolsa de uniforme de policía dentro de Mission Row. Consérvalo, adáptalo o define Config.DefaultBags = {} si todavía no quieres bolsas de uniforme. La configuración se lee cuando se inicia el recurso, así que reinícialo después de un cambio.

Verificar la instalación#

Después de completar la instalación, define Config.Debug = true, reinicia tu servidor y lee la consola. La detección es lo primero que muestra:

[Quasar Outfit Bag]: Found matching dependency: es_extended with ID: esx
[Quasar Outfit Bag]: Found matching dependency: ox_target with ID: ox_target

No matching dependencies found significa que todavía no se estaba ejecutando nada de esa lista: revisa tu orden de carga. Después entra en tu servidor y completa el primer ciclo:

1. Date el ítem

   Usa el comando propio de tu framework o inventario, por ejemplo /giveitem <id> outfitbag 1. En un servidor standalone, escribe /outfitbag en su lugar.

2. Coloca la bolsa

   Usa el ítem. Tu personaje deja una bolsa delante de él y el ítem sale de tu inventario.

3. Desbloquéala y guarda un atuendo

   Apunta a la bolsa con el target y elige Use Bag. Una bolsa nueva se abre bloqueada: pulsa el candado, después Save Outfit, escribe un nombre y pulsa Enter.

4. Aplícalo y recoge la bolsa

   Haz clic en el atuendo para previsualizarlo, elige uno de sus cuatro iconos para ponértelo y cierra con ESC. Vuelve a apuntar a la bolsa y elige Pick Up Bag — el ítem vuelve a tu inventario.

Los atuendos se escriben en la base de datos en cuanto pulsas Enter. Recoge la bolsa, coloca otra en cualquier sitio: la misma lista te espera dentro.