Modding:Empaquetado de Mod

This page was last verified for Vintage Story version 1.15.

Si su mod sólo modifica elementos visuales, sonidos y otros recursos de "tematización", consulte también la página Pack Temático.

Archivos Zip

Para que su mod sea fácil de instalar y utilizar, debe empaquetarse en un archivo zip [1]. Todos los recursos (imágenes, archivos .json, etc.) van en un directorio "assets" en la raíz del zip, todos los archivos fuente en la carpeta "src" y todas las DLL (y, opcionalmente, los archivos PDB) van directamente en la carpeta raíz del archivo zip.

Tenga en cuenta que si tiene un mod de código que no tiene recursos (es decir, su mod es una única DLL de C#), es posible enviar la DLL desnuda sin empaquetarla en un zip. Sin embargo, esto no es realmente una buena idea, ya que cuando se distribuye de esta manera es difícil incluir un archivo PDB y la descarga de DLL directamente en Windows puede dar lugar a problemas con su mod no se carga debido a las políticas de seguridad aplicadas a los archivos descargados de Internet.

Estructura de archivos Zip
.zip
assets
domain
asset files (visión general del árbol)
modinfo.json
modicon.png
archivos fuente compilados (*.dll and *.pdb)
src
archivos de código fuente - carpetas permitidas (*.cs)

Archivo de información

Todo mod en formato zip requiere un modinfo.json dentro del directorio raíz del archivo. De lo contrario, todo el mod será ignorado. Este archivo de información especifica qué tipo de mod es, su nombre, autor, etc.

Ejemplo de archivo de información de un paquete de temas (modinfo.json):

{
  "type": "content",
  "modid": "moddeejemplocreativemd",
  "name": "Mi mod de contenido de ejemplo",
  "description" : "Este es un mod de ejemplo, que no hace nada",
  "authors": ["CreativeMD"],
  "version": "1.0",
  "dependencies": { 
	"game": "",
	"survival": ""
  },
  "website": "http://example.com"
}

---

  "type": "content",

Además de "type": "content", también existe "type": "theme" y "type": "code".

• "type": "content": Define este mod como Content Mod. Los Mods de Contenido no pueden contener ningún código C# (si lo hace serán ignorados).
• "type": "theme": Define este mod como un Theme Pack. Los Packs Temáticos no pueden anular las categorías de activos que afectan a la jugabilidad (como tipos de bloque, tipos de objeto, etc.) y no se cargará código C#.
• "type": "code": Define este mod como Code Mod. Los Mods de Código son iguales que los Content Mods, excepto que también pueden cargar código C# para hacer cosas que no son posibles con JSON.

  "dependencies": {
    "game": "1.5.3"
  },

Significa que requiere al menos VintageStory v1.5.3 o una versión más reciente. Para más información consulta Modinfo.

Ícono

Nota: Iconos mod soportados a partir de 1.16.

El archivo modicon.png (si existe) se utilizará y se mostrará en el menú del gestor de mods.

Distribución e Instalación

Para instalar un mod simplemente coloca el archivo zip en el directorio Mods de tu Carpeta de Vintagestory.

Puedes subir tu mod a la Vintage Story Mod Database para que la gente pueda encontrarlo.

Wondering where some links have gone?
The modding navbox is going through some changes! Check out Navigation Box Updates for more info and help finding specific pages.