SDK de adaptadores de juego

Adaptadores JSON, mecanismos compartidos del anfitrión

Los adaptadores declaran la identidad de instalación, las listas de ejecutables permitidos, la configuración, los argumentos de inicio, los puertos, el estado listo, las evidencias de jugadores y las reglas aprobadas para los datos guardados. No son plugins ejecutables. Los adaptadores no se limitan a Steam: un paquete se instala mediante SteamCMD o desde la descarga HTTPS oficial del editor, fijada por longitud exacta y SHA-256, como hacen los adaptadores de Terraria y Minecraft Java. No se permiten scripts aportados por el paquete, comandos de instalación arbitrarios ni canales de consola abiertos.

La app Keldrin, la Web local, el Portal remoto y Discord usan el contrato instalado. Una entrada más reciente de la Galería no sustituye en silencio a un adaptador instalado. Actualiza la app y el adaptador mediante sus controles compatibles; nunca edites los límites de compatibilidad firmados ni restablezcas las secuencias de catálogo aceptadas.

Versión actual y requisitos

Anfitrión Keldrin público en esta revisión: 0.9.140. La versión preliminar para desarrolladores del SDK 0.9.140 incluye la CLI precompilada, código fuente MIT acotado, ejemplos versionados, fixtures y el esquema estructural actual. Lee primero su README y la guía rápida (en inglés).

La CLI precompilada necesita .NET 10; los scripts de integridad y de guía rápida necesitan PowerShell 7. Una compilación opcional desde el código fuente necesita el SDK de .NET 10.0.302 o el parche compatible más reciente registrado en el paquete. No se incluye ningún entorno de ejecución. Las comprobaciones de herramientas en Windows no establecen que Keldrin sea compatible como anfitrión en equipos con Linux.

Descarga y guía rápida

bcf934690919f46b9224f5d2673a8b7c1d7515a014cebee26e14bfece5674a5d

Extrae el contenido en una carpeta nueva y ejecuta:

pwsh -NoProfile -File ./Test-BundleManifest.ps1
pwsh -NoProfile -File ./Run-Quickstart.ps1 -OutputDirectory ../sdk140-reports

Elige un directorio de informes nuevo fuera del paquete extraído. El paquete verificado y la guía rápida ejecutan seis comandos en 21 invocaciones y 76 casos sintéticos de Setup vinculados al código fuente: Terraria 12, Abiotic Factor 14 más 17 casos límite, Enshrouded 14, Icarus 2 y Minecraft Java 17. También validan con lint el ejemplo de política de detención de Enshrouded y su forma canónica. La verificación usa el ejemplo actual firmado de Core Keeper 1.0.4, solo JSON. Son resultados de herramientas, no una certificación de jugabilidad.

Traspaso a IA para el desarrollo de adaptadores de juego

¿Trabajas con un asistente de IA? Dale el archivo de traspaso a IA para el desarrollo de adaptadores de juego (en inglés), un único archivo Markdown. Explica el formato del paquete, los comandos del SDK, ejemplos prácticos de adaptadores de juego existentes, las reglas de evidencias y el paquete exacto que debe devolverse. Los mantenedores de Keldrin revisan, firman y prueban el paquete devuelto antes de cualquier publicación en la Galería. El archivo contiene solo ejemplos de adaptadores, no código fuente de Keldrin.

Qué admite el contrato actual

verify-package confía en las dos claves oficiales de editor de Keldrin, por lo que verifica todos los paquetes actuales de la Galería. Los paquetes pueden declarar políticas de detención que tienen en cuenta el guardado: guardar y salir en Valheim y Core Keeper, y la interrupción por consola de Enshrouded (EnshroudedBreakSaveExit), que se muestra en el ejemplo incluido de política de detención de Enshrouded.

El contrato también cubre ZIP HTTPS fijados compuestos con archivos opacos, aceptación explícita desmarcada por defecto, un directorio de trabajo del perfil confinado, consultas GameSpy4 acotadas de estado listo, recuento, lista de jugadores y mundo, selección de la carpeta del mundo guardado, marcadores exactos de estado listo de Unreal con marca de tiempo, instalación y nueva comprobación de requisitos previos revisados, nombres aleatorios formados por Keldrin más cuatro dígitos, metadatos binarios del mundo guardado, planes recursivos de archivos guardados y destinos de importación por mundo. Lee los detalles y ejemplos antes de elegir un campo.

Licencia MIT acotada

La licencia MIT incluida cubre el código del SDK creado por Keldrin, el código fuente y la biblioteca Keldrin.Core distribuidos, la documentación y los ejemplos JSON. No declara que toda la app tenga licencia MIT. El arte de terceros, los ejecutables de juegos, los mundos guardados, las claves de firma y el entorno de ejecución .NET se omiten y no se vuelven a licenciar. Algunos ejemplos conservan declaraciones de recursos omitidos: aporta recursos que puedas redistribuir y vuelve a vincular las entradas modificadas antes del envío.

La firma, la admisión, la instalación y las evidencias de funcionamiento real siguen siendo independientes. Envía un adaptador de forma privada en Keldrin.ca (en inglés) y sigue su revisión en el sitio web. Las cuentas con una instalación vinculada tienen prioridad en la revisión; no es necesario vincular una instalación para que una cuenta aprobada pueda enviar.

¿Encontraste un problema en la documentación? Cuéntanoslo en Comentarios (en inglés). No incluyas credenciales ni datos privados de juegos.