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.rangees"top","around"(los puestos alrededor del tuyo) o"friends"(tú y tus amigos). Cada fila es{ rank, name, image, score, details, me }; la fila conme: truees el jugador.board.meda el puesto del jugador aunque no esté en esta página.
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 conboard.me. - Usa
detailspara 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.
