Home, ficha y Favoritos

Puedes añadir secciones a Home y acciones a la ficha de un juego. Nelkano básicos utiliza estas contribuciones para Favoritos, Continuar y la elección de carátula.

Mostrar juegos en Home

Publica una sección con los ID de los juegos que quieras mostrar:

{
  moduleId: 'example.home', id: 'my-games',
  slot: 'HOME_SECTION', label: 'Mis juegos', actionId: 'open',
  payload: { section: {
    kind: 'game-carousel', gameIds: ['id-del-juego'],
    emptyLabel: 'Todavía no hay juegos'
  }}
}

Los ID deben existir en la biblioteca. Nelkano dibuja las tarjetas y abre su ficha al pulsarlas. emptyLabel es el texto que aparece cuando la sección está vacía.

Juegos recientes en Home (datos de ejemplo).

Sección Favoritos añadida por un módulo (ejemplo).

Favoritos ya viene integrado en Básicos. La estrella de la ficha añade o quita el juego de esa colección, y Home muestra su sección. No necesitas instalar Colecciones por separado; los datos se conservan al actualizar.

Añadir un icono a la ficha

Usa GAME_HEADER_ACTION. Para una acción que se pueda marcar, indica su estado con checked; así funciona la estrella de Favoritos.

Ficha del juego y estados guardados (ejemplo).

Ofrecer Continuar

Consulta saves.list para encontrar los estados disponibles.
Publica GAME_LAUNCH_ACTION con payload.primaryLaunch: true. La acción aparece junto a Jugar.
Cuando se pulse, elige el estado y llama a library.launch(gameId, slot).

Jugar abre el juego sin cargar un estado de Nelkano; su progreso interno se recupera desde los menús del propio juego. También se puede cargar un estado concreto desde su miniatura, aunque los autoguardados estén desactivados.

Elegir una carátula de un guardado

GAME_ARTWORK_ACTION coloca una acción en la esquina inferior de la portada. Básicos la utiliza para abrir el selector de capturas. Para cambiar la carátula desde tu módulo:

// Requiere library.cover. Los IDs vienen de library.list y saves.list.
await host.library.setCover(gameId, slot);
// Volver a la portada original:
await host.library.setCover(gameId, null);

Obtén los juegos con library.list y los guardados con saves.list. hasThumbnail indica si un estado tiene captura; coverSlot identifica la carátula elegida. Solo se aceptan juegos existentes, slots del 0 al 6 y guardados con captura. La elección se conserva al volver a abrir Nelkano.