Modding:Primeros pasos
This page was last verified for Vintage Story version 1.15.
Vintage Story cuenta con un amplio sistema de modificación integrado en el juego, que permite a cualquier usuario realizar los cambios y añadidos que considere oportunos.
Para una visión general del sistema y la filosofía de modificación del juego, consulta la página Modding en el sitio web de Vintage Story.
Antes de empezar, es importante saber qué quiere conseguir para saber qué puede esperar.
¿Qué mods puedo hacer?
El actual sistema de modding de Vintage Story es increíblemente flexible y bastante fácil de usar incluso si no sabes programar. Puedes añadir al juego bloques, objetos e incluso entidades totalmente funcionales sin necesidad de abrir un IDE. Aunque es recomendable que aprendas a usar uno si planeas hacer mucho modding en el futuro, ya que son muy convenientes.
Esto se debe a que casi todas las características del juego se basan en el uso de JSONs', que son documentos de texto que utilizan un formato flexible y fácil de leer. Puedes abrir estos archivos con cualquier editor de texto, y con un poco de práctica puedes aprender a formatearlos para evitar errores. La mejor manera de aprender esto es estudiar los JSON existentes que son visibles para cualquiera que tenga el juego instalado. Para ello necesitarás localizar la carpeta de Activos de Vintage Story, sobre la que puedes aprender en la página Sistema de activos.
Si quieres añadir sistemas más complejos a Vintage Story, también puedes hacerlo, pero probablemente no podrás hacerlo sólo con JSONs. Vintage Story está escrito en C#, y es muy recomendable que aprenda los conceptos básicos de programación y de C# en general antes de pasar a mods más complejos que no se pueden lograr con sólo JSONs.
Types of Mods
In general there are 3 main types of mods one can create for Vintage Story, with each having different levels of complexity:
- Theme Packs: These are mods that only affect visuals and don't add more content or change features significantly.
- Content Mods: These are mods that add additional content (i.e. blocks, items, mobs) to the game but don't utilize C# code and are mostly limited to JSONs.
- Code Mods: These are mods that add more complex features and systems that require the use of C# code to accomplish.
Moving Forward
If you're just starting out it is certainly best to begin with a content mod, as most code mods simply extend the features of blocks, items and entities made from a content mod anyway. Once you've mastered content mods you can move onto coding if you want to add some really special things to your Vintage Story experience.
More advanced programmers may be tempted to jump to code mods immediately, but it is still highly suggested you familiarize yourself with content mods first since you'll almost certainly be using them in tandem with any C# code you write.
The first thing you can do while starting your first content mod is to familiarize yourself with the Asset System. This is where most of the magic in Vintage Story is accomplished, and you'll be using these resources constantly while modding.
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 • Entity Behaviors • Block • Block Behaviors • Block Classes • Block Entities • Block Entity Behaviors • Collectible 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 |