Solución de problemas
Fabric indica que faltan mods o que son incompatibles
Comprueba las tablas de Instalación y usa las ediciones para Fabric 1.21.1. El addon requiere SBW 1.21.1-0.8.9.2 y Java 21.
Si Fabric indica que faltan extensibleenums, mkb o Cardinal Components, comprueba que hayas instalado el JAR completo publicado de SBW. Esa versión incluye estas bibliotecas. Un entorno de desarrollo y una instalación normal del launcher pueden resolver de forma distinta las bibliotecas incluidas dentro de otros JAR.
La nave no despega
Ocupa el asiento del piloto, comprueba la energía y la salud de la nave, y pulsa un control de movimiento de vehículos de SBW. La espera de encendido predeterminada es de dos segundos. Revisa los conflictos de teclas en el menú de controles si el motor no responde.
Después de un aterrizaje automático, suelta los controles de movimiento antes de pulsarlos de nuevo para arrancar.
La nave sube, pero no aparece el menú de destinos
La secuencia planetaria requiere Ad Astra. También exige despegar desde una dimensión registrada por Ad Astra como planeta de superficie. Si no se cumplen estas condiciones, la nave utiliza su comportamiento de ascenso vertical.
Si starshipFixedDestination está activada, es normal que no aparezca un menú de selección: el servidor elige el destino. Consulta Configuración del servidor.
Falta un planeta en el menú
Comprueba que su dimensión exista en el servidor, que Ad Astra no lo tenga desactivado y que su nivel no supere el PlanetTier de la nave. Las dimensiones espaciales no se ofrecen como destinos de aterrizaje en superficie.
La nave indica que el destino configurado no está disponible
Revisa destination en dedsafiostarships-server.toml. Debe ser una dimensión de superficie disponible en Ad Astra cuyo nivel no supere el de la nave. El valor predeterminado es ad_astra:moon.
Si la ruta fija no es válida, la nave permanece en órbita en lugar de permitir otro destino.
No se ha encontrado un lugar seguro para aterrizar
La búsqueda necesita una base sólida y seca de 3 por 3 bloques, sin hojas debajo del punto de aterrizaje, y un espacio despejado de unos 10 bloques de ancho y 7 de alto. También comprueba el borde del mundo y las Starships cercanas.
Mueve el centro de llegada configurado a un terreno más abierto o ajusta LandingSearchRadius dentro de su rango admitido. Los edificios muy juntos, los océanos, el terreno escarpado y las zonas de aterrizaje ocupadas pueden impedir una llegada segura.
El salto tarda más de lo esperado
JumpTicks es una duración mínima. El servidor espera a los chunks del destino antes de continuar. Si la preparación falla, la nave muestra un error y permanece en órbita.
Revisa el registro del servidor y la disponibilidad del mundo de destino. El terreno nuevo puede tardar más en prepararse que una zona ya generada.
Faltan efectos de vuelo o falla la carga de un shader
Comprueba que Veil Lib 4.5.2 esté instalado. Busca errores de compilación de shaders o de carga de recursos en logs/latest.log. Si utilizas otros mods de renderizado o paquetes de shaders, incluye sus nombres y versiones al informar del problema.
No aparece un cambio realizado mediante datapack
Comprueba /datapack list, ejecuta /reload y busca errores JSON en el registro. Respeta las rutas, el namespace y las mayúsculas de los campos indicados en Referencia de datapacks. Conserva la definición completa del vehículo al sustituir starship.json.
Inicia un vuelo nuevo para evaluar los cambios de duración o altura.
Informar de un problema
Incluye las versiones de Minecraft, Fabric Loader, SBW, Veil, Ad Astra y el addon, junto con logs/latest.log y cualquier informe de fallo. Describe la dimensión de despegue, el destino seleccionado, la etapa de vuelo y los ajustes relevantes del datapack o del servidor. Para problemas visuales, incluye la perspectiva de cámara y una captura o una grabación corta.