Difference between revisions of "BuildingUnits/fr"

From The Battle for Wesnoth Wiki
(Création de la page et traduction jusqu'à "Créer une nouvelle unité")
 
(Traduction jusqu'à "Utiliser votre nouvelle unité")
 
Line 13: Line 13:
 
== Créer une nouvelle unité ==
 
== Créer une nouvelle unité ==
  
The easiest way to make a new unit is to make a copy of an existing unit's configuration file and modify it. All units shipped with the game can be found in the game's <i>data/core/units</i> directory (see [[EditingWesnoth]] for how to find it).  
+
La manière la plus simple de fabriquer une nouvelle unité est de faire une copie du fichier de configuration d'une unité existante, et de modifier cette copie. Toutes les unités présentes dans le jeu de base peuvent être trouvées dans le dossier ''/data/core/units'' à la racine des dossiers du jeu (voir [[EditingWesnoth/fr|cette page]] ou sa [[EditingWesnoth|version anglaise]] pour plus d'instructions pour trouver ces fichiers.
  
When you are editing the file, pay attention to the property keys. If you forget to modify each key (for example, the unique id key), problems may arise, varying for minor issues such as lack of features on the unit, to game refusing to load the unit file, or, in the worst case, crashing the game.
+
En éditant le fichier, faites bien attention aux différentes propriétés. Si vous oubliez de modifier chaque clef (l'id par exemple), des problèmes pourront apparaître, allant de manque de caractéristiques chez l'unité, jusqu'à un crash du jeu, en passant par une impossibilité de charger l'unité dans le jeu.
  
For complete reference on unit properties see [[UnitTypeWML]]. Most of them are self-explanatory to anyone who has played Wesnoth for very long, and are brief but descriptive.  
+
Pour des références plus complètes sur les propriétés des unités, vous pouvez visiter [[UnitTypeWML/fr|cette page]] ([[UnitTypeWML|en]]). La plupart de ces références ont une fonction évidente pour des joueurs vétérans, et son courtes et descriptives.  
  
There are a few important basics:  
+
Il y a quelques principes de bases très importants :
  
* The first attribute of a unit type is the <b>id=</b> key, which is a unique identifier for that type. Whenever referring to a unit type via in a scenario, you use this id. It is not translatable. The <b>name=</b> key is the displayed name of the unit type in places such as help, the status table, and the sidebar, and is translatable. You can have a complex id, but a simple name. Remember that this is <b>NOT</b> the same as the name of a specific instance of a unit created in a scenario via [unit].
+
* La première attribution d'un type d'unité est sa clef '''id=''', qui est un identifiant unique à chaque type. Pour se référer à un type d'unité dans un scénario, vous devrez utiliser cet id. Il n'est pas traductible. La clef '''name=''' est le nom de l'unité qui est affiché dans l'aide, la table des statut, ou encore dans la barre latérale, qui est traductible. Vous pouvez avoir un id complexe et un nom très simple. Vous devez comprendre que ce n'est pas le même nom que celui renseigné au moment de créer une unité dans un scénario au moyen du tag '''[unit]'''.
* When referencing the unit type, the id must be reproduced verbatim, without typos, and in a case-sensitive manner. If you don't do this, the game will throw Unknown Unit errors.  
+
* Pour se référencer à un type d'unité, l'id doit être renseigné tel quel, sans faute de frappe et de manière sensible à la casse. Si cela n'est pas respecté, le jeu générera des erreurs '''Unknow Unit'''.
* Do not set <b>movement=</b> to 0. It creates weird infinite movement behavior. This might be fixed in the future. For now, to make an immobile unit, set movement to 1 and use [movement_costs] to make it unable to move onto any terrain.
+
* N'initialisez pas '''movement=''' à 0. Cela crée un comportement bizarre de mouvement infini. Ce bug sera sûrement fixé dans le futur. Pour l'instant, pour rendre une unité immobile, initialisez son tag '''movement''' à 1 et utilisez '''[movement_costs]''' pour la rendre incapable de bouger sur tous les terrains.
 +
 
 +
== Utiliser votre nouvelle unité ==
 +
 
 +
Les fichiers de configurations de vos unités doivent être placés dans votre dossier ''units'' de votre add-on, et leurs images dans le dossier ''images/units''. Faites attention, il faut inclure le fichier ''units'' dans votre fichier ''_main.cfg''. L'inclusion pour ce dossier devra être compris à l'intérieur d'un tag '''[+units] [/units]'''. Voir [[AddonStructure/fr|cette page]] ([[AddonStructure|en]]) pour un exemple.
  
== Using your new unit ==
 
  
Custom unit configuration files should be put in your add-on's <i>units</i> directory, and their custom graphics in the <i>images/units</i> directory. Be sure to have the <i>units</i> directory included from your _main.cfg. The include for this directory, however, should be wrapped in a <b>[+units][/units]</b> tag pair. See [[AddonStructure]] for an example.
 
  
 
All units in this directory will now be accessible in any content loaded under the same <b>#ifdef</b> conditional. You can now allow sides to recruit the unit by listing it in the <b>recruit=</b> key in [side] (see [[SideWML]], place instances of it on the map with their own custom stats via [unit], or anything else you please.
 
All units in this directory will now be accessible in any content loaded under the same <b>#ifdef</b> conditional. You can now allow sides to recruit the unit by listing it in the <b>recruit=</b> key in [side] (see [[SideWML]], place instances of it on the map with their own custom stats via [unit], or anything else you please.

Latest revision as of 13:19, 14 November 2019



En créant du contenu original, vous pourriez vouloir inventer une nouvelle unité. Cette page va vous expliquer toutes les étapes de la création d'une nouvelle unité, et vous montrer comment l'utiliser dans le jeu.

Avant de commencer, vous devez vous souvenir que le tag [unit_type] (en) créé un nouveau type d'unité, tandis que le tag [unit] (en) vous permet d'utiliser une unité dans un scénario. Cet article va se focaliser sur le premier tag.

Créer une nouvelle unité

La manière la plus simple de fabriquer une nouvelle unité est de faire une copie du fichier de configuration d'une unité existante, et de modifier cette copie. Toutes les unités présentes dans le jeu de base peuvent être trouvées dans le dossier /data/core/units à la racine des dossiers du jeu (voir cette page ou sa version anglaise pour plus d'instructions pour trouver ces fichiers.

En éditant le fichier, faites bien attention aux différentes propriétés. Si vous oubliez de modifier chaque clef (l'id par exemple), des problèmes pourront apparaître, allant de manque de caractéristiques chez l'unité, jusqu'à un crash du jeu, en passant par une impossibilité de charger l'unité dans le jeu.

Pour des références plus complètes sur les propriétés des unités, vous pouvez visiter cette page (en). La plupart de ces références ont une fonction évidente pour des joueurs vétérans, et son courtes et descriptives.

Il y a quelques principes de bases très importants :

  • La première attribution d'un type d'unité est sa clef id=, qui est un identifiant unique à chaque type. Pour se référer à un type d'unité dans un scénario, vous devrez utiliser cet id. Il n'est pas traductible. La clef name= est le nom de l'unité qui est affiché dans l'aide, la table des statut, ou encore dans la barre latérale, qui est traductible. Vous pouvez avoir un id complexe et un nom très simple. Vous devez comprendre que ce n'est pas le même nom que celui renseigné au moment de créer une unité dans un scénario au moyen du tag [unit].
  • Pour se référencer à un type d'unité, l'id doit être renseigné tel quel, sans faute de frappe et de manière sensible à la casse. Si cela n'est pas respecté, le jeu générera des erreurs Unknow Unit.
  • N'initialisez pas movement= à 0. Cela crée un comportement bizarre de mouvement infini. Ce bug sera sûrement fixé dans le futur. Pour l'instant, pour rendre une unité immobile, initialisez son tag movement à 1 et utilisez [movement_costs] pour la rendre incapable de bouger sur tous les terrains.

Utiliser votre nouvelle unité

Les fichiers de configurations de vos unités doivent être placés dans votre dossier units de votre add-on, et leurs images dans le dossier images/units. Faites attention, il faut inclure le fichier units dans votre fichier _main.cfg. L'inclusion pour ce dossier devra être compris à l'intérieur d'un tag [+units] [/units]. Voir cette page (en) pour un exemple.


All units in this directory will now be accessible in any content loaded under the same #ifdef conditional. You can now allow sides to recruit the unit by listing it in the recruit= key in [side] (see SideWML, place instances of it on the map with their own custom stats via [unit], or anything else you please.

Multiplayer factions and eras

Another common use of custom units it to group them into a multiplayer faction, and group one or several factions together into an era. A faction is several units that represent a common theme, such as the Loyalists. An era is several factions grouped together, usually under a common theme, but can also be done so for other reasons; an example would be the Default era, which contains all the eras used in multiplayer.

Note: Remember that eras and factions is a construct unique to multiplayer.

More detailed instructions on factions and eras can be found in BuildingFactions and EraWML articles. A faction, if there's only one, must be included in an era. You will not be able to add your units to any era that ships with the game.

See Also

This page was last edited on 14 November 2019, at 13:19.