Cómo encaja todo#
Trading Cards tiene dos lados. Los jugadores interactúan con él mediante ítems y NPC: compran sobres, los abren, guardan cartas en álbumes, las muestran, las tasan y las intercambian. Los administradores lo configuran todo desde una sola ventana, el creador, que se abre con /cardcreator.
Elemento | Qué es | Dónde se crea |
|---|---|---|
Carta | Un coleccionable: ilustración, nombre, historia, estadísticas. Se entrega como un ítem con los datos de la carta como metadatos. | Creador → Card Creator |
Rareza | Un nivel — sus colores, efectos, con qué frecuencia aparece y como qué ítem se entrega. | Creador → Rarities |
Sobre | Un ítem que, al abrirse, saca un número de cartas de las que tiene asignadas. | La tabla |
Tema | El diseño con el que se dibuja una carta. | Creador → Customize theme |
NPC | Una tienda, un tasador PSA o un comerciante de cartas situado en el mundo. | Creador → Peds |
Cada guardado en el creador se escribe en la base de datos y se envía a todos los jugadores al instante. Nada necesita reiniciarse.
Abrir sobres#
Usar un sobre inicia una barra de progreso (Config.OpeningTime, 2.5 segundos por defecto) con el sobre en las manos del jugador. Al terminar, el sobre se retira del inventario, las cartas se sortean en el servidor, se añaden al inventario y se abre la revelación:
Ábrelo
Desliza la pestaña superior del sobre para rasgarlo.
Da la vuelta a las cartas
Haz clic en cada carta para girarla, o pulsa Reveal all. El fondo brilla con el color de la carta más rara del sobre, y las rarezas holográficas y con destellos relucen al salir. Haz clic en una carta girada para verla de cerca.
Termina
Open Inventory va directamente al inventario para usar el siguiente sobre, y Close termina. Las cartas ya están en el inventario cuando se abre la revelación, así que cerrar antes no hace perder nada.
Cómo se sortean las cartas#
Cada sobre saca sus cartas por sobre (cinco por defecto) de una en una. Para cada una, primero se elige una rareza — ponderada por el Weight de cada rareza, entre las rarezas que realmente tienen cartas en ese sobre — y después se elige al azar una carta de esa rareza del sobre. Las cartas desactivadas nunca aparecen.
Los pesos iniciales son Basic 55, Rare 32 y Legendary 13. Un peso es relativo, no un porcentaje: con solo esas tres rarezas en un sobre, sale una Legendary 13 veces de cada 100 sorteos. Añade una rareza de peso 10 y todas las proporciones se reducen para hacerle sitio.
Usar una carta#
Usar un ítem de carta abre el panel Card Interaction:
Opción | Qué hace |
|---|---|
View o Show | Muestra la carta a pantalla completa. Con |
Store in Album | Lista todos los álbumes que lleva el jugador con sus huecos libres. Elige uno y la carta pasa del inventario a ese álbum. |
El álbum#
tradingcard_stash es una carpeta de 180 huecos, con nueve por página y dos páginas por doble página. Cada ítem de álbum recibe su propio id la primera vez que se usa, así que un jugador puede llevar varios y nunca se mezclan — y un álbum entregado a otra persona se lleva sus cartas consigo.
Control | Qué hace |
|---|---|
Búsqueda | Encuentra una carta por su nombre. |
Chips de rareza | All, o una rareza cada vez. |
Anterior / Siguiente | Pasa la página. |
Clic en una carta | Take la devuelve al inventario como el ítem de su rareza; Show la muestra a los jugadores de tu alrededor, como se indicó arriba. |
Las cartas dentro de un álbum se guardan en la base de datos, no en el ítem, así que un álbum lleno pesa lo mismo que uno vacío y nunca sobrecarga el inventario.
La tienda#
Un NPC de tienda vende todo lo que le asignes — sobres, álbumes o cualquier otro ítem — pagado en efectivo o banco. El jugador habla con el dependiente, mira el estante con su saldo en pantalla, elige un ítem y una cantidad (hasta 10 a la vez) y paga. Los precios se comprueban y se cobran en el servidor.
Una tienda sin ítems propios vende Config.ShopItems: el Booster Pack por 500 y el álbum por 2,500.
Tasación PSA#
Un NPC tasador examina una carta cada vez a cambio de una tarifa. El jugador entrega una carta sin tasar, el tasador la revisa durante el tiempo de inspección, y estampa una calificación de 1 a 10 en medios puntos sobre la propia carta. Una carta tasada muestra su calificación en todos los temas que tienen una capa PSA, y no puede volver a tasarse.
Rango | Calificaciones | Probabilidad por defecto |
|---|---|---|
Malo | 1 – 3 | 30% |
Regular | 3.5 – 6 | 40% |
Bueno | 6.5 – 9.5 | 27% |
Gem mint | 10 | 3% |
El precio (5,000 por defecto), la cuenta a la que se cobra y el tiempo de inspección se configuran en el NPC. Los rangos anteriores son los valores por defecto de todos los tasadores; se pueden sobrescribir por tasador en la columna data de qs_tradingcards_peds.
El comerciante de cartas#
Un NPC comerciante intercambia cartas. Su trato es "N tuyas por M mías": el jugador elige de su inventario las cartas que quiere dar y recibe a cambio las cartas del comerciante, sacadas de su carpeta.
Ajuste | Qué hace |
|---|---|
Cartas que pide | Cuántas cartas debe entregar el jugador (1–20, por defecto 2). |
Cartas que devuelve | Cuántas entrega (1–20, por defecto 1). |
Solo acepta | Cualquier carta, o solo cartas de una rareza. |
Cartas que puede entregar | Todas las cartas del catálogo, o solo las que elijas. |
Dificultad de cartas raras | 0% mantiene los pesos de rareza normales. Cada escalón hacia arriba en la escala de rarezas se vuelve así de menos probable, de modo que 100% significa que solo salen las cartas más comunes. Por defecto, 50%. |
El creador#
/cardcreator abre el creador para cualquiera con acceso (consulta Instalación). Tiene cuatro pestañas y se abre en Peds.
Pestaña | Para qué sirve |
|---|---|
Peds | Colocar y configurar los NPC de tienda, tasador y comerciante. |
Card Creator | Todas las cartas: crearlas, editarlas, activarlas, eliminarlas y entregarlas. |
Rarities | Los niveles de rareza, su aspecto, su peso y su ítem. |
Customize theme | El editor de temas. |
Peds#
Pulsa + para crear un NPC y rellena sus secciones:
Sección | Qué configuras |
|---|---|
Qué es | El rol (Shop, PSA Grader o Card Trader), una etiqueta que se muestra en el aviso y en el blip, el modelo del ped y una animación en reposo. |
Dónde está | Place in the world oculta la ventana y coloca un fantasma translúcido del ped donde apuntas: |
Blip del mapa | Mostrarlo en el mapa, su icono, tamaño y color. |
Stock (tienda) | Cuenta de pago y una lista de ítems, cada uno con la etiqueta con la que se muestra y su precio. |
Tasación (tasador) | Precio por carta, cuenta de pago y tiempo de inspección. |
Intercambio (comerciante) | Los ajustes del comerciante descritos arriba. |
Disponibilidad | Desactiva un NPC para mantenerlo guardado sin que aparezca. |
Los jugadores interactúan con un NPC mediante un aviso [E] a 3 metros, o a través de tu recurso de target con Config.UseTarget. El servidor rechaza cualquier compra, tasación o intercambio a más de 5 metros de distancia.
Card Creator#
Una lista con búsqueda de todas las cartas a la izquierda, el formulario en el centro y una vista previa en vivo a la derecha, dibujada con el tema que esa carta usará realmente.
Sección | Campos |
|---|---|
Identidad | Nombre de la carta, rareza y URL de la ilustración. |
Estadísticas | Salud, ataque, altura y peso. |
Historia | La descripción impresa en el cuerpo de la carta y una línea secundaria opcional. |
Ajustes de aparición | El sobre en el que aparece, su tema de carta (o el predeterminado de la rareza), su calidad (0–100) y Available in packs. |
Give entrega una carta guardada a cualquier jugador conectado por su server id — o a ti mismo — como el ítem de su rareza. Delete elimina una carta del catálogo: las copias que ya tienen los jugadores siguen funcionando, simplemente no vuelve a aparecer. Para conservarla pero impedir que aparezca, desactiva Available in packs en su lugar.
Rarities#
Sección | Campos |
|---|---|
Identidad | El id (no puede cambiarse una vez que las cartas lo usan), el nombre y el ítem de inventario con el que se entregan sus cartas. |
Aspecto | Cuatro colores que leen todos los temas, el color y el grosor del borde, Holographic (capas de brillo holográfico, barrido metalizado y prisma) y Sparkling (capas de destellos y el resplandor cuando la carta sale de un sobre). |
Apariciones | El peso frente a las demás rarezas y el tema predeterminado de sus cartas. |
El orden de la lista es la escala de rarezas, de la más común a la más rara: decide qué carta ilumina un sobre y cómo se aplica la dificultad del comerciante. Una rareza nueva se añade en lo alto de la escala.
Customize theme#
El editor de temas construye el diseño de la carta a partir de capas, dibujadas en un lienzo al tamaño real de la carta con una vista previa de la rareza que elijas.
Capa | Qué dibuja |
|---|---|
Forma | Un rectángulo o una elipse con relleno sólido, lineal, radial o cónico, un borde, una sombra y desenfoque. |
Texto | Un texto fijo, o vinculado a la carta: nombre, rareza, historia, línea secundaria, salud, ataque, altura, peso, calidad, calificación PSA, número de serie o número de carta — con fuente, tamaño, grosor, alineación, relleno en degradado y sombra. |
Imagen | La ilustración de la propia carta o una URL fija, con cover, contain o stretch, filtros y un fundido hacia la carta. |
Icono | Uno de catorce iconos — corazón, espada, escudo, estrella, rayo, fuego, calavera, corona, gema y más. |
Efecto | Brillo holográfico, barrido metalizado, destellos, prisma giratorio, resplandor en los bordes, líneas de escaneo, grano o viñeta. |
Cualquier color puede ser un color fijo o uno de los tokens de rareza (colores 1–4 y el borde), así que un mismo tema sirve para todas las rarezas. Cada capa puede limitarse a algunas rarezas, o mostrarse solo una vez tasada o solo mientras no esté tasada — así es como aparece la funda PSA en una carta tasada. Las capas se pueden renombrar, ocultar, bloquear, duplicar y reordenar, y las teclas de flecha mueven la seleccionada (Shift para pasos más grandes).
Se incluyen tres temas integrados — Quasar Classic, Neon Prism y Royal Foil. No se pueden eliminar; usa Duplicate en uno para crear tu propia versión. Eliminar uno de tus temas devuelve al predeterminado todas las cartas y rarezas que lo usaban.
Sobres#
En el primer inicio se crean dos sobres: Booster Pack (tradingcard_booster_pack) y Legends Pack (tradingcard_booster_legends), de cinco cartas cada uno. Una carta pertenece exactamente a un sobre, elegido en sus Ajustes de aparición.
Los sobres son filas de qs_tradingcards_boosters, que se leen al iniciar. Para añadir uno, inserta una fila con su ítem, etiqueta y cartas por sobre, añade ese ítem a tu inventario, reinicia el recurso y asígnale cartas en el creador:
INSERT INTO qs_tradingcards_boosters (id, item, label, image, zip_image, cards, sort_order)
VALUES ('halloween', 'tradingcard_booster_halloween', 'Halloween Pack', 'opened-pack.png', 'zip_of_pack.png', 3, 3);image y zip_image son la ilustración del sobre en la revelación: uno de los nombres de archivo incluidos, o una URL https:// completa que apunte a la tuya.
Misiones#
Con qs-inventory en ejecución, cada jugador recibe dos misiones en su libro de misiones: Card Collector (abrir sobres) y PSA Grading (tasar una carta), con recompensas de 200 y 250. Sin qs-inventory esto se omite sin avisar.