Instalación

Unos cinco minutos, y un reinicio completo del servidor al final. El único paso en el que la gente se equivoca es el orden de las líneas en server.cfg — lee el paso 3 dos veces.

Antes de empezar

Necesitas	Por qué
oxmysql, en marcha	Los diseños, ítems y conjuntos se guardan en la base de datos
ox_lib	Los callbacks y las notificaciones del estudio
ESX, QBCore o QBox (opcional)	Solo para los ítems que se pueden poner. Sin ninguno, el estudio funciona en standalone
ox_inventory (opcional)	Tiene preferencia para los ítems cuando está en marcha
Una clave de API de Gemini (opcional)	Solo para el generador con IA — gratis en aistudio.google.com/apikey
Un token de Fivemanage (opcional)	Aloja las fotos de los diseños y de los ítems — gratis en fivemanage.com

1. Coloca las dos carpetas

El paquete contiene dos recursos. Ponlos los dos, uno al lado del otro, en tus recursos — por ejemplo resources/[mic]/mic_cloth_designer y resources/[mic]/mic_cloth_addons.

2. La base de datos — no tienes que hacer nada

Las tablas se crean solas en el primer arranque: mic_cloth_designs y mic_cloth_imported para los diseños, mic_cloth_items para los ítems y los conjuntos.

mic_cloth_designs.sql viene en la raíz de mic_cloth_designer para quien prefiera crear las dos primeras a mano. No lo necesitas.

3. server.cfg — el orden importa

Dos grupos de líneas separados, en dos sitios.

Cerca del principio de server.cfg, por encima de cualquier ensure:

dale al recurso mic_cloth_designer los ACE command.refresh, command.ensure, command.start y command.stop (cuatro líneas add_ace resource.mic_cloth_designer … allow) — el propio estudio reinicia mic_cloth_addons después de que exportes una prenda;
añade el permiso de sistema de archivos que permite a mic_cloth_designer escribir en mic_cloth_addons (add_filesystem_permission mic_cloth_designer write mic_cloth_addons);
dale a quien vaya a usar el estudio el ACE mic_clothdesigner — por ejemplo a group.admin, o al identifier.discord:… de una persona.

Más abajo, con el resto de tus recursos: ensure oxmysql, luego ox_lib, luego mic_cloth_addons, luego mic_cloth_designer. Un ensure [mic] que cubra los dos también vale, siempre que vaya después del bloque de arriba.

¿Solo quieres probarlo? Pon Config.OpenPermission = false en shared/config.lua y cualquiera podrá abrir el estudio — el permiso de escritura sigue siendo necesario.

4. Tus claves

Abre mic_cloth_designer/shared/keys.lua. Es un archivo solo del servidor: nada de lo que contiene se envía nunca a un jugador. Rellena lo que uses y deja el resto como comillas vacías.

Clave	Qué hace	¿Necesaria?
`GeminiAPIKey`	El generador de texturas con IA	Solo para la IA. Vacía = la herramienta de IA está desactivada
`FivemanageToken`	Aloja las fotos de los diseños y de los ítems	Recomendada. Vacía = las fotos se guardan en la base de datos
`DiscordWebhook`	Registra cada generación con IA con su coste estimado	Opcional
`ClothNetworkKey`	Déjala vacía. La Cloth Network funciona sin ella	No

5. Ítems

Un único ítem genérico lleva cualquier diseño: cloth_design (el nombre es Config.Items.Name en shared/config.lua).

Ítem	Qué hace
`cloth_design`	Pone el diseño guardado en él; úsalo otra vez para volver a lo que llevabas puesto

Las definiciones vienen en mic_cloth_designer/items/:

Archivo	Para
`items/ox.lua`	ox_inventory — va en `ox_inventory/data/items.lua`
`items/qb.lua`	QBCore — va en `qb-core/shared/items.lua`

No viene ninguna imagen para él: en ox_inventory cada ítem muestra el render de su propio diseño. En QBCore, pon un cloth_design.png en qb-inventory/html/images/ si quieres un icono por defecto. En ESX sin ox_inventory, añade un ítem llamado cloth_design a tus ítems como añadirías cualquier otro.

Los diseños que vendas en tiendas tendrán más adelante sus propios nombres de ítem — consulta 🎒 Ítems.

6. Framework

No hay nada que cambiar. El bridge de ítems encuentra qb-core o es_extended por sí solo y usa ox_inventory cuando está en marcha. Pon Config.Framework en shared/config.lua a 'qb' o 'esx' según tu servidor.

En QBox, el bridge lo encuentra a través de su compatibilidad con QBCore — qbx_core proporciona qb-core — y Config.Framework se queda en 'qb': QBox ejecuta recursos de QBCore mediante su capa de compatibilidad.

Standalone también funciona. Sin framework, el estudio, la vista previa en 3D, el generador con IA y la Cloth Network funcionan como siempre; solo hace falta el permiso ACE para abrirlo. Deja Config.Framework en 'qb'. Los ítems que se pueden poner son la única parte que necesita ESX, QBCore o QBox.

7. Reinicio completo, y luego el primer diseño

Reinicia el servidor entero, no solo el recurso: GTA lee los datos de la ropa cuando arranca el servidor.

En el juego, escribe /clothdesigner.
Elige una prenda de la Library, pinta algo y pulsa Save.

Ha funcionado si el estudio se abre con la Library, la vista previa en 3D y el editor uno al lado del otro, Save responde Saved, y tu personaje lleva puesta la prenda con tu diseño.

Para volver a ponértela más tarde, conviértela en un ítem — consulta 🎒 Ítems.

Antes de abrir tu ciudad

Desactiva Config.Debug en shared/config.lua. Viene activado e imprime cada paso en la consola.
Decide qué hacer con Config.GlobalContent. Activado (por defecto), todos los que tienen acceso al estudio ven y editan todos los diseños, ítems y conjuntos.
Mantén shared/keys.lua en privado. Contiene tu clave de Gemini, tu token de Fivemanage y tu webhook. Vacíalo antes de pasarle tus archivos a nadie.
Comprueba quién tiene mic_clothdesigner. Con una clave de Gemini puesta, cada generación con IA se te factura a ti.