
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.
- 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.
/clearbagsretira 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
- Pon la carpeta
off_clothingstoreen tu carpetaresources. - En el
server.cfg, después de oxmysql, ESX y skinchanger:
ensure oxmysql
ensure es_extended
ensure skinchanger
ensure esx_skin
ensure off_clothingstore- Quita
esx_clotheshopu otras tiendas de ropa en los mismos lugares.
En el primer inicio, el script crea automáticamente:
- las tablas
off_clothing_outfits,off_clothing_bagsyoff_clothing_tattoos - el item
clothbagen la tablaitems, si falta
Configuración
config/settings/config.lua
| Opción | Predeterminado | Descripció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.design | 3 | Diseño de la interfaz: 1 = Clásico, 2 = Ticket, 3 = Storefront |
blur | true | Fondo desenfocado mientras el menú de la bolsa está abierto. La tienda sigue nítida porque ahí ves a tu propio personaje |
outfitPrice | 250 | Precio por conjunto guardado (efectivo), 0 = gratis |
maxOutfits | 25 | Máx. de conjuntos por personaje |
marker | Disco, 3 m | Círculo: type, size (zona para abrir), drawDistance, color, alpha |
blip | Icono 73 | Icono del mapa (enabled, sprite, color, scale) |
locations | 14 tiendas | Centro del círculo en el suelo como vec3 |
barber | activado, 7 ubicaciones | Barbería, ver abajo |
tattoo | activado, 6 ubicaciones | Estudio 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.
{ icon = 'shoes', label = 'Schuhe', variant = 'shoes_1', color = 'shoes_2', camOffset = vec3(0, 0.9, -0.8) },| Campo | Descripción |
|---|---|
icon | bag, chain, earrings, glasses, gloves, hat, jacket, mask, ring, shirt, shoes, shorts, vest, watch o un icono de Phosphor con ph- |
label | Nombre en la tienda |
variant / color | Valores de skinchanger para Variante y Estilo |
camOffset | Cámara: x = izquierda/derecha, y = distancia hacia delante, z = altura |
config/settings/config.bag.lua – Bolsa de ropa
| Opción | Predeterminado | Descripción |
|---|---|---|
enabled | true | false = bolsa de ropa desactivada por completo (sin item, sin bolsas) |
item | 'clothbag' | Nombre del item, se crea al iniciar en la tabla items |
weight | 1 | Peso del item |
model | 'prop_cs_heist_bag_02' | Objeto de la bolsa en el suelo |
max | 1 | Cuántas bolsas puede dejar un jugador a la vez |
distance | 2.0 | Distancia 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.
barber = {
enabled = true,
price = 150,
blip = { enabled = true, sprite = 71, color = 0, scale = 0.8 },
locations = { vec3(-814.3, -183.8, 36.6), ... },
},| Opción | Predeterminado | Descripción |
|---|---|---|
enabled | true | false = barbería o estudio de tatuajes desactivado por completo |
price | 150 / 500 | Barbería: precio por categoría modificada · Estudio de tatuajes: precio por tatuaje, 0 = gratis |
removePrice | 250 | Solo estudio de tatuajes: precio por quitar un tatuaje, 0 = gratis |
blip | Icono 71 / 75 | Icono del mapa (enabled, sprite, color, scale) |
locations | 7 / 6 ubicaciones | Centro 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ón | Lado | Para qué |
|---|---|---|
Notify(source, message, type) | Servidor | Mensaje a un jugador (bolsa de ropa, /clearbags) |
Notify(message, type) | Cliente | Mensaje en el cliente (p. ej. demasiado lejos, sin modelo freemode en el estudio de tatuajes) |
HelpNotify(text) | Cliente | Texto 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
clothbagen 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
| Comando | Quién | Qué pasa |
|---|---|---|
/clearbags | Grupos de clearGroups, consola del servidor | Borra 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
| Problema | Solución |
|---|---|
| No pasa nada con E | Ponte en el centro del círculo. skinchanger y esx_skin tienen que iniciarse antes. |
| El círculo flota o está bajo el suelo | Ajusta la altura (z) en locations. |
| El look desaparece tras reconectar | Solo guardar o ponerse el conjunto mantiene el look, descartar lo restablece todo. |
| La categoría solo muestra 0 variantes | La prenda no existe para tu modelo de personaje (GTA o addons de ropa). |
| La bolsa es invisible | Revisa model en config/settings/config.bag.lua, el objeto tiene que existir en GTA. |
Falta el item clothbag | Revisa la consola. Si el item no se crea, añádelo a mano en la tabla items. |
| Falta [H] Recoger | Solo el dueño puede recoger. Los demás solo cuando el dueño está desconectado. |
| H no recoge nada | En 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 skin | Se 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ía | Ocultos para personajes femeninos, como en GTA Online. |
| El look de la barbería desaparece tras reconectar | Solo Pagar guarda el look, cancelar lo restablece. |
¿Aún no lo has comprado?
Ver Clothingstore en la tienda