LivingSim para Unity · política
Soporte, compatibilidad y estabilidad
Qué obtienes, qué se mantiene igual entre versiones, qué admitimos y cómo contactarnos. Esta página es una copia actualizada de la política que está en el repositorio de LivingSim, donde una prueba la mantiene coherente con el README del paquete, la ficha de la tienda y las notas de empaquetado.
Qué se entrega y qué es código fuente
- El motor es de código cerrado.
LivingSim.Core.dll,LivingSim.Sdk.dll,LivingSim.Inspection.dllyLivingSim.UnityAdapter.dllse entregan como ensamblados compilados de .NET Standard 2.1. Si tener el código fuente del motor es fundamental para tu proyecto, este paquete no es el adecuado, y preferimos decirlo aquí antes que después de una compra. - Todo lo que toca tu proyecto es C# legible. Los componentes de Unity (
Runtime/), el juego de ejemplo y su escena (Samples/), y elHouseShareGameque ejecuta el ejemplo son código fuente sencillo que puedes leer, modificar y copiar. - Cada ensamblado incluye su documentación y sus símbolos.
LivingSim.*.xmlle da a tu IDE una descripción emergente para cada miembro documentado;LivingSim.*.pdble da a cada traza de pila que pasa por el motor su archivo y su línea. Guárdalos junto a las DLL. - Sin red, sin telemetría, sin modelo. El motor es determinista y funciona sin conexión. Nada en el paquete hace llamadas al exterior.
La documentación de referencia de la API de LivingSim solo está disponible en inglés.
Versiones: qué se considera un cambio incompatible
El paquete sigue el versionado semántico (Semantic Versioning). La versión figura en VERSION.txt, en las propiedades de archivo de cada DLL y al principio de CHANGELOG.md. Las reglas siguientes son las que recogen la política de superficie de API y las notas de empaquetado del repositorio; una prueba se asegura de que los tres digan lo mismo.
- Qué se admite. La superficie admitida es la fachada
LivingSimSdky la API documentada del motor,LivingSim.Core. La fachada esLivingSimSdk, sus siete áreas (Characters,Places,Items,Actions,Relationships,Time,Events),SaveyLoad, y las vistas copiadas que devuelven; la API documentada del motor esSimulationEngine(construcción, avance por pasos, registro, consultas, instantáneas),WorldEventy su vocabulario, el cargador de escenarios y los tipos de estado persistente que documenta la referencia. Las vistas de inspección y el adaptador del host (LivingSim.Inspection,LivingSim.UnityAdapter) son herramientas opcionales para el inspector de depuración y pueden cambiar con él. Todo lo demás que resulte serpublicen las DLL es sustrato del motor, no un compromiso. - Mientras la versión empiece por
0(0.x): una versión menor puede cambiar la superficie admitida o el formato de guardado, y cada cambio de ese tipo aparece en Changed en el registro de cambios, junto con lo que hay que hacer al respecto. Una versión de parche (de0.1.0a0.1.1) no cambia ninguna firma admitida y carga todas las partidas guardadas que puede cargar la versión menor. - A partir de
1.0: un cambio incompatible en la superficie admitida o en lo que aceptaLoadincrementa la versión mayor. Una versión menor añade; un parche corrige. Todo lo marcado con[Obsolete]sigue funcionando durante al menos una versión menor antes de que pueda eliminarse, y no se elimina antes de la siguiente versión mayor. - Partidas guardadas. Una partida guardada con una versión se carga en todos los parches posteriores de la misma versión menor. Al cambiar de versión menor en
0.x, o de versión mayor a partir de1.0, el registro de cambios indica si se cargan las partidas guardadas anteriores, y una partida guardada que no puede cargarse falla enLoadcon un mensaje, en lugar de cargarse mal. - Determinismo. La misma semilla y las mismas llamadas dan el mismo resultado, y una partida guardada, al cargarse, continúa como lo habría hecho la original, dentro de una misma versión. Una versión nueva puede cambiar lo que hacen los personajes (para eso sirven la mayoría de las versiones), así que una repetición grabada en una versión no sirve como prueba de la siguiente.
Versiones de Unity y entornos de ejecución compatibles
- Verificado: Unity 2022.3 LTS (2022.3.62f1) y Unity 6 (6000.4.5f1 y 6000.6.4f1) en el Editor con Mono, también con Reload Domain desactivado; y Unity 2022.3.62f1 en un reproductor independiente IL2CPP, con la eliminación de código administrado en los niveles «Low» y «High», sin
link.xml. - Debería funcionar, aún sin verificar: otras versiones de Unity 2022.3 y de Unity 6, e IL2CPP en Unity 6. El paquete no usa API específicas de ninguna versión y tiene como destino .NET Standard 2.1 con cualquiera de los dos valores de Api Compatibility Level.
- No compatible: versiones de Unity anteriores a 2022.3, y reproductores WebGL y de consola hasta que los hayamos verificado (está prevista una compilación WebGL del ejemplo; cuando se publique, esta página lo indicará).
Cada versión publicada se verifica de nuevo en las versiones que menciona; la sección Requirements del README del paquete y la ficha de la tienda mencionan las mismas versiones que esta página.
Soporte
- Dónde: por correo electrónico a [email protected], o en la página del publicador en la Asset Store. Por favor, incluye la versión del paquete (
VERSION.txt), la versión de Unity y el backend y, si puedes, una partida guardada o una semilla que reproduzca el problema. - Plazo de respuesta previsto: hacemos lo posible, normalmente en un plazo de tres días hábiles. Un error reproducible en una configuración admitida se corrige en el siguiente parche cuando es factible; una corrección que requiere una API nueva espera a una versión menor.
- Las actualizaciones son gratuitas para quienes compran en la ficha; la versión y el registro de cambios vienen dentro del paquete.
Lo que no prometemos
- Acceso al código fuente del motor, ni una licencia sobre él.
- Compatibilidad con versiones de Unity anteriores a 2022.3, ni con plataformas que no figuren arriba.
- Que una versión posterior mantenga igual el comportamiento de cada personaje. Las correcciones y un mejor modelado cambian los resultados; el registro de cambios indica las mecánicas que cambiaron.