836
ediciones
Cambios
Ir a la navegación
Ir a la búsqueda
Modding:Guía del Modder/Prueba y solución de problemas (ver código)
Revisión del 18:19 27 ene 2022
, 18:19 27 ene 2022Página creada con «{{../Encabezado}} Esta página lo ayuda a probar sus mods y resolver problemas comunes. '''Para problemas '' con el uso de'' mods, consulte Modding:Guía del jugador/Sol…»
{{../Encabezado}}
Esta página lo ayuda a probar sus mods y resolver problemas comunes. '''Para problemas '' con el uso de'' mods, consulte [[Modding:Guía del jugador/Solución de problemas]].'''
==Prueba del mod==
===Pruebas básicas===
La prueba es bastante sencilla para la mayoría de los mods:
# Haga clic en ''Build > Rebuild Solution'' (Visual Studio) o ''Build > Rebuild All'' (MonoDevelop).
# segúrese de que no haya errores de compilación y que el mod se copie en su <samp>Mods</samp> a la carpeta.
# Prueba el mod en el juego.
# Asegúrese de que no haya errores o advertencias para su mod en la consola SMAPI.
En general, si un mod funciona en una plataforma, funcionará bien en las demás.
===Probando en multijugador===
Puedes probar mods en multijugador en la misma computadora, iniciando dos instancias del juego:
# Prepara al jugador uno:
## nicie SMAPI como de costumbre.
## Desde la pantalla de título: haz click ''co-op'', y luego en ''Anfitrión''.
## Inicie una nueva ranura para guardar (a menos que ya haya creado una). Asegúrate de establecer 'cabinas iniciales' en al menos una (necesitarás una cabina por jugador adicional).
# Prepara al jugador dos:
## Vuelva a iniciar SMAPI. (Esto creará automáticamente un archivo de registro separado).
## Desde la pantalla de título: haga click ''co-op'', luego ''únase a la juego LAN''.
## Deje el cuadro de 'Ingresar IP...' vacío y haga clic en Aceptar.
===Pruebas en todas las plataformas===
Para mods complejos, es posible que deba probar su mod en todas las plataformas. El juego es prácticamente el mismo en Linux/Mac, por lo que solo necesitas probar tu mod dos veces: una vez en Windows y otra vez en Linux o Mac. Puede hacerlo probando una versión en su computadora y la otra en una máquina virtual.
<dl>
<dt>Si su computadora principal es Windows 11:</dt>
<dd>
<ol>
<li>[https://docs.microsoft.com/en-us/windows/wsl/install Instale el subsistema de Windows para Linux (WSL)].</li>
<li>Instale el software necesario en WSL:</li>
<ol>
<li>[https://linuxconfig.org/how-to-install-steam-on-ubuntu-20-04-focal-fossa-linux Instala Steam].</li>
<li>Inicie <code>export TERM=xterm && steam</code>, luego instale e inicie Stardew Valley a través de su interfaz de usuario. Esto también instalará sus dependencias.</li>
<li>''(optional)'' (opcional) Descargue e instale su IDE preferido, si planea compilar el código en Linux. Para la [https://www.jetbrains.com/help/rider/Installation_guide.html#prerequisites última versión independiente de Rider] (no gratuita):
<syntaxhighlight lang="sh">
wget "<URL de descarga aquí>" -O rider-install.tar.gz
sudo tar -xzvf rider-install.tar.gz -C /opt
ln -s "/opt/JetBrains Rider-<version>/bin/rider.sh"
./rider.sh
</syntaxhighlight></li>
<li>[[Modding:Instalar SMAPI en Linux|Instale SMAPI]].</li>
</ol></li>
<li>Para iniciar el juego, inícielo <code>steam</code> y ejecútelo a través de su interfaz de usuario.</li>
</ol></li>
</ul>
</dd>
</dl>
; Si su computadora principal es Windows 10 o anterior::
:# Instala [https://www.virtualbox.org/ VirtualBox].
:# Cree una máquina virtual de [https://zorinos.com/ ZorinOS Core] en VirtualBox.
:#* ''Consulte [https://extr3metech.wordpress.com/2013/09/05/installing-zorin-os-7-in-virtual-box-screenshots esta guía de configuración] para obtener más detalles. El instalador de ZorinOS uede ser un poco diferente al que se muestra, pero debería ser bastante intuitivo.''
:#* ''Si no ve ninguna opción para los sistemas operativos de 64 bits en VirtualBox, vea [https://superuser.com/a/866963 cómo habilitarlos].''
:#* ''Al crear el disco virtual, se recomiendan al menos 20GB.''
:# [https://store.steampowered.com/about Descargue el instalador de Steam] en la máquina virtual y ejecútelo
:# Inicie Steam para finalizar la instalación. Si no sucede nada, consulte [https://askubuntu.com/questions/771032/steam-not-opening-in-ubuntu-16-04-lts estos pasos adicionales] para solucionarlo.
:# Instale Stardew Valley a través de Steam.
:# [[Modding:Guía del jugador/Introducción#Instalar SMAPI|Instale SMAPI]].
:# ''(opcional)'' Instale [https://www.mono-project.com/ <samp>mono-complete</samp>] and [http://www.monodevelop.com/download/ MonoDevelop] en su máquina virtual. Esto solo es necesario si desea compilar por separado para Linux/Mac. Al instalar los archivos <samp>.deb</samp> files, utilice las instrucciones para la [https://zorinos.com/help/install-apps/#deb-files versión de Ubuntu que se muestran aquí]. Si te encuentras con errores, que Linux se apiade de tu alma.
:# ''(opcional)'' Solo para desbloquear Mac OS: [https://www.insanelymac.com/forum/files/file/838-unlocker/ Virtual Machine Unlocker 2.1.1] para VmWare Workstation 11/12/14, VmWare Player 7/12/14 o Fusion 7/8/10. ''' Esto es necesario para iniciar Mac OS en una máquina virtual'''
; Si su computadora principal es Linux o macOS:
:# Instala [https://www.virtualbox.org/ VirtualBox].
:# [http://www.macworld.co.uk/how-to/mac-software/run-windows-10-on-your-mac-using-virtualbox-3621650/ Crear una máquina virtual con Windows].
:# Instale Stardew Valley en su máquina virtual.
:# [[Modding:Guía del jugador/Introducción#Instalar SMAPI|Instale SMAPI]].
:# ''(opcional)'' Instale [https://visualstudio.microsoft.com/vs/community/ Visual Studio Community] en su máquina virtual. Esto solo es necesario si desea compilar por separado para Windows.
==Arreglar alertas de compilación comunes==
Después de compilar su proyecto, puede ver las advertencias de compilación a través de ''Visual Studio > Ver > Lista de errores'' o ''MonoDevelop > Ver > Pads > Errores''. Aquí hay algunos comunes.
===Esto implícitamente convierte...===
Ejemplo de un alerta: "''Esto convierte implícitamente '{0}' de Net{1} a {2}, pero Net{1} tiene reglas de conversión implícitas poco intuitivas. Considere comparar con el valor real para evitar errores. Consulte https://smapi.io/buildmsg/avoid-implicit-net-field-cast para más detalles.''"
Su código hace referencia a un [[Modding:Guía del Modder/Fundamentos del juego#Campos de red|Campo de red]], o que puede causar errores sutiles. Este campo tiene una propiedad no neta equivalente, como <samp>monster.Health</samp> (<samp>int</samp>) en vez <samp>monster.health</samp> (<samp>NetBool</samp>). Cambie su código para usar la propiedad sugerida en su lugar.
===FieldName es un campo red*...===
Ejemplo de advertencia: "'''{0}' es un Campo de red (Net){1}; considere usar la propiedad {2} en su lugar. Consulte https://smapi.io/buildmsg/avoid-net-para obtener más detalles.''"
Su código hace referencia a un [[Modding:Guía del Modder/Fundamentos del juego#Campos de red|Campo de red]], lo que puede causar errores sutiles. En su lugar, debe acceder al valor subyacente:
<ul>
<li>Para un tipo de referencia (''es decir,'' uno que puede contener <samp>null</samp>), puede utilizar la propiedad <samp>.Value</samp> (o <samp>.FieldDict</samp> para <samp>NetDictionary</samp>):
<syntaxhighlight lang="c#">
if (building.indoors.Value == null)
</syntaxhighlight>
O convertir el Value antes de la comparación:
<syntaxhighlight lang="c#">
GameLocation indoors = building.indoors.Value;
if(indoors == null)
// ...
</syntaxhighlight></li>
<li>Para un tipo value (''es decir,''uno que no puede contener <samp>null</samp>), verifique si el padre es nulo (si es necesario) y compare con el <samp>.Value</samp>:
<syntaxhighlight lang="c#">
if (item != null && item.category.Value == 0)
</syntaxhighlight></li>
</ul>
===El campo FieldName está obsoleto...===
Ejemplo de una alerta: "'' El campo 'Character.friendships' está obsoleto y debe reemplazarse con 'friendshipData'. Consulte https://smapi.io/buildmsg/avoid-obsolete-field para obtener más información.''"
Está haciendo referencia a un campo que ya no debería utilizarse. Utilice el nombre de campo sugerido en su lugar para corregirlo.
===Una instancia de analizador... no se puede ser crear===
Actualice a la última versión de [https://visualstudio.microsoft.com/vs/community/ Visual Studio]; el paquete NuGet usa una característica reciente que no está disponible en versiones anteriores.
==Otros problemas==
===No se puede apuntar a .NET 5===
Si la lista de apunte del framework tiene opciones que comienzan con...
* ''.NET Framework'': y creó el tipo de proyecto incorrecto. En su lugar, asegúrese de crear un proyecto .NET 5 para su mod. (El nombre es un poco confuso.)
* ''.NET Core'', ''.NET Standard'', o ''.NET 5+'': use .NET 5 fpara compatibilidad con el juego. Si no tiene esa opción, puede instalar el [https://dotnet.microsoft.com/en-us/download/dotnet/5.0 .NET 5 SDK] para agregarlo.
===Visual Studio no puede encontrar los DLL del juego/SMAPI/MonoGame===
<span id="Visual_Studio_can.27t_find_the_game.2FSMAPI.2FXNA_DLLs"><!--old section name--></span>
Soluciones comunes:
* Reinicie Visual Studio.
* Asegúrate de que el juego y SMAPI estén correctamente instalados y funcionen bien.
* Compruebe si hay un error como "'' Error al encontrar la ruta de instalación del juego ''". Si está presente, debe [https://smapi.io/package/custom-game-path especificar su ruta de juego].
* Asegúrese de haber creado un proyecto .NET 5, '''no''' .NET Framework. (Vea [[Modding:Referencia IDE#Establecer el destino del framework|cómo configurar el apunte del framework]]; si ve opciones que comienzan con .NET Framework, elimine el proyecto y cree un proyecto .NET 5 en su lugar).
* Asegúrese de apuntar a .NET 5 (vea [[Modding:Referencia IDE#Establecer el apunte del framework|Como]]).
Si esos no lo arreglaron:
# Haga click en ''Build > Rebuild Solution'' (Visual Studio) o ''Build > Rebuild All'' (MonoDevelop).
# Compruebe el panel de ''Output'' o la lista de errores (Visual Studio), o el panel ''Errors'' pad (MonoDevelop).
# Si no ve nada relevante, publique el texto de ''Output'' en [https://hastebin.com hastebin], [[#Preguntar por ayuda|solicite ayuda en Discord]], e incluya un enlace a su hastebin.
==Preguntar por ayuda==
¡Consulte [[Modding:Ayuda]] para obtener ayuda!
[[en:Modding:Modder Guide/Test and Troubleshoot]]
Esta página lo ayuda a probar sus mods y resolver problemas comunes. '''Para problemas '' con el uso de'' mods, consulte [[Modding:Guía del jugador/Solución de problemas]].'''
==Prueba del mod==
===Pruebas básicas===
La prueba es bastante sencilla para la mayoría de los mods:
# Haga clic en ''Build > Rebuild Solution'' (Visual Studio) o ''Build > Rebuild All'' (MonoDevelop).
# segúrese de que no haya errores de compilación y que el mod se copie en su <samp>Mods</samp> a la carpeta.
# Prueba el mod en el juego.
# Asegúrese de que no haya errores o advertencias para su mod en la consola SMAPI.
En general, si un mod funciona en una plataforma, funcionará bien en las demás.
===Probando en multijugador===
Puedes probar mods en multijugador en la misma computadora, iniciando dos instancias del juego:
# Prepara al jugador uno:
## nicie SMAPI como de costumbre.
## Desde la pantalla de título: haz click ''co-op'', y luego en ''Anfitrión''.
## Inicie una nueva ranura para guardar (a menos que ya haya creado una). Asegúrate de establecer 'cabinas iniciales' en al menos una (necesitarás una cabina por jugador adicional).
# Prepara al jugador dos:
## Vuelva a iniciar SMAPI. (Esto creará automáticamente un archivo de registro separado).
## Desde la pantalla de título: haga click ''co-op'', luego ''únase a la juego LAN''.
## Deje el cuadro de 'Ingresar IP...' vacío y haga clic en Aceptar.
===Pruebas en todas las plataformas===
Para mods complejos, es posible que deba probar su mod en todas las plataformas. El juego es prácticamente el mismo en Linux/Mac, por lo que solo necesitas probar tu mod dos veces: una vez en Windows y otra vez en Linux o Mac. Puede hacerlo probando una versión en su computadora y la otra en una máquina virtual.
<dl>
<dt>Si su computadora principal es Windows 11:</dt>
<dd>
<ol>
<li>[https://docs.microsoft.com/en-us/windows/wsl/install Instale el subsistema de Windows para Linux (WSL)].</li>
<li>Instale el software necesario en WSL:</li>
<ol>
<li>[https://linuxconfig.org/how-to-install-steam-on-ubuntu-20-04-focal-fossa-linux Instala Steam].</li>
<li>Inicie <code>export TERM=xterm && steam</code>, luego instale e inicie Stardew Valley a través de su interfaz de usuario. Esto también instalará sus dependencias.</li>
<li>''(optional)'' (opcional) Descargue e instale su IDE preferido, si planea compilar el código en Linux. Para la [https://www.jetbrains.com/help/rider/Installation_guide.html#prerequisites última versión independiente de Rider] (no gratuita):
<syntaxhighlight lang="sh">
wget "<URL de descarga aquí>" -O rider-install.tar.gz
sudo tar -xzvf rider-install.tar.gz -C /opt
ln -s "/opt/JetBrains Rider-<version>/bin/rider.sh"
./rider.sh
</syntaxhighlight></li>
<li>[[Modding:Instalar SMAPI en Linux|Instale SMAPI]].</li>
</ol></li>
<li>Para iniciar el juego, inícielo <code>steam</code> y ejecútelo a través de su interfaz de usuario.</li>
</ol></li>
</ul>
</dd>
</dl>
; Si su computadora principal es Windows 10 o anterior::
:# Instala [https://www.virtualbox.org/ VirtualBox].
:# Cree una máquina virtual de [https://zorinos.com/ ZorinOS Core] en VirtualBox.
:#* ''Consulte [https://extr3metech.wordpress.com/2013/09/05/installing-zorin-os-7-in-virtual-box-screenshots esta guía de configuración] para obtener más detalles. El instalador de ZorinOS uede ser un poco diferente al que se muestra, pero debería ser bastante intuitivo.''
:#* ''Si no ve ninguna opción para los sistemas operativos de 64 bits en VirtualBox, vea [https://superuser.com/a/866963 cómo habilitarlos].''
:#* ''Al crear el disco virtual, se recomiendan al menos 20GB.''
:# [https://store.steampowered.com/about Descargue el instalador de Steam] en la máquina virtual y ejecútelo
:# Inicie Steam para finalizar la instalación. Si no sucede nada, consulte [https://askubuntu.com/questions/771032/steam-not-opening-in-ubuntu-16-04-lts estos pasos adicionales] para solucionarlo.
:# Instale Stardew Valley a través de Steam.
:# [[Modding:Guía del jugador/Introducción#Instalar SMAPI|Instale SMAPI]].
:# ''(opcional)'' Instale [https://www.mono-project.com/ <samp>mono-complete</samp>] and [http://www.monodevelop.com/download/ MonoDevelop] en su máquina virtual. Esto solo es necesario si desea compilar por separado para Linux/Mac. Al instalar los archivos <samp>.deb</samp> files, utilice las instrucciones para la [https://zorinos.com/help/install-apps/#deb-files versión de Ubuntu que se muestran aquí]. Si te encuentras con errores, que Linux se apiade de tu alma.
:# ''(opcional)'' Solo para desbloquear Mac OS: [https://www.insanelymac.com/forum/files/file/838-unlocker/ Virtual Machine Unlocker 2.1.1] para VmWare Workstation 11/12/14, VmWare Player 7/12/14 o Fusion 7/8/10. ''' Esto es necesario para iniciar Mac OS en una máquina virtual'''
; Si su computadora principal es Linux o macOS:
:# Instala [https://www.virtualbox.org/ VirtualBox].
:# [http://www.macworld.co.uk/how-to/mac-software/run-windows-10-on-your-mac-using-virtualbox-3621650/ Crear una máquina virtual con Windows].
:# Instale Stardew Valley en su máquina virtual.
:# [[Modding:Guía del jugador/Introducción#Instalar SMAPI|Instale SMAPI]].
:# ''(opcional)'' Instale [https://visualstudio.microsoft.com/vs/community/ Visual Studio Community] en su máquina virtual. Esto solo es necesario si desea compilar por separado para Windows.
==Arreglar alertas de compilación comunes==
Después de compilar su proyecto, puede ver las advertencias de compilación a través de ''Visual Studio > Ver > Lista de errores'' o ''MonoDevelop > Ver > Pads > Errores''. Aquí hay algunos comunes.
===Esto implícitamente convierte...===
Ejemplo de un alerta: "''Esto convierte implícitamente '{0}' de Net{1} a {2}, pero Net{1} tiene reglas de conversión implícitas poco intuitivas. Considere comparar con el valor real para evitar errores. Consulte https://smapi.io/buildmsg/avoid-implicit-net-field-cast para más detalles.''"
Su código hace referencia a un [[Modding:Guía del Modder/Fundamentos del juego#Campos de red|Campo de red]], o que puede causar errores sutiles. Este campo tiene una propiedad no neta equivalente, como <samp>monster.Health</samp> (<samp>int</samp>) en vez <samp>monster.health</samp> (<samp>NetBool</samp>). Cambie su código para usar la propiedad sugerida en su lugar.
===FieldName es un campo red*...===
Ejemplo de advertencia: "'''{0}' es un Campo de red (Net){1}; considere usar la propiedad {2} en su lugar. Consulte https://smapi.io/buildmsg/avoid-net-para obtener más detalles.''"
Su código hace referencia a un [[Modding:Guía del Modder/Fundamentos del juego#Campos de red|Campo de red]], lo que puede causar errores sutiles. En su lugar, debe acceder al valor subyacente:
<ul>
<li>Para un tipo de referencia (''es decir,'' uno que puede contener <samp>null</samp>), puede utilizar la propiedad <samp>.Value</samp> (o <samp>.FieldDict</samp> para <samp>NetDictionary</samp>):
<syntaxhighlight lang="c#">
if (building.indoors.Value == null)
</syntaxhighlight>
O convertir el Value antes de la comparación:
<syntaxhighlight lang="c#">
GameLocation indoors = building.indoors.Value;
if(indoors == null)
// ...
</syntaxhighlight></li>
<li>Para un tipo value (''es decir,''uno que no puede contener <samp>null</samp>), verifique si el padre es nulo (si es necesario) y compare con el <samp>.Value</samp>:
<syntaxhighlight lang="c#">
if (item != null && item.category.Value == 0)
</syntaxhighlight></li>
</ul>
===El campo FieldName está obsoleto...===
Ejemplo de una alerta: "'' El campo 'Character.friendships' está obsoleto y debe reemplazarse con 'friendshipData'. Consulte https://smapi.io/buildmsg/avoid-obsolete-field para obtener más información.''"
Está haciendo referencia a un campo que ya no debería utilizarse. Utilice el nombre de campo sugerido en su lugar para corregirlo.
===Una instancia de analizador... no se puede ser crear===
Actualice a la última versión de [https://visualstudio.microsoft.com/vs/community/ Visual Studio]; el paquete NuGet usa una característica reciente que no está disponible en versiones anteriores.
==Otros problemas==
===No se puede apuntar a .NET 5===
Si la lista de apunte del framework tiene opciones que comienzan con...
* ''.NET Framework'': y creó el tipo de proyecto incorrecto. En su lugar, asegúrese de crear un proyecto .NET 5 para su mod. (El nombre es un poco confuso.)
* ''.NET Core'', ''.NET Standard'', o ''.NET 5+'': use .NET 5 fpara compatibilidad con el juego. Si no tiene esa opción, puede instalar el [https://dotnet.microsoft.com/en-us/download/dotnet/5.0 .NET 5 SDK] para agregarlo.
===Visual Studio no puede encontrar los DLL del juego/SMAPI/MonoGame===
<span id="Visual_Studio_can.27t_find_the_game.2FSMAPI.2FXNA_DLLs"><!--old section name--></span>
Soluciones comunes:
* Reinicie Visual Studio.
* Asegúrate de que el juego y SMAPI estén correctamente instalados y funcionen bien.
* Compruebe si hay un error como "'' Error al encontrar la ruta de instalación del juego ''". Si está presente, debe [https://smapi.io/package/custom-game-path especificar su ruta de juego].
* Asegúrese de haber creado un proyecto .NET 5, '''no''' .NET Framework. (Vea [[Modding:Referencia IDE#Establecer el destino del framework|cómo configurar el apunte del framework]]; si ve opciones que comienzan con .NET Framework, elimine el proyecto y cree un proyecto .NET 5 en su lugar).
* Asegúrese de apuntar a .NET 5 (vea [[Modding:Referencia IDE#Establecer el apunte del framework|Como]]).
Si esos no lo arreglaron:
# Haga click en ''Build > Rebuild Solution'' (Visual Studio) o ''Build > Rebuild All'' (MonoDevelop).
# Compruebe el panel de ''Output'' o la lista de errores (Visual Studio), o el panel ''Errors'' pad (MonoDevelop).
# Si no ve nada relevante, publique el texto de ''Output'' en [https://hastebin.com hastebin], [[#Preguntar por ayuda|solicite ayuda en Discord]], e incluya un enlace a su hastebin.
==Preguntar por ayuda==
¡Consulte [[Modding:Ayuda]] para obtener ayuda!
[[en:Modding:Modder Guide/Test and Troubleshoot]]