Saltar al contenido
Toda la documentación

Clothingstore

Tienda de ropa con vista previa en vivo: los jugadores cambian su ropa, guardan looks como conjuntos pagando en efectivo y los comparten con otros. Con la bolsa de ropa también pueden ponerse sus conjuntos sobre la marcha. Además hay una barbería y un estudio de tatuajes con sus propias ubicaciones, blips y menús.

Requisitos
  • ESX Legacy (es_extended)
  • oxmysql
  • skinchanger y esx_skin (incluidos en ESX Legacy)
  • OneSync (obligatorio)
  • Para la bolsa de ropa: un inventario con items de ESX (tabla items), p. ej. off_inventory

Funciones

  • Vista previa en vivo con cámara en la parte del cuerpo correspondiente. Arrastrar gira al personaje, la rueda del ratón hace zoom.
  • 14 categorías con Variante y Estilo.
  • Conjuntos por personaje: guardarlos por un precio fijo, ponérselos, renombrarlos, compartirlos y eliminarlos.
  • Compartidos: ponerse gratis los conjuntos de otros jugadores (los 100 más recientes).
  • Bolsa de ropa (item clothbag): déjala en el suelo y ponte allí tus propios conjuntos.
  • Todos ven la bolsa y pueden usarla.
  • Solo el dueño puede recogerla. Si está desconectado, cualquiera puede recogerla.
  • Las bolsas dejadas siguen ahí incluso tras un reinicio.
  • /clearbags retira todas las bolsas dejadas.
  • Barbería con vista previa en vivo y cámara en la cabeza:
  • todos los peinados y variantes del modelo de personaje, todos los colores de pelo con mechas
  • barba, cejas, vello del pecho, maquillaje, colorete y pintalabios con forma, opacidad y color (barba y vello del pecho solo para personajes masculinos)
  • Se paga por cada categoría modificada. Cancelar restablece el look anterior.
  • Estudio de tatuajes con todos los tatuajes de GTA, DLC incluidos, leídos directamente del juego:
  • ordenados por cabeza, torso, brazos y piernas, con búsqueda y filtro Míos
  • vista previa en el personaje, tatuar y quitar por un precio fijo
  • guardados por personaje y aplicados de nuevo automáticamente al entrar, al reaparecer y tras cada cambio de skin
  • La barbería y el estudio de tatuajes cobran primero en efectivo y el resto del banco.

Instalación

  1. Pon la carpeta off_clothingstore en tu carpeta resources.
  2. En el server.cfg, después de oxmysql, ESX y skinchanger:
cfg
ensure oxmysql
ensure es_extended
ensure skinchanger
ensure esx_skin
ensure off_clothingstore
  1. Quita esx_clotheshop u otras tiendas de ropa en los mismos lugares.

En el primer inicio, el script crea automáticamente:

  • las tablas off_clothing_outfits, off_clothing_bags y off_clothing_tattoos
  • el item clothbag en la tabla items, si falta

Configuración

config/settings/config.lua

OpciónPredeterminadoDescripción
serverInfo.name'OFF SCRIPTS'Nombre del servidor, se muestra en la interfaz en lugar de «OFF SCRIPTS»
serverInfo.locale'de'Idioma: de, en, pl, fr, es, it o nl
serverInfo.color{ 155, 89, 255 }Color de la UI (RGB)
serverInfo.design3Diseño de la interfaz: 1 = Clásico, 2 = Ticket, 3 = Storefront
blurtrueFondo desenfocado mientras el menú de la bolsa está abierto. La tienda sigue nítida porque ahí ves a tu propio personaje
outfitPrice250Precio por conjunto guardado (efectivo), 0 = gratis
maxOutfits25Máx. de conjuntos por personaje
markerDisco, 3 mCírculo: type, size (zona para abrir), drawDistance, color, alpha
blipIcono 73Icono del mapa (enabled, sprite, color, scale)
locations14 tiendasCentro del círculo en el suelo como vec3
barberactivado, 7 ubicacionesBarbería, ver abajo
tattooactivado, 6 ubicacionesEstudio de tatuajes, ver abajo

config/settings/config.categories.lua – Categorías

Solo estas categorías aparecen en la tienda y solo ellas se guardan en los conjuntos, en el orden del archivo.

lua
{ icon = 'shoes', label = 'Schuhe', variant = 'shoes_1', color = 'shoes_2', camOffset = vec3(0, 0.9, -0.8) },
CampoDescripción
iconbag, chain, earrings, glasses, gloves, hat, jacket, mask, ring, shirt, shoes, shorts, vest, watch o un icono de Phosphor con ph-
labelNombre en la tienda
variant / colorValores de skinchanger para Variante y Estilo
camOffsetCámara: x = izquierda/derecha, y = distancia hacia delante, z = altura

config/settings/config.bag.lua – Bolsa de ropa

OpciónPredeterminadoDescripción
enabledtruefalse = bolsa de ropa desactivada por completo (sin item, sin bolsas)
item'clothbag'Nombre del item, se crea al iniciar en la tabla items
weight1Peso del item
model'prop_cs_heist_bag_02'Objeto de la bolsa en el suelo
max1Cuántas bolsas puede dejar un jugador a la vez
distance2.0Distancia en metros para usar y recoger
clearCommand'clearbags'Comando que borra todas las bolsas dejadas, '' = desactivado
clearGroups{ 'projektleitung' }Grupos que pueden usar el comando (la consola del servidor siempre)

Con enabled = false las bolsas dejadas se quedan en la base de datos. Vuelven en cuanto se activa de nuevo la bolsa.

config/settings/config.lua – Barbería y estudio de tatuajes

Ambos tienen sus propias ubicaciones y blips, el círculo (marker) es el mismo que el de la tienda.

lua
barber = {
  enabled = true,
  price = 150,
  blip = { enabled = true, sprite = 71, color = 0, scale = 0.8 },
  locations = { vec3(-814.3, -183.8, 36.6), ... },
},
OpciónPredeterminadoDescripción
enabledtruefalse = barbería o estudio de tatuajes desactivado por completo
price150 / 500Barbería: precio por categoría modificada · Estudio de tatuajes: precio por tatuaje, 0 = gratis
removePrice250Solo estudio de tatuajes: precio por quitar un tatuaje, 0 = gratis
blipIcono 71 / 75Icono del mapa (enabled, sprite, color, scale)
locations7 / 6 ubicacionesCentro del círculo en el suelo como vec3

El pago se cobra primero en efectivo y el resto del banco. Los precios solo existen en el servidor, el cliente no puede cambiarlos. Los tatuajes se guardan en la tabla off_clothing_tattoos, como máximo 100 por personaje.

config/functions.lua

Aquí conectas tus propios scripts.

FunciónLadoPara qué
Notify(source, message, type)ServidorMensaje a un jugador (bolsa de ropa, /clearbags)
Notify(message, type)ClienteMensaje en el cliente (p. ej. demasiado lejos, sin modelo freemode en el estudio de tatuajes)
HelpNotify(text)ClienteTexto de ayuda en el círculo delante de la tienda, la barbería y el estudio de tatuajes (predeterminado: ESX.ShowHelpNotification)

La versión del servidor envía el mensaje directamente por ESX. Si usas tu propio script de notificaciones, adapta las dos funciones Notify.

Idiomas

Todos los textos están en config/locales/<idioma>.json, la moneda y el formato de números en ui (currency, intl). Para un idioma propio, copia un archivo, tradúcelo y ajusta serverInfo.locale. Los marcadores como %d y {price} tienen que quedarse. Los nombres de las categorías están en config/settings/config.categories.lua (label). Los nombres de las categorías de la barbería y de las zonas del cuerpo están en ui.barber.groups y ui.tattoo.zones, los nombres de los tatuajes vienen de GTA en el idioma del juego.

En el juego

Tienda

Pulsa E en el círculo delante de la tienda, SALIR o ESC cierra.

  • Ropa: cambia prendas y guárdalas como conjunto.
  • Guardados: ponte, renombra, comparte y elimina tus propios conjuntos.
  • Compartidos: ponte conjuntos de otros jugadores.

Bolsa de ropa

  • Dejar: usa el item clothbag en tu inventario, la bolsa se deja en el suelo delante de ti. No funciona en un vehículo, estando muerto ni en otra dimensión.
  • Encima de la bolsa aparece [E] Usar. El dueño ve además [H] Recoger. Si el dueño está desconectado, todos ven [H] Recoger.
  • E abre a la izquierda una lista de tus conjuntos guardados. Ponerse te pone el conjunto, la lista sigue abierta. ESC o SALIR la cierra, igual que si te alejas.
  • H devuelve la bolsa a tu inventario. Puedes cambiar la tecla en las asignaciones de teclas de FiveM.

Barbería

Pulsa E en el círculo delante de la barbería. El sombrero y la máscara se quitan para la vista previa, la cámara muestra la cabeza.

  • Elige la categoría arriba: Pelo, Barba, Cejas, Vello del pecho, Maquillaje, Colorete o Pintalabios.
  • Cambia Forma y Variante con las flechas o haciendo clic en el número, Opacidad con el control deslizante, Color y Mechas en la paleta de colores.
  • Arrastrar gira el personaje, la rueda del ratón hace zoom.
  • Pagar muestra el coste (precio × categorías modificadas) y guarda el look. Cancelar, SALIR o ESC restablece todo lo que aún no está pagado.

Estudio de tatuajes

Pulsa E en el círculo delante del estudio. El personaje se desviste para la vista previa, la ropa vuelve al salir.

  • Elige la zona arriba, la cámara se mueve allí. El número muestra los tatuajes hechos / todos los de la zona.
  • Un clic en un tatuaje lo muestra en el personaje, otro clic lo oculta. Buscar tatuaje filtra por nombre, Míos solo muestra los ya tatuados.
  • Tatuar compra el tatuaje, Quitar elimina un tatuaje hecho por el precio de eliminación.
  • Listo, SALIR o ESC cierra el estudio.

Comandos

ComandoQuiénQué pasa
/clearbagsGrupos de clearGroups, consola del servidorBorra todas las bolsas dejadas. Los dueños que están conectados recuperan su item. Las bolsas de jugadores desconectados solo se borran.

Consola

Al iniciar, el script comprueba la configuración e informa de errores y avisos en la consola del servidor. Si todo está bien, ahí aparece «se ha iniciado correctamente». Si falta este mensaje, lee los errores de arriba, corrígelos y reinicia. Si se crea el item clothbag, la consola también lo indica. Si la barbería o el estudio de tatuajes está activado pero no tiene locations, aparece un aviso.

Problemas frecuentes

ProblemaSolución
No pasa nada con EPonte en el centro del círculo. skinchanger y esx_skin tienen que iniciarse antes.
El círculo flota o está bajo el sueloAjusta la altura (z) en locations.
El look desaparece tras reconectarSolo guardar o ponerse el conjunto mantiene el look, descartar lo restablece todo.
La categoría solo muestra 0 variantesLa prenda no existe para tu modelo de personaje (GTA o addons de ropa).
La bolsa es invisibleRevisa model en config/settings/config.bag.lua, el objeto tiene que existir en GTA.
Falta el item clothbagRevisa la consola. Si el item no se crea, añádelo a mano en la tabla items.
Falta [H] RecogerSolo el dueño puede recoger. Los demás solo cuando el dueño está desconectado.
H no recoge nadaEn las asignaciones de teclas de FiveM, revisa si hay otra tecla asignada a «Recoger bolsa de ropa».
«Ya has dejado una bolsa.»Recoge primero tu propia bolsa o aumenta max.
Faltan tatuajes tras un cambio de skinSe vuelven a aplicar automáticamente poco después. No uses otros scripts que pongan tatuajes por su cuenta.
«Los tatuajes solo están disponibles para personajes normales»Solo mp_m_freemode_01 y mp_f_freemode_01 tienen tatuajes.
Faltan barba y vello del pecho en la barberíaOcultos para personajes femeninos, como en GTA Online.
El look de la barbería desaparece tras reconectarSolo Pagar guarda el look, cancelar lo restablece.

¿Aún no lo has comprado?

Ver Clothingstore en la tienda