Mod-Archive

Le Mod-Archive est, pour ainsi dire, simplement une version zippé d'un Directory-Mod valide. Cependant, parce-que OvGME a besoin de correctement aligner l'arborescence des fichiers du Mod avec ceux de la destination racine (root path) et déduire où chercher les données, un Mod-Archive valide doit suivre certaines règles simples. Si ces règles ne sont pas respectées, le fichier zip n'est pas vu comme un Mod-Archive.

- Le fichier zip DOIT être compressé au format ZIP.
  Pour l'instant, OvGME ne prend en charge que les fichiers compressés au format ZIP standard.
- Le fichier zip DOIT contenir un dossier-conteneur correctement nommé à sa racine.
  La racine de l'archive zip doit contenir le dossier-conteneur (et non directement les fichiers du Mod). Aussi, ce dossier-conteneur doit avoir le même nom que l'archive elle-même mais sans l'extension .zip. Par exemple, si vous avez un Mod-Archive nommé "My Super Mod.zip", il doit contenir un dossier-conteneur nommé "My Super Mod" où sont rangés les fichiers du mod. Ceci, car OvGME ne peut pas deviner quel dossier dans l'archive doit être considéré comme le dossier-conteneur et parce-que les Mod-Archives peuvent inclure d'autres fichiers que ceux du dossier racine (root folder), il cherche un dossier nommé exactement comme le fichier zip lui-même. C'est une convention.
- Le fichier zip peut optionnellement contenir un fichier de description
  OvGME vérifie automatiquement si un ficher .txt correctement nommé existe à la racine du fichier zip. Si ce fichier .txt est nommé "description.txt", "readme.txt" ou a exactement le même nom que le dossier-conteneur du mod ou du fichier zip lui-même (mais avec l'extension .txt au lieu de .zip), il sera considéré comme la description du mod. Ce fichier doit être au standard ASCII, OvGME ne supporte pas le texte enrichie pour le moment.
- Le fichier zip peut optionnellement contenir un fichier de version.
  OvGME vérifie automatiquement si un fichier nommé "version.txt" existe à la racine du fichier zip. Si ce fichier existe, il sera considéré comme la chaîne de version pur ce mod. Ce fichier doit être au standard .txt ASCII et la chaîne de version doit respecter le format décrits dans le chapitre Versioning de Mod.

Par exemple, si l'arborescence de fichiers du dossier racine est comme suit:

> 📁 MyGame
> 📁 Textures
> 📁 Landscape
> 📄 picture1.dds
> 📄 picture2.dds
> 📁 Vehicles
> 📄 picture1.dds
> 📄 picture2.dds

Et que votre mod consiste à changer quelques fichiers .dds de textures dans "MyGame\Textures\Vehicles", votre fichier zip de Mod-Archive devrait être structuré comme suit:

> 📂 My Texture Mod.zip
> {
> 📄 README.txt (optional)
> 📄 VERSION.txt (optional)
> 📁 My Texture Mod
> 📁 Textures
> 📁 Vehicles
> 📄 picture1.dds
> 📄 picture2.dds
> }

Ainsi, le fichier "My Texture Mod.zip" doit être copié dans le dossier de mods pour cette configuration, ou être importé en utilisant la fonction d'importation de mods.
Note: Pour créer un Mod-Archive, vous pouvez également utiliser l'outils fournit par OvGME, qui génère pour vous un fichier zip correctement structuré depuis un Directory-Mod existant (voir le chapitre Création de mod).