Clothing store

1. 01

   Coloca el recurso

   Descarga el script desde tu cuenta Tebex, copia la carpeta avenida_clotheshops/ en tu directorio de recursos y añade ensure avenida_clotheshops a la config del servidor, después de ensure oxmysql.

2. 02

   Ejecuta el SQL

   Ejecuta la sección [A] de INSTALL.sql en tu base de datos. La sección [B] es condicional, la cabecera del archivo dice cuándo la necesitas.

3. 03

   Concede los permisos de admin

   Añade add_ace group.admin avenida_clotheshops.admin allow y add_ace group.admin avenida_clotheshops.vip allow a la config del servidor. El primero abre el editor de catálogo dentro del juego, el segundo desbloquea lo que hayas reservado a la lista VIP.

4. 04

   Pon precio al catálogo desde el juego

   Pon Config.DevMode.Enabled = true, entra en una tienda y abre el editor. Fija precios, oculta lo que no vendes, reserva lo que pertenece a un trabajo. Todo acaba en config/clothes_overrides.lua. Vuelve a apagar DevMode cuando termines, se comprueba otra vez en el servidor en cada guardado.

5. 05

   Verifica las integraciones

   Pon Config.Debug = true, reinicia y lee la consola: una línea por categoría de bridge nombra el target elegido. Config.Debug solo controla los logs, no es el interruptor del editor.

Poner precio a una sección de tres formas distintas

Cada tienda declara sus secciones, y cada sección su modo de precio. Una tarifa única para toda una sección, un multiplicador que encarece los drawables siguientes, o una tabla cuando solo un puñado de prendas merece su propio precio.

-- config/clothes_shops.lua
categories = {
    tops = {
        enabled = true,
        price   = { mode = 'fixed', base = 300 },
    },
    pants = {
        enabled = true,
        -- price = base + index * mult
        price   = { mode = 'multiplier', base = 100, mult = 2 },
    },
    mask = {
        enabled = true,
        price   = { mode = 'table', map = { [12] = 900, [45] = 1500 } },
        -- only these drawables are offered
        whitelist = { 12, 45, 51 },
    },
}

Exports públicos agrupados por dominio. Cada fila muestra la firma de la llamada y qué hace, no cómo lo hace.

Client

• GetSkinData

  exports['avenida_clotheshops']:GetSkinData() Copiar

  El conjunto que lleva puesto el jugador, componente a componente, props incluidos. Es lo que la tienda escribe al comprar, así que siempre coincide con lo que muestra el armario.

• ApplySkin

  exports['avenida_clotheshops']:ApplySkin(data, ped) Copiar

  Aplica una apariencia completa a un ped. Poner un conjunto vacía la ranura de decoraciones, así que esta llamada vuelve a poner después el trabajo de barbería y de tatuaje en vez de dejar la piel desnuda.

• ApplyClothing

  exports['avenida_clotheshops']:ApplyClothing(data, ped, temporary) Copiar

  Cambia la ropa y nada más. Con temporary en true el conjunto vive solo durante la sesión, que es como debe comportarse un uniforme que entrega un trabajo.

Server

• GetBagStorage

  exports['avenida_clotheshops']:GetBagStorage(sex, drawable) --> { weight, slots } | nil Copiar

  La capacidad que da un drawable de mochila, peso y ranuras, o nil cuando ese drawable no lleva nada. Llámalo desde tu recurso de inventario para que una mochila comprada guarde algo de verdad.

Ejemplos para copiar y pegar en los casos más habituales. Los metes en tu recurso, ajustas los valores y a producción.

-- config/clothes_shops.lua
Config.Clothes.Shops[22] = {
    name       = 'Ponsonbys - Rockford Hills',
    payment    = 'bank',
    currency   = '$',
    tax        = 0.20,        -- +20% on the cart
    discount   = 0.00,
    outfitMode = true,
    blip = { sprite = 73, color = 4, scale = 0.7, coords = vec3(-708.2, -152.2, 37.4) },
    categories = {
        tops  = { enabled = true, price = { mode = 'fixed', base = 900 } },
        shoes = { enabled = true, price = { mode = 'fixed', base = 450 } },
    },
}

-- config/clothes_overrides.lua, or write it from the in-game editor
Overrides['tops'] = {
    [56] = { job = 'police', label = 'LSPD jacket' },
    [12] = { hidden = true },
    [31] = { restricted = true },   -- ACE permission
}

-- config/clothes.lua
Config.Clothes.RequireOwnership = false

-- how far from a store the server still accepts a purchase
Config.Clothes.PurchaseRange = 30.0

-- saved outfits per character, enforced server side
Config.Clothes.MaxOutfits = 30
Config.Clothes.MaxOutfitsRestricted = 50

local hairbase = exports['avenida_clotheshops']:GetHairbase()
local tattoos  = exports['avenida_clotheshops']:GetTattoos()

-- your own clothing work here

if hairbase then
    AddPedDecorationFromHashes(PlayerPedId(), hairbase.c, hairbase.t)
end
for _, dec in ipairs(tattoos) do
    AddPedDecorationFromHashes(PlayerPedId(), dec.c, dec.t)
end

• Un jugador dice que ha perdido ropa que tenía
  Mira `Config.Clothes.RequireOwnership`. El registro da por pagado lo que un personaje ya lleva puesto la primera vez que lo ve, así que activarlo no le quita el vestuario a nadie. Lo que sí rechaza es una escritura de una prenda que no tenga una compra detrás, que es justo lo que manda un cliente manipulado. Si un recurso tuyo viste a los jugadores con prendas que nunca compraron, registra esas compras o pon el flag a false.
• El editor de catálogo no se abre
• La misma chaqueta aparece varias veces
• El pelo atraviesa un casco
• ¿Las fotos de los conjuntos necesitan instalar algo?
• ¿Qué frameworks soporta realmente?
• ¿Puedo usarlo junto a avenida_barber y avenida_tattoo?
• ¿Cuánto cuesta cuando no hay nadie comprando?