Modding:Guía del Modder/Introducción

Creación de mods SMAPI

---

• Introducción
• Fundamentos del juego
• Prueba y solución de problemas
• Lanzamiento
• Referencias API

  APIs de SMAPI Básicas:

  • Estructura del Mod
  • Manifest
  • Eventos
  • Configuración
  • Cargar y editar contenido
  • Datos
  • Entrada
  • Registro
  • Reflection
  • Multijugador
  • Traducción
  • Utilidades

  APIs de SMAPI Avanzadas:

  • Paquetes de Contenido
  • Comandos de la consola de Mods
  • Integración de mods
  • Harmony

• Guías específicos

← Modding:Índice

¿Quieres crear mods SMAPI para Stardew Valley? ¡Esta guía es para ti! Para usar mods, consulte Modding: Guía del jugador. Para crear paquetes de Content Patcher, consulte Modding: Content Patcher.

Introducción

¿Qué es un mod SMAPI?

Un mod SMAPI utiliza la API de modificación SMAPI para ampliar la lógica del juego. El mod puede responder cuando algo sucede en el juego (como cuando un objeto se coloca en el mundo), ejecutar código periódicamente, cambiar los recursos y datos del juego, etc. Los mods de SMAPI se escriben en C# usando .NET Framework, y Stardew Valley usa XNA/MonoGame para la lógica del juego (dibujo a la pantalla, entrada del usuario, etc.).

¿Porqué los mods usan SMAPI?

¡SMAPI hace muchas cosas por ti! Por ejemplo, SMAPI podrá...

1. Cargar tus mods en el juego. Mods de código no son posibles sin utilizar SMAPI para cargarlos.
2. Proporciona referencias API y eventos que te permiten interactuar con el juego de formas que de otra manera no podrías. Existen referencias API simplificados para cambios de recursos o información en el juego, configuración de jugadores, traducción, reflexión, etc. Estas se cubren posteriormente en la guía.
3. Vuelve a escribir tu mod para compatibilidad entre plataformas cuando carga. Esto te permite escribir el código de tu mod sin preocupación sobre las distintas versiones del juego en Windows/Mac/Linux.
4. Vuelve a escribir tu mod para actualizarlo. SMAPI detecta y repara código dañado por una actualización del juego en casos comunes.
5. Intercepta errores. Si tu mod falla o causa un error, SMAPI interceptará el error, mostrará los detalles del error en la consola, y en la mayoría de los casos recuperará automáticamente el juego. Esto significa que tu mod no cerrará accidentalmente el juego, y hará mucho mas sencillo el proceso de reparar errores.
6. Proporciona chequeo de actualizaciones. SMAPI alertará automáticamente a los jugadores cuando una actualización de tu mod esté disponible.
7. Proporciona chequeo de compatibilidad. SMAPI automáticamente detecta cuando tu mod es incompatible, y lo cierra antes de que cause problemas, para que los jugadores no usen juegos con fallos.

¿Puedo yo hacer un mod?

¡Por supuesto! Esta guía te ayudará a crear un mod paso a paso. Si la sigues al pie de la letra, ¡Habrás creado un mod! Ahora solo tendrás que hacer que haga lo que tu desees.

Si eres nuevo programando: Muchos desarrolladores de mods empiezan con poca o nula experiencia en programación. Ciertamente puedes aprender en el camino si estás determinado, pero debes estar preparado para una curva de aprendizaje muy empinada. No seas muy ambicioso al principio; es mejor empezar con un mod pequeño mientras aprendes el proceso. Es muy fácil terminar abrumado y rendirse la primera vez. ¡La comunidad de mods es muy amistosa, así que no dudes en preguntar!

Si ya tienes experiencia en programación, no debería haber problema. Experiencia en C# o Java hará las cosas mas sencillas, pero no es algo crítico. Si no estás familiarizado con C#, puedes dar un repaso en las referencias Aprendiendo C# abajo para completar cualquier hueco.

¿Es posible hacer un mod sin SMAPI?

Sí. Muchos mods de SMAPI tienen soporte para 'paquetes de contenido', que te permiten proporcionar archivos de texto tipo JSON, imágenes, etc. que los utilizan. Por ejemplo, puedes usar Content Patcher para editar las imágenes del juego y información sin usar programación. El resto de la guía habla de como hacer un mod SMAPI; para paquetes de contenido, checa Modding:Content Patcher (o la documentación de otro mod si quieres hacer un paquete de contenido para otro mod).

¿Dónde puedo obtener ayuda?

La comunidad de mods de Stardew Valley es muy amigable. Siéntete libre de pedir ayuda en el canal de #modding en el servidor de Discord de Stardew Valley.

Primeros pasos

Aprender C#

Como los mods están escritos en C#, es una buena idea acostumbrarse a su uso primero. No es necesario memorizar todo, pero conocimiento de cosas básicas (como campos, métodos, variables, y clases) hará el resto mucho mas fácil.

	Articulo Incompleto Este articulo está incompleto y le falta información. Puedes ayudar a Stardew Valley Wiki ampliando información!