---
title: "Multijugador"
description: "Deja que tus amigos jueguen tu carta juntos: una historia compartida que la IA narra para todos, o una partida con reglas y la IA en los asientos libres. Apagado hasta que lo actives."
---

# Multijugador

El multijugador deja que tus amigos jueguen tu carta juntos. Viene apagado: una carta no muestra ninguna forma de jugar en grupo hasta que lo activas.

En el lienzo, pulsa **Esta carta**. Los **Ajustes de la carta** se abren a la derecha; baja hasta **Multijugador** y actívalo. La tarjeta **Portada y resumen** del lienzo también lleva aquí: con el multijugador apagado muestra un botón punteado **Multijugador** que abre estos ajustes; una vez activado muestra las imágenes de los papeles y **Multijugador 2–6**, y al pulsarlo vuelves aquí. En el **Modo Completo** (menú ⋮) también está en **Ajustes de la carta**.

Los jugadores ven una insignia **Multijugador** en la carta y un botón **Jugar con amigos** junto a **Empezar a jugar**. Los amigos solo entran por invitación: desde la lista de amigos, un enlace o un código corto.

## Cuál elegir

- **Historia en grupo**: una historia, una aventura, una escena de rol de mesa. Cada uno escribe lo que hace y la IA de tu carta cuenta la historia para todos. No hay nada que construir; tu carta funciona tal cual.
- **Partida con reglas**: un juego de cartas, de tablero, de faroles, de votaciones. Un archivo de reglas decide qué está permitido y quién gana, y la interfaz de tu carta es la mesa. Elige esto cuando el juego tiene reglas exactas.

## Historia en grupo

**Jugadores**: de 2 a 12. Por defecto, de 2 a 6.

En cada ronda, cada uno escribe lo que hace. Cuando todos están listos (o el anfitrión pulsa enviar), la IA recibe un turno con todas las acciones, cada línea empezando por el nombre del jugador, y escribe una sola respuesta para toda la mesa.

Los **Papeles a elegir** son opcionales: sin ellos, cada jugador entra con su persona actual, y la IA conoce el nombre y la descripción de la persona de cada uno. Añade los papeles que puede tomar un jugador, de tus personajes en **Personaje y mundo** o con un nombre suelto, con una nota de una línea. Activa **Elegir papel es obligatorio** para que cada uno tome uno libre; entonces en la mesa caben tantas personas como papeles haya. La IA sabe quién interpreta a quién.

Unas líneas en tu lore ayudan: dile a la IA que hay varios jugadores, que responda a cada uno y que mantenga al grupo junto salvo que se separen. El [Asistente IA](/es/creator/studio-ai) puede hacerlo por ti: pídele que prepare la carta para varios jugadores.

## Partida con reglas

Un **Archivo de reglas** es un pequeño archivo JavaScript entre los archivos de tu interfaz que contiene el juego: a quién le toca, qué jugadas valen, qué puede ver cada jugador, quién gana. Se ejecuta en el servidor de juego de Yumina, así que nadie puede espiar la mano de otro.

No tienes que escribirlo tú. Si aún no hay archivo de reglas, pulsa **Pedírselo al asistente** y describe el juego. El asistente escribe el archivo, juega unos cientos de partidas de prueba en el servidor para encontrar errores y cartas ocultas que llegan al jugador equivocado, y monta la mesa en tu interfaz.

## La IA en los asientos libres

En una partida con reglas, el anfitrión puede llenar los asientos libres con jugadores IA. En **La IA ocupa los asientos libres** puedes darles nombre y elegir el modelo con el que juegan. Un asiento de IA solo ve lo que vería una persona en ese asiento.

## Quién paga, cartas para adultos

El anfitrión paga todas las llamadas a la IA de la mesa: las respuestas de la historia y las jugadas de los asientos de IA. Una sala de historia tiene un **Límite de gasto**, 5.000 mushies cada 24 horas por defecto; el anfitrión ve en el menú de la sala cuánto lleva gastado y puede cambiarlo cuando quiera. Al llegar al límite la ronda se detiene, y con un toque el anfitrión lo sube y se sigue jugando. Las reglas de contenido de cada jugador siguen valiendo: en una carta para adultos, todos en la mesa deben tener 18 años o más y su año de nacimiento en el perfil.

## Prueba una mesa tú mismo

Abre la carta, pulsa **Jugar con amigos** e invita a un amigo, o abre el enlace de invitación con una segunda cuenta. En una partida con reglas, añade uno o dos asientos de IA y juega una partida entera. La prueba del asistente juega la historia a solas; no puede sentarse a una mesa.

## Para la interfaz de tu carta

La mesa de una partida con reglas es el código de tu carta. Entra en una mesa con `api.room.join("rules:CODE")`, juega con `api.room.act(move)`, recibe la vista de cada jugador en `api.room.onFrame` y abre el panel de invitación con `api.room.invite({ roomId })`. Cuando un amigo entra por el enlace de invitación y pulsa **Empezar a jugar**, `api.room.pendingTable()` devuelve el código de esa mesa (una sola vez), para sentarlo directamente. El asistente conoce los detalles: pregúntale, o carga su skill multiplayer si trabajas con tu propia IA mediante [Conecta tu IA](/es/creator/connect-your-ai).

En el modo historia, la interfaz propia de la tarjeta sigue funcionando: todos la ven, lo que se envía desde su campo de texto es la acción de ese jugador en la ronda y los botones cambian el juego compartido para todos. La plataforma muestra una franja fina encima de la interfaz con quién ha actuado, la cuenta atrás y «Turno de la IA», así que la tarjeta no necesita nada propio. Para mostrar el grupo en tu interfaz, añade `<RoomParty />`: la imagen y el nombre del rol de cada jugador, con un borde en quien ya actuó en esta ronda; fuera de una sala no muestra nada. Para dibujarlo tú, lee `api.storyRoom`: cada entrada de `people` tiene nombre, nombre del rol e imagen del rol, y `actedIds` indica quién actuó en esta ronda. Cada rol puede tener una imagen: haz clic en el recuadro junto al rol y elige una imagen de la tarjeta; un rol vinculado a un personaje usa su retrato.
