Modding:Getting Started/es: Difference between revisions

From Vintage Story Wiki
(Created page with "Antes de empezar, es importante saber qué quiere conseguir para saber qué puede esperar.")
(Updating to match new version of source page)
Tags: Mobile edit Mobile web edit
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>{{GameVersion|1.15}}
<languages/><div class="mw-translate-fuzzy">
{{GameVersion|1.15}}
</div>


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.
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 [https://www.vintagestory.at/features/modding.html/ Modding] en el sitio web de Vintage Story.


Antes de empezar, es importante saber qué quiere conseguir para saber qué puede esperar.  
Antes de empezar, es importante saber qué quiere conseguir para saber qué puede esperar.  
Line 9: Line 9:
__TOC__
__TOC__


== What Mods can I make? ==
<div lang="en" dir="ltr" class="mw-content-ltr">
== Searching the wiki ==
By default the wiki's search feature excludes the modding pages. To update your search preferences, click the "Search Modding" button below. The results page will show that the (Main), BlockJson, and Modding namespaces are checked. Check "Remember selection for future searches", then click search to save the changes.
</div>


The current modding system for Vintage Story is incredibly flexible and quite easy to use even if you don't know how to program. You can add fully functional '''blocks''', '''items''' and even '''entities''' into the game without ever opening an [https://en.wikipedia.org/wiki/Integrated_development_environment IDE]. Although it is recommended you learn how to use one if you plan on modding a lot in the future, as they are very convenient.
<div lang="en" dir="ltr" class="mw-content-ltr">
{{#tag:inputbox|
type=search
namespaces=Main**,Modding**,BlockJson**
break=no
width=40
searchbuttonlabel=Search Modding
}}
</div>


This is because nearly every feature of the game relies on the usage of '''JSONs''', which are text documents that utilize a flexible, easy to read format. You can open these files with any text editor, and with just a little bit of practice you can learn how to format them to avoid errors. The best way to learn this is to study the existing JSONs that are visible to anybody who has the game installed. To do so you'll need to locate the Vintage Story Assets folder, which you can learn about at the '''[[Modding:The Asset System | Asset System]]''' page.
== ¿Qué mods puedo hacer? ==


If you're looking to add more complex systems to Vintage story you can accomplish this as well, but you likely won't be able to do this with JSONs alone. Vintage Story is written in C#, and it is highly suggested you learn the basics of programming and of C# in general before moving onto more complex mods that can't be accomplished with just JSONs.
<div class="mw-translate-fuzzy">
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 [https://en.wikipedia.org/wiki/Integrated_development_environment IDE]. Aunque es recomendable que aprendas a usar uno si planeas hacer mucho modding en el futuro, ya que son muy convenientes.
</div>


== Types of Mods ==
<div class="mw-translate-fuzzy">
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 '''[[Modding:The Asset System | Sistema de activos]]'''.
</div>


In general there are 3 main types of mods one can create for Vintage Story, with each having different levels of complexity:
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.


* [[Modding:Theme Packs | Theme Packs]]: These are mods that only affect visuals and don't add more content or change features significantly.
== Tipos de Mods ==
* [[Modding:Content Mods | 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.
* [[Modding:Code Mods | Code Mods]]: These are mods that add more complex features and systems that require the use of C# code to accomplish.


== Moving Forward ==
En general, hay tres tipos principales de mods que se pueden crear para Vintage Story, cada uno con diferentes niveles de complejidad:


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.
* [[Modding:Theme_Pack/es| Paquetes de temas]]: Son mods que sólo afectan a lo visual y no añaden más contenido ni cambian características de forma significativa.
* [[Modding:Content Mods | Mods de contenido]]: Se trata de mods que añaden contenido adicional (es decir, bloques, objetos, mobs) al juego, pero no utilizan código C# y se limitan principalmente a JSONs.
* [[Modding:Code Mods | Mods de Código]]: Son mods que añaden características y sistemas más complejos que requieren el uso de código C# para su realización.


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.
== Seguir avanzando ==


The first thing you can do while starting your first content mod is to familiarize yourself with the '''[[Modding:The Asset System | Asset System]]'''. This is where most of the magic in Vintage Story is accomplished, and you'll be using these resources constantly while modding.  
<div class="mw-translate-fuzzy">
Si estás empezando, lo mejor es empezar con un mod de contenido, ya que la mayoría de los mods de código simplemente amplían las características de los bloques, objetos y entidades creados a partir de un mod de contenido. Una vez que domines los mods de contenido, puedes pasar a los de código si quieres añadir cosas realmente especiales a tu experiencia Vintage Story.
</div>
 
Los programadores más avanzados pueden tener la tentación de saltar a los mods de código inmediatamente, pero aún así es muy recomendable que se familiarice primero con los mods de contenido, ya que es casi seguro que los utilizará junto con cualquier código C# que escriba.
 
<div class="mw-translate-fuzzy">
Lo primero que puedes hacer al empezar tu primer mod de contenido es familiarizarte con el ''[[Modding:Asset System|Sistema de activos]]'''. Aquí es donde se realiza la mayor parte de la magia de Vintage Story, y utilizarás estos recursos constantemente mientras moddes.
</div>
 
<div lang="en" dir="ltr" class="mw-content-ltr">
To move on with a content mod, head over to the [[Modding:Content Mods|Content Mods]] page.
To start with a theme pack, head over to the [[Modding:Theme_Pack|Theme Pack]] page.
</div>


{{Navbox/modding|Vintage Story}}
{{Navbox/modding|Vintage Story}}
[[Category:Modding{{#translation:}}]]

Latest revision as of 12:44, 19 November 2024

Other languages:

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.

Antes de empezar, es importante saber qué quiere conseguir para saber qué puede esperar.

Searching the wiki

By default the wiki's search feature excludes the modding pages. To update your search preferences, click the "Search Modding" button below. The results page will show that the (Main), BlockJson, and Modding namespaces are checked. Check "Remember selection for future searches", then click search to save the changes.

¿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.

Tipos de Mods

En general, hay tres tipos principales de mods que se pueden crear para Vintage Story, cada uno con diferentes niveles de complejidad:

  • Paquetes de temas: Son mods que sólo afectan a lo visual y no añaden más contenido ni cambian características de forma significativa.
  • Mods de contenido: Se trata de mods que añaden contenido adicional (es decir, bloques, objetos, mobs) al juego, pero no utilizan código C# y se limitan principalmente a JSONs.
  • Mods de Código: Son mods que añaden características y sistemas más complejos que requieren el uso de código C# para su realización.

Seguir avanzando

Si estás empezando, lo mejor es empezar con un mod de contenido, ya que la mayoría de los mods de código simplemente amplían las características de los bloques, objetos y entidades creados a partir de un mod de contenido. Una vez que domines los mods de contenido, puedes pasar a los de código si quieres añadir cosas realmente especiales a tu experiencia Vintage Story.

Los programadores más avanzados pueden tener la tentación de saltar a los mods de código inmediatamente, pero aún así es muy recomendable que se familiarice primero con los mods de contenido, ya que es casi seguro que los utilizará junto con cualquier código C# que escriba.

Lo primero que puedes hacer al empezar tu primer mod de contenido es familiarizarte con el Sistema de activos'. Aquí es donde se realiza la mayor parte de la magia de Vintage Story, y utilizarás estos recursos constantemente mientras moddes.

To move on with a content mod, head over to the Content Mods page. To start with a theme pack, head over to the Theme Pack page.

Icon Sign.png

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 ItemEntityEntity BehaviorsBlockBlock BehaviorsBlock ClassesBlock EntitiesBlock Entity BehaviorsCollectible BehaviorsWorld properties
Workflows & Infrastructure Modding Efficiency TipsMod-engine compatibilityMod ExtensibilityVS Engine
Additional Resources Community Resources Modding API Updates Programming Languages List of server commandsList of client commandsClient startup parametersServer startup parameters
Example ModsAPI DocsGitHub Repository