Lo que falla con más frecuencia, lo que realmente significa y qué hacer al respecto. La mayoría de estos casos son de configuración, no fallos. Activa Config.Debug mientras investigas: la consola del servidor imprimirá entonces una línea [DEBUG] por cada rechazo con su motivo.
Instalación e inicio#
"No inventory found" y el recurso se detiene
Ninguno de los inventarios compatibles estaba en ejecución cuando Trading Cards se inició. Asegúrate de que el ensure de tu inventario esté por encima de ensure qs-tradingcards en server.cfg. Si tu inventario ha sido renombrado, fuérzalo en shared/config.lua — consulta Integraciones.
"You have renamed the script!" y la consola se congela
La carpeta no se llama qs-tradingcards. Esto es intencionado y no se puede evitar: devuelve a la carpeta su nombre original y reinicia el servidor.
"No cards found" en la consola
El catálogo está vacío. Importa database/sql.sql para las 82 cartas iniciales, o crea cartas en /cardcreator → Card Creator.
No se detecta el framework y se usa el puente standalone
El framework se inicia después de Trading Cards. Mueve ensure qs-tradingcards debajo de él, o configura Config.Framework manualmente.
La interfaz está en el idioma equivocado
Config.Language lee la convar qs:locale y, si no está, recurre al español. Añade setr qs:locale "en" (o tu código) a server.cfg. Un código sin archivo en locales/ imprime Locale "xx" not found, using en.
Sobres y cartas#
"This booster pack could not be opened"
Activa Config.Debug y lee el motivo en la consola del servidor:
Booster has no cards assigned to it — ninguna carta habilitada tiene ese sobre en su Drop settings. Asigna algunas en el creador.
Unknown booster item — el objeto no es una fila de
qs_tradingcards_boosters. Añádelo y reinicia el recurso.Player tried to open a booster they do not own — el sobre ya no estaba en el inventario, normalmente por un segundo uso antes de que terminara el primero.
Rarity has no inventory item configured — la rareza de una carta no tiene objeto; asigna uno en Rarities.
Usar una carta, un sobre o el álbum no hace nada
El objeto no está registrado como usable. Comprueba que existe en tu inventario con exactamente el mismo nombre y, en ESX o QBCore, que está marcado como usable. En ox_inventory sin framework, añade server = { export = 'qs-tradingcards.useItem' } a cada objeto — consulta Integraciones.
Una carta que creé nunca sale
Comprueba que Available in packs esté activado, que esté asignada al sobre que se abre y que el peso de su rareza sea mayor que 0. Con los pesos iniciales sale una Legendary aproximadamente una de cada ocho cartas, así que una sola carta entre muchas es rara por diseño.
Las cartas no muestran icono en el inventario
Copia los PNG de [img] a la carpeta de imágenes de tu inventario, con el nombre de los objetos. Una rareza que crees también necesita un icono para su objeto.
El sobre, el álbum o la carta no aparece en las manos del jugador
tradingcards_props no está iniciado, o se inicia después de Trading Cards. Añade ensure tradingcards_props por encima de ensure qs-tradingcards.
La ilustración de la carta no carga
La URL de la ilustración no es un enlace directo a una imagen, o el host bloquea el hot-linking. Abre la URL en un navegador: debe mostrar solo la imagen. Vuelve a alojarla en un servicio que permita incrustarla.
Álbumes#
"No albums available in your inventory"
El jugador no tiene tradingcard_stash, o no se pudo asignar un id al objeto. Comprueba que el objeto existe en tu inventario y que es único / no apilable — los álbumes apilados comparten un mismo conjunto de metadatos.
"No available slots in this album"
Las 180 ranuras están llenas. Saca cartas o usa otro álbum.
No se pudo sacar una carta del álbum
El álbum ya no está en el inventario del jugador, o la rareza de la carta se ha eliminado y no hay objeto con el que devolverla. El álbum se actualiza para mostrar lo que realmente contiene.
NPCs y el creador#
"You do not have permission to use this command..."
El jugador no tiene ni el ace command.cardcreator ni uno de los grupos de Config.CardCreator.adminGroups. Añade add_ace group.admin command.cardcreator allow a server.cfg y reinicia el recurso. En standalone, los grupos se leen como aces, así que el jugador debe estar en group.admin.
No hay tienda, tasador ni comerciante en el mundo
Una instalación nueva no tiene NPCs: colócalos en /cardcreator → Peds. Un NPC desactivado en Availability sigue guardado pero no aparece.
"You are too far from this NPC"
El servidor comprueba que el jugador esté a menos de 5 metros de la posición guardada del NPC. Si moviste el NPC, guárdalo de nuevo para que la posición guardada coincida con donde está.
"That ped model could not be loaded"
El nombre del modelo es incorrecto o no se transmite en tu servidor. Usa un nombre de modelo de ped válido, como u_m_y_pogo_01.
El aviso [E] no aparece con Config.UseTarget activado
Es lo correcto: con un recurso de target, el aviso se sustituye por una opción de tercer ojo. Si no hay ningún target en ejecución, la consola lo indica y el aviso vuelve.
No se puede cambiar el objeto de una rareza, o no se puede eliminar la rareza
Comportamiento correcto. En cuanto alguna carta usa una rareza, su objeto queda bloqueado, y no se puede eliminar mientras haya cartas que apunten a ella. Mueve antes esas cartas a otra rareza. La última rareza nunca se puede eliminar.
No se puede eliminar un tema integrado
Comportamiento correcto. Duplícalo, edita la copia y establece la copia como predeterminada en tus rarezas.
Tienda y tasación#
"That runs $… and you are short"
El jugador no puede pagarlo con la cuenta que cobra el NPC — efectivo o banco, configurada en el NPC. En standalone, ambas cuentas leen el objeto money.
El tasador dice que no hay nada que tasar
Solo se ofrecen las cartas sin tasar del propio inventario del jugador. Las cartas dentro de un álbum y las ya tasadas no.
Códigos de error#
Los callbacks responden con un código corto en lugar de una frase. Los verás en las líneas [DEBUG] y en tus propios scripts:
Código | Significado |
|---|---|
| El jugador lanzó una segunda petición antes de que terminara la primera. |
| El jugador no tiene el objeto, o una rareza no tiene objeto de inventario. |
| El objeto del sobre no es una fila de |
| Ninguna carta habilitada está asignada a ese sobre. |
| El jugador está a más de 5 metros del NPC. |
| El NPC, la carta o la rareza no existe, o está desactivado. |
| El jugador no puede pagarlo con esa cuenta. |
| La carta ya tiene una calificación PSA. |
| Las cartas ofrecidas al comerciante no coinciden con su trato. |
| El comerciante no tiene cartas habilitadas para dar. |
| Una acción del creador sin acceso al creador. |
| Un cambio de rareza rechazado, como se describe arriba. |
| Un intento de eliminar un tema integrado. |
| Give se envió a un id de servidor sin nadie conectado. |
¿Sigues atascado? Abre un ticket con la salida de tu consola desde el inicio (con
Config.Debug = true), tu framework e inventario con sus versiones, y una captura de pantalla de la consola F8 para cualquier cosa relacionada con la interfaz.