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.
Modding | |
---|---|
Modding Introduction | Getting Started • Pack Temático |
Content Modding | Content Mods • Developing a Content Mod • Basic Tutorials • Intermediate Tutorials • Advanced Tutorials • Content Mod Concepts |
Code Modding | Code Mods • Setting up your Development Environment |
Property Overview | Item • Entity • Block • Block Behaviors • Block Classes • Block Entities • Block Entity Behaviors • World properties |
Workflows & Infrastructure | Modding Efficiency Tips • Mod-engine compatibility • Mod Extensibility • VS Engine |
Additional Resources | Community Resources • Modding API Updates • Programming Languages • List of server commands • List of client commands • Client startup parameters • Server startup parameters Example Mods • API Docs • GitHub Repository |