Modding:Getting Started/fr: Difference between revisions

From Vintage Story Wiki
(Created page with "{{GameVersion|1.19.6}}")
No edit summary
 
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>{{GameVersion|1.19.6}}
<languages/>{{GameVersion|1.19.6}}


<div lang="en" dir="ltr" class="mw-content-ltr">
Vintage Story dispose d'un système de modding complet intégré au jeu, permettant à tout utilisateur d'apporter les modifications et les ajouts qu'il juge nécessaires.
Vintage story has an extensive modding system built into the game, allowing any user to make their own changes and additions as they see fit.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Avant de commencer, il est important de comprendre ce que vous souhaitez accomplir afin de savoir à quoi vous attendre.  
Before you get started, it's important to understand what you would like to accomplish so you can know what to expect.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
__TOC__
__TOC__
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
== Chercher dans le wiki ==
== Searching the wiki ==
Par défaut, la fonction de recherche du wiki exclut les pages de modding. Pour mettre à jour vos préférences de recherche, cliquez sur le bouton "Recherche Modding" ci-dessous. La page de résultats montrera que les espaces de noms (Main), BlockJson, et Modding sont cochés. Cochez la case "Mémoriser la sélection pour les recherches futures", puis cliquez sur le bouton "Recherche" pour enregistrer les modifications.
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>


<div lang="en" dir="ltr" class="mw-content-ltr">
{{#tag:inputbox|
{{#tag:inputbox|
type=search
type=search
Line 24: Line 15:
break=no
break=no
width=40
width=40
searchbuttonlabel=Search Modding
searchbuttonlabel=Recherche Modding
}}
}}
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
== Quels Mods puis-je faire ? ==
== What Mods can I make? ==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Le système de modding actuel de Vintage Story est incroyablement flexible et très facile à utiliser, même si vous ne savez pas programmer. Vous pouvez ajouter des '''blocs''', des '''objets''' et même des '''entités''' dans le jeu sans jamais ouvrir un [https://en.wikipedia.org/wiki/Integrated_development_environment IDE].
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]. More complex changes and systems can be made using C# programming.
Mais des modifications et des systèmes plus complexes peuvent être réalisés en programmant en C#.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
En effet, presque toutes les fonctionnalités du jeu reposent sur l'utilisation de '''JSONs''', qui sont des documents textuels utilisant une syntaxe facile à lire. Vous pouvez ouvrir ces fichiers avec n'importe quel éditeur de texte et, avec un peu de pratique, vous apprendrez à les formater pour éviter les erreurs. La meilleure façon d'apprendre cela est d'étudier les JSON existants qui sont visibles par toute personne ayant installé le jeu. Pour ce faire, vous devez localiser le dossier Vintage Story Assets, que vous pouvez découvrir sur la page '''[[Modding:Asset System |Asset System]]'''.<br>En outre, voici une [https://www.youtube.com/watch?v=iiADhChRriM vidéo de 12 minutes] qui vous apprendra pourquoi le json est utilisé et la syntaxe de base, ce qui facilitera la compréhension du reste de la documentation.
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:Asset System |Asset System]]''' page. <br>In addition, here is a [https://www.youtube.com/watch?v=iiADhChRriM 12 minute video] that will teach you why json is used, and the basic syntax, making it easier to understand the rest of the documentation.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Si vous cherchez à ajouter des systèmes plus complexes à Vintage Story, vous pouvez également le faire, mais vous ne pourrez probablement pas le faire qu'avec les fichiers JSON. Vintage Story est écrit en C#, et il est fortement recommandé d'apprendre les bases de la programmation et du C# en général avant de passer à des mods plus complexes qui ne peuvent pas être accomplis avec seulement des fichiers JSON.
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>


<div lang="en" dir="ltr" class="mw-content-ltr">
== Types de Mods ==
== Types of Mods ==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
En général, il y a 3 types principaux de mods que l'on peut créer pour Vintage Story, chacun ayant des niveaux de complexité différents :
In general there are 3 main types of mods one can create for Vintage Story, with each having different levels of complexity:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
* [[Modding:Theme Pack | Theme Packs]] : Il s'agit de mods qui n'affectent que l'aspect visuel et n'ajoutent pas de contenu ou ne modifient pas les fonctionnalités de manière significative.
* [[Modding:Theme Pack | Theme Packs]]: These are mods that only affect visuals and don't add more content or change features significantly.
* [[Modding:Content Mods | Content Mods]] : Il s'agit de mods qui ajoutent du contenu supplémentaire (blocs, objets, mobs) au jeu, mais qui n'utilisent pas de code C# et se limitent pour la plupart à des JSON.
* [[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]] : Il s'agit de mods qui ajoutent des fonctionnalités et des systèmes plus complexes nécessitant l'utilisation de code C#.
* [[Modding:Code Mods | Code Mods]]: These are mods that add more complex features and systems that require the use of C# code to accomplish.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
== Aller Plus Loin ==
== Moving Forward ==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Si vous débutez, il est préférable de commencer par un mod de contenu, car la plupart des mods de code ne font qu'étendre les fonctionnalités des blocs, des objets et des entités créés à partir d'un mod de contenu. Une fois que vous aurez maîtrisé les mods de contenu, vous pourrez passer au codage si vous voulez ajouter des choses vraiment spéciales à votre expérience de Vintage Story.
If you're just starting out, it's 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.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Les programmeurs plus expérimentés peuvent être tentés de passer immédiatement aux mods de code, mais on vous conseille vraiment de vous familiariser d'abord avec les mods de contenu, car vous les utiliserez presque certainement en tandem avec tout code C# que vous écrirez.  
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.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
La première chose à faire en commençant votre premier mod est de vous familiariser avec le ''[[Modding:Asset System |Asset System]]''. C'est là que s'accomplit la plus grande partie de la magie de Vintage Story, et vous utiliserez ces ressources en permanence pendant votre modding.  
The first thing to do while starting your first mod is to familiarize yourself with the '''[[Modding: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>


<div lang="en" dir="ltr" class="mw-content-ltr">
Pour continuer avec un mod de contenu, rendez-vous sur la page [[Modding:Content Mods|Content Mods]].
To move on with a content mod, head over to the [[Modding:Content Mods|Content Mods]] page.
Pour commencer avec un theme pack, rendez-vous sur la page [[Modding:Theme_Pack|Theme Pack]].
To start with a theme pack, head over to the [[Modding:Theme_Pack|Theme Pack]] page.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
{{Navbox/modding|Vintage Story}}
{{Navbox/modding|Vintage Story}}
</div>

Latest revision as of 19:30, 15 July 2024

Other languages:

Cette page a été vérifiée pour la dernière fois pour Vintage Story avec la version 1.19.6.


Vintage Story dispose d'un système de modding complet intégré au jeu, permettant à tout utilisateur d'apporter les modifications et les ajouts qu'il juge nécessaires.

Avant de commencer, il est important de comprendre ce que vous souhaitez accomplir afin de savoir à quoi vous attendre.

Chercher dans le wiki

Par défaut, la fonction de recherche du wiki exclut les pages de modding. Pour mettre à jour vos préférences de recherche, cliquez sur le bouton "Recherche Modding" ci-dessous. La page de résultats montrera que les espaces de noms (Main), BlockJson, et Modding sont cochés. Cochez la case "Mémoriser la sélection pour les recherches futures", puis cliquez sur le bouton "Recherche" pour enregistrer les modifications.

Quels Mods puis-je faire ?

Le système de modding actuel de Vintage Story est incroyablement flexible et très facile à utiliser, même si vous ne savez pas programmer. Vous pouvez ajouter des blocs, des objets et même des entités dans le jeu sans jamais ouvrir un IDE. Mais des modifications et des systèmes plus complexes peuvent être réalisés en programmant en C#.

En effet, presque toutes les fonctionnalités du jeu reposent sur l'utilisation de JSONs, qui sont des documents textuels utilisant une syntaxe facile à lire. Vous pouvez ouvrir ces fichiers avec n'importe quel éditeur de texte et, avec un peu de pratique, vous apprendrez à les formater pour éviter les erreurs. La meilleure façon d'apprendre cela est d'étudier les JSON existants qui sont visibles par toute personne ayant installé le jeu. Pour ce faire, vous devez localiser le dossier Vintage Story Assets, que vous pouvez découvrir sur la page Asset System.
En outre, voici une vidéo de 12 minutes qui vous apprendra pourquoi le json est utilisé et la syntaxe de base, ce qui facilitera la compréhension du reste de la documentation.

Si vous cherchez à ajouter des systèmes plus complexes à Vintage Story, vous pouvez également le faire, mais vous ne pourrez probablement pas le faire qu'avec les fichiers JSON. Vintage Story est écrit en C#, et il est fortement recommandé d'apprendre les bases de la programmation et du C# en général avant de passer à des mods plus complexes qui ne peuvent pas être accomplis avec seulement des fichiers JSON.

Types de Mods

En général, il y a 3 types principaux de mods que l'on peut créer pour Vintage Story, chacun ayant des niveaux de complexité différents :

  • Theme Packs : Il s'agit de mods qui n'affectent que l'aspect visuel et n'ajoutent pas de contenu ou ne modifient pas les fonctionnalités de manière significative.
  • Content Mods : Il s'agit de mods qui ajoutent du contenu supplémentaire (blocs, objets, mobs) au jeu, mais qui n'utilisent pas de code C# et se limitent pour la plupart à des JSON.
  • Code Mods : Il s'agit de mods qui ajoutent des fonctionnalités et des systèmes plus complexes nécessitant l'utilisation de code C#.

Aller Plus Loin

Si vous débutez, il est préférable de commencer par un mod de contenu, car la plupart des mods de code ne font qu'étendre les fonctionnalités des blocs, des objets et des entités créés à partir d'un mod de contenu. Une fois que vous aurez maîtrisé les mods de contenu, vous pourrez passer au codage si vous voulez ajouter des choses vraiment spéciales à votre expérience de Vintage Story.

Les programmeurs plus expérimentés peuvent être tentés de passer immédiatement aux mods de code, mais on vous conseille vraiment de vous familiariser d'abord avec les mods de contenu, car vous les utiliserez presque certainement en tandem avec tout code C# que vous écrirez.

La première chose à faire en commençant votre premier mod est de vous familiariser avec le Asset System. C'est là que s'accomplit la plus grande partie de la magie de Vintage Story, et vous utiliserez ces ressources en permanence pendant votre modding.

Pour continuer avec un mod de contenu, rendez-vous sur la page Content Mods. Pour commencer avec un theme pack, rendez-vous sur la page Theme Pack.

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 • Theme Pack
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


Retrieved from "https://wiki.vintagestory.at/index.php?title=Modding:Getting_Started/fr&oldid=187934"