Modding: Pour débuter

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.

Main

Modding

BlockJson

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

Avançons

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.

The first thing to do while starting your first 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.

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.

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.