Syntaxe des fichiers
Les fichiers de configuration des packs permettent d'ajouter tous types de contenus, allant de simples items à des véhicules, en passant par les armures, les blocs et les props.
Ils partagent une même syntaxe que vous apprendrez ici.
Nom des fichiers
Le type d'un fichier est détecté à l'aide de son préfixe : un item s'appellera item_nom_de_litem, et une voiture vehicle_nom_du_vehicule.
Voici tous les types de fichiers reconnus par DynamX (vous pouvez en ajouter via le système d'addons) :
| Objet | Préfixe | Documentation |
|---|---|---|
| PackInfo | pack_info.dynx | Fichier obligatoire dans chaque pack : configuration |
| Item | item_ | Exemple plus bas et configuration complète |
| Armure | armor_ | Configuration - Armures |
| Bloc | block_ | Configuration - Blocs et props |
| Prop | prop_ | Configuration - Blocs et props |
| Voiture | vehicle_ | Configuration - Véhicules |
| Remorque | trailer_ | Configuration - Véhicules |
| Bateau | boat_ | Configuration - Véhicules |
| Hélicoptère | helicopter_ | Configuration - Véhicules |
- Propriétés :
Les propriétés "simples" sont définies sur une ligne selon le schéma mot-cle: valeur, par exemple Description: Ceci est une description. Une propriété par ligne au maximum !
- Sous-propriétés :
Les sous propriétés définissent les propriétés d'un élément particulier d'un objet, par exemple le volant d'une voiture. La syntaxe est la suivante :
SousPropriete{
mot-cle1: valeur1
mot-cle2: valeur2
//etc
}
Vous en verrez des illustrations dans la suite de la documentation...
Warning
Attention, l'accolade ouvrante { doit être juste après le nom de la sous-propriété, sur la même ligne !
De même l'accolade fermante } doit être seule sur sa ligne.
- Commentaires :
Vous pouvez commenter une ligne en ajoutant // au début de celle-ci.
Vous pouvez également ajouter des commentaires multilignes, en ajoutant /* au début et */ à la fin.
Warning
/* doit être placé au début d'une ligne, et */ à la fin.
De plus si un commentaire commence dans des accolades, il doit finir à l'intérieur de ces mêmes accolades (et inversement).
Exemples :
Name: Ceci marche
/*Commentaire
SousPropriete{
mot-cle1: valeur1
mot-cle2: valeur2
//etc
}
Fin du commentaire*/
Name: Ceci marche aussi
SousPropriete{
/*Commentaire
mot-cle1: valeur1
mot-cle2: valeur2
Fin du commentaire*/
mot-cle3: valeur3
}
Name: Ceci ne marche pas
SousPropriete{
/*Commentaire
mot-cle1: valeur1
mot-cle2: valeur2
}
Fin du commentaire*/
Modifier une propriété en jeu
Pour configurer plus facilement vos objets, vous pouvez recharger leurs propriétés pendant que le jeu est lancé en effectuant la commande /dynamx reload_config (ceci rechargera les packs pour vous, le serveur auquel vous êtes connecté et tous les autres joueurs), ou en utilisant le bouton dédié dans le menu de debug (cela ne rechargera les packs que sur votre jeu, pas sur le serveur auquel vous être connecté).
Cela rechargera la majorité des propriétés (saufs les noms de modèles par exemple), et permet de corriger les erreurs mineures (en orange dans le rapport des erreurs du menu principal/du chat). A partir de la version 4.0.0 de DynamX, même plus besoin de reposer les props ou les véhicules (sauf si vous modifiez ses propriétés physiques comme sa masse ou ses suspensions) !
Pour recharger les modèles et leurs textures, vous pouvez utiliser le bouton correspondant dans le menu de debug.
Exemple : ajout d'items
Pour ajouter un item, créez dans votre pack un fichier item_votre_item.dynx puis indiquez-y :
Name: NomDeLitemEnJeu
Description: Lore de l'item
Model: obj/nom_de_litem/nom_du_modele.obj
Info
La traduction du nom de l'item est automatiquement créée avec la valeur de "Name"
Plus d'informations sur la configuration d'un item sont disponibles ici.