Modding:Guía del Modder/Lanzamiento

De Stardew Valley Wiki
Ir a la navegación Ir a la búsqueda

Creación de mods SMAPI SMAPI mascot.png


Modding:Índice

Una vez que esté listo para compartir su mod, ¡es hora de lanzarlo!

Preparar el paquete de lanzamiento

Para los mods SMAPI

El 'paquete de lanzamiento' para un mod SMAPI es solo un archivo .zip que contiene un mod con sus archivos compilados, manifest.json, cualquier archivo i18n, etc. El paquete NuGet lo creará automáticamente.

Generar un paquete

  1. Edita tus mods manifest.json para aumentar la versión. Consulte la versión semántica para obtener más información sobre la numeración de versiones.
  2. Haga clic en Build > Rebuild Solution (Visual Studio) o Build > Rebuild All (MonoDevelop) para asegurarse de que el proyecto esté compilado.
  3. Abre tu proyecto del mod bin/Debug o bin/Release (dependiendo de su configuración de compilación).
  4. Debería haber un archivo .zip allí para su versión mod.

Ese archivo .zip es el paquete de lanzamiento de tu mod, listo para cargar.

Solución de problemas del paquete

Aquí se explica cómo solucionar problemas comunes con el generado del archivo .zip.

  • El archivo .zip esta perdido:
    • Asegúrese de estar buscando en la carpeta correcta (ya sea bin/Debug o bin/Release).
    • Asegúrese de que no haya errores de compilación.
  • Algunos archivos mod no están en el paquete:
    • Si es un archivo mod: haga clic con el botón derecho en el archivo en Visual Studio o MonoDevelop, elija Properties (Propiedades), y cambie 'Copy to Output Directory (Copiar al directorio de salida)' a 'copiar si es más nuevo'.
    • Si se trata de una referencia de ensamblaje: haga clic con el botón derecho en la referencia en Visual Studio o MonoDevelop, elija Properties (Propiedades), y cambie 'Copy Local' o 'Local Copy' a verdadero.
  • Se incluyen algunos archivos mod que no deberían estar en el paquete:
    • Si es un archivo mod: haga click con el botón derecho en el archivo en Visual Studio o MonoDevelop, elijaProperties (Propiedades), y cambie 'Copy to Output Directory (Copiar al directorio de salida)' a 'do not copy (no copiar)'.
    • Si se trata de una referencia de ensamblado: haga clic con el botón derecho en la referencia en Visual Studio or MonoDevelop, elijaProperties (Propiedades), y cambie 'Copy Local' o 'Local Copy' a falso.

Para mods de paquete de contenido

El 'paquete de lanzamiento' para un mod de paquete de contenido es solo un archivo .zip que contiene un mod con sus archivos, que debe incluir al menos un manifest.json y un content.json. Consulte las pautas específicas para su mod de marco que está utilizando.

Crear un paquete de contenido

  1. Cree una carpeta con el nombre que desee (consulte la convención de nomenclatura de carpetas).
  2. Dentro de la carpeta:
    • Agrega un archivo manifest.json con el campo ContentPackFor (ver formato del manifest).
    • Agregue los archivos que necesita el mod que lo leerá. (Consulte las instrucciones del mod para el que está creando el paquete de contenido).
  3. Inicie el juego y asegúrese de que su nuevo paquete de contenido aparezca en "Loaded X content packs (Paquetes de contenido X cargados)" en la consola SMAPI.

Lanza tu paquete de contenido

  1. Agregue una update key a su manifest (si aún no lo ha hecho).
  2. Actualizar el campo Version en el manifest. (¡Auméntelo para cada versión! SMAPI lo usará para actualizaciones y comprobaciones de compatibilidad). Consulte la versión semántica para obtener más información sobre la numeración de versiones.
  3. Crear un archivo .zip contiene la carpeta del paquete de contenido.
  4. Cargue ese archivo en el sitio de lanzamiento elegido. Consulte la siguiente guía de sitios.

Liberar el mod

Usando Nexus Mods

Crear una página de mods

Si aún no lo has hecho, crea una página de mods en Nexus Mods. Idealmente, la descripción de su mod debería...

  • explicar qué hace el mod y cómo usarlo;
  • proporcionar pasos de instalación claros;
  • explicar con qué versión del juego funciona;
  • diga si funciona en multijugador (y enumere las limitaciones de multijugador);
  • enlace a notas de la versión, código fuente, hilo de discusión, etc., si corresponde.

Aquí hay una plantilla recomendada para la descripción del mod:

  1. Haz clic en el botón "[BBCODE]" encima de la descripción del mod en Nexus. Esto cambiará al modo de texto sin formato.
  2. Pegue esta plantilla en:
    Este mod agrega piñas en todas partes del juego. Reemplace esta línea con algunas oraciones que expliquen su mod.
    
    [size=5]Instalar[/size]
    [list=1]
    [*][url=https://smapi.io]Install the latest version of SMAPI[/url].
    [*]Descarga este mod y descomprímelo en [font=Courier New]Stardew Valley/Mods[/font].
    [*]Ejecuta el juego usando SMAPI.
    [/list]
    
    [size=5]Cómo usar[/size]
    Proporcione algunas oraciones que expliquen cómo usar su mod. Por ejemplo, los botones predeterminados para presionar, dónde encontrar un menú, etc. Puede eliminar esta sección si es evidente.
    
    [size=5]Compatibilidad[/size]
    [list]
    [*]Funciona con Stardew Valley 1.5.6 en Linux/macOS/Windows.
    [*]Funciona en modo de un solo jugador, multijugador y pantalla dividida. Si hay limitaciones multijugador, explícalas aquí.
    [/list]
    
    [size=5]See also[/size]
    Agregue enlaces a continuación para su modificación y elimine los que no correspondan. No olvides eliminar esta oración.
    
    [list]
    [*]Hilo de discusión oficial
    [*]Notas de lanzamiento
    [*]Código fuente
    [/list]
    
  3. Haga clic en el botón "[BBCODE]" para volver a la vista formato.
  4. Edita la plantilla para tu mod.

Agregue update keys a su Manifest

Las update keys le dicen a SMAPI dónde se lanzó su mod, para que pueda informar a los jugadores cuando hay una nueva versión disponible. Esto requiere su ID de mod, que está disponible tan pronto como crea la página de mod (antes de cargar los archivos de mod). Consulte los documentos de comprobación de actualizaciones para obtener más información.

Sube la versión del mod

Pantalla de 'new file (nuevo archivo )' de Nexus.

Para subir un archivo a Nexus:

  1. Desde su página del mod Manage > Files.
  2. Rellene el formulario:
    • 'File name (Nombre de archivo)' debe tener el nombre y la versión del mod (como (like Piñas en todas partes 1.0).
    • El campo 'File version (Versión del archivo)' debe coincidir con la versión en su manifest.json! Si no es así, los jugadores pueden recibir alertas de actualización incorrectas.
    • Marque la casilla de verificación "this is the latest version (esta es la última versión)" para que los jugadores reciban alertas de actualización.
    • La 'File description (descripción del archivo)' depende de usted. Puede mencionar la versión mínima de SMAPI (si la hay), qué cambió, el enlace a las notas de la versión, etc.
  3. Sube el archivo .zip que preparó anteriormente.

Usando ModDrop

Lanzamiento a través de la página web

  1. Vaya a ModDrop y elija Upload Your Mod (Sube tu mod).
  2. Confirme que el mod es suyo para publicar para continuar.
  3. Escoger Upload a File from Your Computer (Sube un archivo desde tu computadora.).
  4. Elige un nombre para tu mod y sube el archivo .zip que preparó anteriormente. La página mostrará una marca verde al lado del nombre del mod si ese nombre está disponible para usar.
  5. Elija el nombre del archivo mod que desea mostrar, el número de versión, el estado de la versión (alfa, beta, versión), agregue una descripción (consulte los consejos de descripción de Nexus), y, opcionalmente, agregue notas del parche o notas para usted.
  6. Sube una imagen para tu mod.
  7. Ahora tendrá la oportunidad de crear una página de mod más detallada, incluidos enlaces a otras páginas donde se puede encontrar su modificación. También puede agregar más archivos, imágenes, videos y avisos para mostrar a los usuarios. También puedes elegir una categoría para tu mod. Si está cargando en nombre de otra persona (con permiso), también hay una sección para proporcionar crédito.
  8. Confirma nuevamente que tienes permiso para subir el mod para publicar. Puede cancelar esta página y reanudarla en otro momento.

Lanzamiento a través de la aplicación

  1. Abra la aplicación ModDrop y haga clic en su nombre de usuario (esquina superior derecha). Elija Forge.
  2. Elija Publish a new mod (Publicar un nuevo mod).
  3. Siga los mismos pasos enumerados anteriormente para el sitio.

Sincroniza Nexus mods con ModDrop

  1. Abra la aplicación ModDrop y haga clic en su nombre de usuario (esquina superior derecha). Elija Forge.
  2. Elija Sync my mods from another site (Sincronizar mis mods desde otro sitio.).
  3. Sigue las indicaciones para agregar tu clave API de Nexus.
  4. Elija Find new mods to sync (Encuentra nuevas mods para sincronizar) y sigue las indicaciones..
  5. Confirme que el mod es suyo para publicarlo y que ModDrop puede sincronizar actualizaciones desde su cuenta Nexus.
  6. Recibirá una confirmación de que la solicitud está completa. ModDrop revisa todos los envíos, por lo que su mod puede tardar un tiempo en aparecer en la aplicación/sitio.

Agregue update keys a su manifest

La update keys le dicen a SMAPI donde se publica tu mod, para que pueda informar a los jugadores cuando hay una nueva versión disponible. Esto requiere su ID de mod, que se puede encontrar después de crear la página de mod. Consulte los documentos de comprobación de actualizaciones para obtener más información.

Ir de código abierto

Se recomienda encarecidamente que sus mods sean de código abierto; ver Modding:Código abierto para más información.