Différences

Ci-dessous, les différences entre deux révisions de la page.

--- masques [2015/03/31 14:51]
aale
+++ masques [2015/04/30 16:41] (Version actuelle)
aale
@@ Ligne 1: / Ligne 1: @@
+====== Principe ======
 Les masques permettent de générer automatiquement le rapport de tour en fonction de la réussite (ou de l'échec) des ordres. L'[[http://map.muad.com/mask_maker.php|éditeur de masque]] permet d'augmenter les possibilités de ce retour d'informations pour les différents ordres. Des mots-clés sont nécessaires à la contextualisation :
+A un ordre peut correspondre plusieurs masques suivant les possibilités de cas de figures que cet ordre peut entraîner. Pour les ordres automatiques (réussite garantie), un seul ; pour le kidnapping (#620), 5 masques sont nécessaires:
+  - 620 : kidnapping réussi
+  - 620.1 : kidnapping manqué
+  - 620.2 : kidnapping impossible (cible non présente)
+  - 620.5 : masque pour le joueur de l'otage -> son héros a réussi à s'échapper
+  - 620.6 : masque pour le joueur du kidnappeur -> l'otage s'est enfui
+====== Visibilité ======
+A chaque ordre est associé un paramètre dit de visibilité, par exemple
+<WRAP center round box 60%>
+Visibility = 0003000000001000000000000
+</WRAP>
+Ici, le résultat de l'ordre à retourner peut donc concerner potentiellement 25 nations. Suivant le rôle de chaque nation dans l'ordre initié, 7 qualités différentes d'implications sont énoncées :
+  - auteur
+  - cible ou allié
+  - témoin
+  - allié du témoin
+  - témoin indirect, infos limitées
+  - allié du témoin indirect
+  - rumeur
+Suivant toujours l'exemple, on constate que seulement 2 nations ont une valeur différente de 0 (3 pour la 4ème et 1 pour la 13ème). En suivant les correspondances ci-dessus, on voit alors que la nation 4 est témoin de cette action alors que la nation 13 est celle du héros qui l'a initiée.
+====== Structure de contrôle : if ======
+Le test principal permettant d'adapter le texte de magazine à une condition particulière est le //if//. A utiliser entre @...@ tel que :
+<WRAP center round box 60%>
+@if@mot-clé@condition@\\
+instructions\\
+@endif@
+</WRAP>
+Il est possible d'utiliser des boucles imbriquées en indexant chaque boucle :
+<WRAP center round box 60%>
+@if1@mot-clé@condition@\\
+instructions si la condition de if1 est satisfaite\\
+@if2@mot-clé@condition@\\
+instructions si les conditions de if1 et if2 sont satisfaites\\
+@endif2@\\
+@endif1@
+</WRAP>
+===== Les conditions particulières =====
+On peut tester si le paramètre suivant le //if// existe ainsi :
+<WRAP center round box 60%>
+@if@paramètre-testé@exists@
+blabla
+@endif@
+</WRAP>
+Puisque le //else// n'est pas (encore?) implémenté, on a aussi le test réciproque pour savoir si le paramètre est vide :
+<WRAP center round box 60%>
+@if@paramètre_testé@empty@
+blabla
+@endif@
+</WRAP>
 ====== Mots-clés ======
@@ Ligne 7: / Ligne 71: @@
   * player : numéro de nation du joueur ([[troisieme_age_-_1650|module 1650]] : de 1 à 25)
   * player_as__nation_name : nation of the player
+  * aera_name
+  * previous_area_name
   * hero_nation : nation of the hero, from 1 to 25
   * hero_nation_name : nation of the hero
@@ Ligne 32: / Ligne 98: @@
   * hex_terrain : current hexagon terrain type from 1 to 9
   * previous_hex_terrain : last turn hexagon terrain type from 1 to 9
-  * is_mine : returns yes, if reader is owner of hero/town, otherwise returns no
-  * is_allied : returns yes, if reader considers hero/town to be a friend, otherwise returns no
-  * is_enemy : returns yes, if reader considers hero/town to be an enemy, otherwise returns no
   * is_hero_general : returns yes, if the hero generating the news is general of the army, otherwise returns no (meaning he would be a captain in the army)
-  * is_target_me : returns yes, if the action is targeted at the reader, otherwise returns no
   * army_general_name : returns the name of the hero leading the army
   * fellowship_leader_name : returns the name of the hero leading the fellowship
@@ Ligne 50: / Ligne 112: @@
   * parameter1_as_nation_bonus : returns the nation bonus based on the parameter value
-Lists
+les mots clés liés à la visibilité
-Nation
+  * is_mine : returns yes, if reader is owner of hero/town, otherwise returns no
+  * is_allied : returns yes, if reader considers hero/town to be a friend, otherwise returns no
+  * is_enemy : returns yes, if reader considers hero/town to be an enemy, otherwise returns no
+  * is_target_me : returns yes, if the action is targeted at the reader, otherwise returns no
+  * is_witness : pour les témoins de l'action (visibilité à 5 ou 6)
+Pour les ordres les plus complexes (avec beaucoup d'entrées), il existe le mot-clé #long_parameter#. Pour un ordre de division d'armée, on aurait la possibilités de rendre compte du transfert des différentes troupes par ces instructions :
+<WRAP center round box 60%>
+~#long_parameter-1# Cavaliers Lourds, ~#long_parameter-2# Cavaliers Légers, ~#long_parameter-3# Fantassins lourds, ~#long_parameter-4# Fantassins légers, ~#long_parameter-5# archers,<br>~#long_parameter-6# Mercenaires~
+</WRAP>
+ici, le ~ permet de supprimer le type de troupe si aucune unité n'est présente.
+===== Listes =====
+==== Nation ====
 : Woodmen, 2: Northmen, 3: Eothraim, 4: Arthedain, 5: Cardolan, 6: North Gondor, 7: South Gondor, 8: Dwarves, 9: Sinda Elves, 10: Noldo Elves, 11: Witch King, 12: Dragon Lord, 13: Dog Lord, 14: Cloud Lord, 15: Blind Sorcerer, 16: Ice King, 17: Quiet Avenger, 18: Fire King, 19: Long Rider, 20: Dark Lieutenants, 21: Corsairs, 22: Dunlendings, 23: Haradwaith, 24: Rhudaur, 25: Easterlings,
-Status
+==== Statuts ====
 general: Leading an army, hero: Hero alone, captain: Following an army, leader: Leading a fellowship, fellow: Following a fellowship, leech: Spying, hostage: Held hostage, dismissed: Has been dismissed,
-Terrain
+==== Terrain ====
 : Plain, 2: Coast, 3: Forest, 4: Marsh, 5: Hill, 6: Mountain, 7: Desert, 8: Coastal sea, 9: Open sea,
-Resource
+=== Resource ===
 : Leather, 2: Bronze, 3: Steel, 4: Mithril, 5: Food, 6: Timber, 7: Stone, 8: Mounts, 9: Gold,
-Wagon
+==== Wagon ====
-: none, 2: bronze weapons, 3: steel weapons, 4: mithril weapons, 5: leather armors, 6: bronze armors, 7: steel armors, 8: mithril armors, 9: food rations, 10: war machines,
-====== Visibilité ======
+: none, 2: bronze weapons, 3: steel weapons, 4: mithril weapons, 5: leather armors, 6: bronze armors, 7: steel armors, 8: mithril armors, 9: food rations, 10: war machines,
-  - auteur
-  - cible ou allié
-  - témoin
-  - allié du témoin
-  - témoin indirect, infos limitées
-  - allié du témoin indirect
-  - rumeur