Lo que falla con más frecuencia, lo que significa realmente y qué hacer al respecto. La mayoría son cuestiones de configuración, no fallos — y el script dice cuáles: las comprobaciones de inicio en la consola del servidor, tattoo_shop para un estudio, y tattoo_ink_debug en F8 para lo que ve un cliente. Ejecuta el que corresponda antes de abrir un ticket.
Instalación e inicio#
La consola repite "server.cfg is missing required permissions"
Faltan las cinco líneas add_ace. Los tatuajes de los jugadores no se ven afectados, pero las exportaciones al catálogo se rechazan hasta que estén, y los admins ven un aviso al abrir el panel. Añádelas encima de ensure qs-tattoo-creator — o pégalas en la consola del servidor, lo que lo soluciona al momento:
add_ace resource.qs-tattoo-creator command.ensure allow
add_ace resource.qs-tattoo-creator command.start allow
add_ace resource.qs-tattoo-creator command.stop allow
add_ace resource.qs-tattoo-creator command.restart allow
add_ace resource.qs-tattoo-creator command.refresh allow✗ Preview collection
qs-tattoo-preview no está en ejecución. Viene en la descarga junto a qs-tattoo-creator; vuelve a ponerlo si falta y añade ensure qs-tattoo-preview encima de ensure qs-tattoo-creator.
✗ Ink slot pool — "rewrote it"
La colección en la que se dibuja cada tatuaje puesto no coincidía con lo que espera el script — normalmente tras una actualización — así que se reescribió. El juego solo la lee cuando qs-tattoo-preview se inicia: reinicia el servidor una vez, o reinicia qs-tattoo-preview mientras no haya nadie conectado. Hasta entonces no se puede mostrar ningún tatuaje. Si la línea dice que no pudo reescribirla, la carpeta qs-tattoo-preview falta o no tiene permisos de escritura.
✗ C# encoder — los jugadores ven "The tattoo machine is out of order"
El script incluye un pequeño componente de C# en server/dotnet/ que se ejecuta en el runtime Mono integrado del servidor. Cuando falla su autocomprobación, los jugadores no pueden pagar tatuajes en un estudio y no se pueden hacer exportaciones al catálogo. Vuelve a copiar toda la carpeta qs-tattoo-creator — los archivos server/dotnet/templates deben estar ahí — y asegúrate de que el artifact de tu servidor esté actualizado. Una línea ✗ File helper es el mismo componente sin responder en absoluto.
✗ Data folder o ✗ Data writable
El script no pudo crear ni escribir qs-tattoo-data junto a sí mismo, así que no se puede guardar ningún tatuaje. En Linux, asegúrate de que el usuario que ejecuta el servidor sea el propietario de la carpeta de recursos. Si la línea dice que la carpeta "could not be started", reinicia el servidor una vez.
✗ Studio undress list
Config.Studio.Reveal falta en tu custom/config.lua — normalmente una copia antigua conservada tras una actualización. El estudio se abre entonces sin quitar ninguna prenda. Copia el bloque del custom/config.lua que venía con tu versión.
"could not create qs_tattoo_settings" o "the server never sent its settings"
El usuario de la base de datos no puede crear tablas, así que la configuración no se puede guardar y el servidor funciona con los valores predeterminados incluidos. Dale al usuario permiso para crear tablas, o ejecuta [sql]/database.sql a mano, y luego reinicia.
"You don't have permission to do that." en /tattoocreator
Los admins son quienes tu framework considere admin: en ESX un grupo de Config.AdminGroups, en QBCore y Qbox el permiso god o admin o el ace command, en standalone el ace command. Un ace añadido a server.cfg necesita un reinicio del servidor, y debe ser para la misma cuenta con la que juegas.
Los tatuajes vuelven lentamente tras un cambio de ropa, o se usa el script de apariencia equivocado
El script de apariencia se inicia después de Tattoo Creator, así que no se detectó. Mueve su ensure encima de ensure qs-tattoo-creator. Con dos scripts de apariencia instalados, indica el que usan los jugadores en Config.AppearancePin.
Estudios y el estudio#
No aparece nada en un estudio — ni NPC ni aviso
Un estudio solo existe mientras hay un jugador dentro de su área. Ejecuta tattoo_shop en la consola: no studio area (nothing will spawn) significa que el área nunca se dibujó, y la consola F8 dice lo mismo. Dibújala en el formulario del estudio y guarda.
"You need a tattoo artist for that."
Settings → Shops → Self service está desactivado, así que los clientes no pueden usar el NPC por su cuenta. Actívalo, o haz que un artista los invite.
"This shop is closed."
El estudio está en Closed — en su formulario del panel de administración, o por su propietario en el menú de gestión → Settings → Open to customers.
"The shop is out of supplies."
Un estudio gestionado por jugadores se quedó sin tinta, agujas o guantes. Pide más desde el menú de gestión → Supplies y recoge la caja, o desactiva Settings → Shops → Block when empty para que los suministros sean solo estéticos.
"The studio only works with the standard character models."
Los tatuajes son decoraciones de ped de GTA, que solo existen para los personajes freemode mp_m_freemode_01 y mp_f_freemode_01. Un jugador que use otro modelo de ped no se puede tatuar.
"You are too far from the shop."
El estudio se abre a menos de 12 m de su puesto de tatuaje, o del NPC cuando no hay puesto. Si el puesto se colocó lejos del NPC, mueve uno de los dos.
El personaje conserva algo de ropa en el estudio
Un pack de ropa reemplazó la ropa de cuerpo desnudo del juego base, así que el estudio cambia una prenda por otra. Indica los números que ese pack dejó libres en Config.Studio.Reveal — consulta Integraciones.
Un diseño desapareció al cerrar el estudio
Cerrar el estudio descarta todo lo que no se haya pagado. La pestaña History guarda las últimas 80 cosas que un jugador se puso en el cuerpo, pagadas o no, y recupera cualquiera de ellas con un clic.
Tatuajes en el personaje#
Un tatuaje desaparece tras cambiarse de ropa
El script de ropa lo borró y nada lo volvió a poner. Comprueba que se detectó el script de apariencia correcto (ver arriba); con illenium-appearance, activa Config.RCoreTattoosCompatibility = true en su configuración. Si tu propio script reconstruye el personaje, llama a exports['qs-tattoo-creator']:ReapplyTattoos() cuando termine. El vigilante de Settings → Re-apply detecta cualquier otra cosa en segundos.
Otros jugadores no pueden ver mi tatuaje
Ejecuta tattoo_ink_debug en F8 en el jugador que no lo ve. Su última línea indica la causa: una colección que no está montada (reinicia qs-tattoo-preview una vez con el servidor vacío), imágenes todavía en camino, o el juego rechazando una decoración. Los tatuajes se muestran dentro del Show radius (45 m); en un lugar muy concurrido, los portadores más lejanos se muestran al final.
"This character already has ink on the maximum number of body parts."
Settings → Ink & textures → Body parts per character limita cuántas de las seis partes del cuerpo pueden llevar tinta a la vez.
"Too many tattoos on this zone."
Una parte del cuerpo admite como máximo 8 tatuajes. Combina algunos en un solo diseño con capas, o quita uno.
"This zone is still being inked, try again in a moment."
El cambio anterior en esa parte del cuerpo todavía se está guardando. Espera un segundo y vuelve a pagar.
"The tattoo could not be saved" o "The server could not store the image"
El servidor no pudo escribir en qs-tattoo-data. Las comprobaciones de inicio dicen por qué; casi siempre son los permisos de la carpeta. El dinero del jugador se le devuelve automáticamente.
Estudios gestionados por jugadores#
El puesto de tatuaje solo dice "Clock in from the management menu before you can tattoo"
Primero ficha la entrada desde el menú de gestión. Un rango sin Open the management menu — el Apprentice predeterminado — nunca puede fichar: dale ese permiso al rango, o desactiva Settings → Shops → Clock in to tattoo.
Invitar a un cliente no hace nada, o dice que está demasiado lejos
El cliente debe estar a menos de 4 m del artista, no estar ya en otra sesión, y el puesto debe estar libre — una sesión por estudio a la vez ("That spot is in use."). El artista debe estar de servicio en este estudio.
"You do not work here." o "Your rank does not allow that."
El jugador no está en el personal de ese estudio, o su rango no tiene el permiso para esa pestaña o acción. Los rangos son por estudio. tattoo_shop muestra quién está en el personal y de servicio.
"This studio is not a company."
El interruptor Company del estudio está desactivado, así que no tiene propietario, personal ni menú de gestión. Actívalo en el formulario del estudio.
No se pagó al personal
Los sueldos salen de la caja del estudio en cada intervalo de nómina, y solo para el personal de servicio en ese momento. Una caja que no puede cubrir un sueldo no paga nada y avisa al trabajador "The till could not cover your wage." — deposita dinero en ella.
"This shop has no supply delivery point set."
Coloca el punto Supply delivery en el formulario del estudio; sin él no se pueden hacer pedidos.
Nadie puede recoger la caja de suministros
Solo el personal de ese estudio puede recogerla, a menos de 2 m. Una caja que llegó cuando no había nadie cerca aparece en cuanto alguien entra en el estudio.
Imágenes y el catálogo#
Se rechaza un enlace de imagen
Mensaje | Significa |
|---|---|
Images from that site are not allowed. | Allow any host está desactivado y el sitio no está en |
That link points at the server itself or its local network… | El enlace lleva a tu propia máquina o LAN. Siempre se rechaza. |
Could not download the image. | El sitio no respondió, o rechazó al servidor. |
Unsupported image format. | Solo se aceptan PNG, JPG, WEBP y GIF. |
Image links are disabled. | Settings → Images → Allow image links está desactivado. |
Se rechaza una exportación al catálogo
Faltan las líneas add_ace — el admin ve un aviso rojo y las líneas se muestran en F8 y en la consola del servidor — o el componente de C# falló su comprobación de inicio.
Los jugadores crashearon durante una exportación al catálogo
Exportar, reemplazar o eliminar una entrada del catálogo reinicia qs-tattoo-data, lo que puede hacer crashear a los jugadores que estén cargando en ese momento. Hazlo con el servidor vacío. Los tatuajes de los jugadores nunca lo necesitan.
Un tatuaje exportado no aparece en el menú de apariencia
Comprueba que el script figura en server/custom/appearance.lua y que el archivo indicado ahí es uno que carga. La consola del servidor avisa cuando no pudo actualizar ese archivo.
Claves de error#
Cada rechazo es una clave de locale, así que el mismo fallo se lee en el idioma de cada jugador. Las que es más probable que encuentres:
Clave | Significa |
|---|---|
| El componente de C# falló su comprobación de inicio. Ver arriba. |
| Faltan las líneas |
| El estudio se quedó sin suministros. |
| El estudio está cerrado. |
| Los clientes no pueden usar el NPC por su cuenta; necesitan un artista. |
| El jugador está demasiado lejos del estudio, o el cliente del artista. |
| El jugador no puede pagarlo — en la cuenta que eligió. |
| No está en el personal de ese estudio · el rango no lo permite. |
| El artista tiene que fichar primero. |
| El puesto de tatuaje del estudio ya está en uso. |
| La caja del estudio no tiene tanto dinero. |
| Límite de partes del cuerpo por personaje alcanzado · 8 tatuajes en esa parte del cuerpo. |
|
|
| Demasiadas subidas en un minuto. Espera un momento. |
| El servidor no respondió a tiempo. Normalmente, una base de datos lenta. |
¿Sigues atascado? Abre un ticket e incluye las líneas de inicio de la consola de tu servidor, la salida de
tattoo_shopotattoo_ink_debugsi se trata de un estudio o de un tatuaje visible, y tu framework y script de apariencia con sus versiones.