Skip to content

Clasificaciones ​

Dale a tu carta una tabla de puntuaciones, como hacen los juegos de Steam: la carta pone nombre a una tabla y envía puntuaciones, y la plataforma guarda la mejor de cada jugador y las ordena. La tabla se ve como la carta la dibuje: dónde va, sus colores, fuentes, avatares, trofeos y la animación al entrar en ella. La plataforma nunca añade una tabla propia fuera de la carta.

Sirve para cualquier carta con puntos, tiempos, rachas o pisos alcanzados: pinball, juegos de correr, trivias, días sobrevividos, tiempos de puzle.

Pídeselo al asistente de Studio ​

Lo más fácil es decirlo tal cual, por ejemplo:

  • "Añade una clasificación que muestre mi puesto y el top 10 al terminar una partida"
  • "Haz una tabla de tiempos, el más rápido primero, y que también se vea en la pantalla de título"
  • "Añade una pestaña de amigos, con oro, plata y bronce para los tres primeros"

El asistente escribe el código para enviar y leer, y dibuja la tabla al estilo actual de la carta. Para cambiar cómo se ve, pídelo como cualquier otra parte de la interfaz.

Si lo escribes tú ​

En el código de interfaz (Paneles → Código de interfaz), toma api de useYumina():

  • api.leaderboard.submit(tabla, puntos, { details?, order? }): envía al terminar una partida. Cada jugador conserva solo su mejor marca por tabla; devuelve { ok, best, rank, total, improved }.
  • api.leaderboard.get(tabla, { range?, limit? }): lee la tabla. range es "top", "around" (los puestos alrededor del tuyo) o "friends" (tú y tus amigos). Cada fila es { rank, name, image, score, details, me }; la fila con me: true es el jugador. board.me da el puesto del jugador aunque no esté en esta página.
tsx
const BOARD = "Récord";

export default function Game() {
  const api = useYumina();
  const [range, setRange] = React.useState("top");
  const [board, setBoard] = React.useState(null);
  const [result, setResult] = React.useState(null);

  const load = React.useCallback(async (r) => {
    setBoard(await api.leaderboard.get(BOARD, { range: r, limit: 10 }));
  }, [api]);
  React.useEffect(() => { void load(range); }, [range, load]);

  // llámalo cuando termine una partida
  const finish = async (score) => {
    const r = await api.leaderboard.submit(BOARD, score, { details: { hero: "bola de acero" } });
    setResult(r);           // { ok, best, rank, total, improved }
    void load(range);
  };

  return (
    <div>
      {/* La tabla se ve como tú la dibujes: colores, fuentes, avatares, trofeos y animaciones siguen el estilo de la carta */}
      {result?.ok && <div>{result.improved ? "¡Nuevo récord!" : `Tu mejor marca ${result.best}`} · #{result.rank} / {result.total}</div>}
      {["top", "around", "friends"].map((r) => <button key={r} onClick={() => setRange(r)}>{r}</button>)}
      {board?.ok && board.entries.map((e) => (
        <div key={e.rank + e.name} style={{ fontWeight: e.me ? 800 : 400 }}>
          {e.rank}. {e.name} {e.score}
        </div>
      ))}
      {board && !board.ok && board.reason === "sign-in" && <div>Inicia sesión para entrar en la tabla</div>}
    </div>
  );
}

Consejos de diseño ​

  • Muéstrala donde termina la partida: la puntuación, si es récord y el puesto. Una tabla pequeña en la pantalla de título también funciona.
  • Resalta la fila del jugador (me). Si queda fuera del top 10, añade debajo una línea con board.me.
  • Usa details para notas pequeñas junto a la puntuación: qué personaje, qué nivel, toques por segundo. Hasta 500 caracteres de JSON.
  • En tablas donde menos es mejor (tiempos, movimientos), pasa { order: "asc" } con la primera puntuación; desde entonces esa tabla ordena de menor a mayor.
  • Los invitados reciben { ok: false, reason: "sign-in" }. Muestra "Inicia sesión para entrar en la tabla" y deja que el juego siga.
  • Una carta puede tener varias tablas, como "Récord" y "Más rápido", hasta 20.

Reglas ​

  • Todas las versiones de idioma de una carta comparten las mismas tablas.
  • Cada jugador puede enviar 30 veces por minuto; los nombres de tabla tienen de 1 a 40 caracteres; las puntuaciones no pasan de ±1e15.
  • Solo las cartas publicadas tienen tablas reales; el autor también puede probar en su propia carta sin publicar.
  • Las puntuaciones las calcula la carta en el navegador del jugador, así que no des premios ni recompensas por puesto.
  • La vista previa de Studio muestra una tabla de ejemplo para revisar el diseño; la tabla real aparece al jugar.

Las firmas de los métodos están en la Referencia API.