Difference between revisions of "Script guidelines"

From Ryzom Forge Wiki

Jump to: navigation, search
(Created page with "<noinclude>{{tabLang|FR|script_guidelines DE|script_guidelines EN|script_guidelines ES|script_guidelines|script_guidelines RU}} {{toTrad|DE}} {{toTrad|EN}} {{toTrad|ES}} {{toT...")
 
(liens locaux)
Line 6: Line 6:
 
</noinclude>
 
</noinclude>
 
{{K_Big| Document de référence pour l'organisation de scripts }}
 
{{K_Big| Document de référence pour l'organisation de scripts }}
Règles et informations utiles pour la [https://khaganat.net/wikhan/rcprimitivemissiondoc création de missions].
+
Règles et informations utiles pour la [[Documentation_sur_les_missions |création de missions]].
  
 
== Éléments de scripts pour les missions ==
 
== Éléments de scripts pour les missions ==
Line 14: Line 14:
 
Les '''variables''' sont utilisées quand un script utilise plusieurs occurrences d'un même élément. Ce qui aide beaucoup quand on veut modifier la valeur de cet élément sans avoir à en retrouver toutes les occurrences dans le script.
 
Les '''variables''' sont utilisées quand un script utilise plusieurs occurrences d'un même élément. Ce qui aide beaucoup quand on veut modifier la valeur de cet élément sans avoir à en retrouver toutes les occurrences dans le script.
  
Les variables sont [https://khaganat.net/wikhan/primitivemissiondocvar_creature var_creature], [https://khaganat.net/wikhan/primitivemissiondocvar_faction var_faction], [https://khaganat.net/wikhan/primitivemissiondocvar_group var_group], [https://khaganat.net/wikhan/primitivemissiondocvar_item var_item], [https://khaganat.net/wikhan/primitivemissiondocvar_npc var_npc], [https://khaganat.net/wikhan/primitivemissiondocvar_place var_place], [https://khaganat.net/wikhan/primitivemissiondocvar_quality var_quality], [https://khaganat.net/wikhan/primitivemissiondocvar_quantity var_quantity] et [https://khaganat.net/wikhan/primitivemissiondocvar_text |var_text].
+
Les variables sont [[var_creature]], [[var_faction]], [[var_group]], [[var_item]], [[var_npc]], [[var_place]], [[var_quality]], [[var_quantity]] et [[var_text]].
  
Les '''étapes''' sont les éléments fondamentaux d'un script de mission qui contient en général un objectif et une liste d'actions à exécuter avant et après l'atteinte de l'objectif. Les étapes sont [https://khaganat.net/wikhan/primitivemissiondocstep step], [https://khaganat.net/wikhan/primitivemissiondocstep_any step_any], [https://khaganat.net/wikhan/primitivemissiondocstep_dyn_chat step_dyn_chat], [https://khaganat.net/wikhan/primitivemissiondocstep_failure step_failure], [https://khaganat.net/wikhan/primitivemissiondocstep_if step_if] et [https://khaganat.net/wikhan/primitivemissiondocstep_ooo step_ooo].
+
Les '''étapes''' sont les éléments fondamentaux d'un script de mission qui contient en général un objectif et une liste d'actions à exécuter avant et après l'atteinte de l'objectif. Les étapes sont [[step]], [[step_any]], [[step_dyn_chat]], [[step_failure]], [[step_if]] et [[step_ooo]].
  
 
Les '''actions''' sont des éléments qui sont exécutés ponctuellement, sans apport du joueur. Ils fixent généralement les conditions, ou modifient les variables du jeu comme la quantité d'argent que le joueur a, ou son inventaire, ou ils ont un effet sur l'exécution du script.
 
Les '''actions''' sont des éléments qui sont exécutés ponctuellement, sans apport du joueur. Ils fixent généralement les conditions, ou modifient les variables du jeu comme la quantité d'argent que le joueur a, ou son inventaire, ou ils ont un effet sur l'exécution du script.
  
Les actions sont [https://khaganat.net/wikhan/primitivemissiondocadd_compass add_compass], [https://khaganat.net/wikhan/primitivemissiondocai_event ai_event], [https://khaganat.net/wikhan/primitivemissiondocbot_chat bot_chat], [https://khaganat.net/wikhan/primitivemissiondocfail fail], [https://khaganat.net/wikhan/primitivemissiondocjump_to jump_to], [https://khaganat.net/wikhan/primitivemissiondoclearn_action learn_action], [https://khaganat.net/wikhan/primitivemissiondocrecv_fame recv_fame], [https://khaganat.net/wikhan/primitivemissiondocrecv_item recv_item], [https://khaganat.net/wikhan/primitivemissiondocrecv_money recv_money], [https://khaganat.net/wikhan/primitivemissiondocset_constrains set_constrains], [https://khaganat.net/wikhan/primitivemissiondocsystem_msg system_msg] et [https://khaganat.net/wikhan/primitivemissiondocteleport teleport].
+
Les actions sont [[add_compass]], [[ai_event]], [[bot_chat]], [[fail]], [[jump_to]], [[learn_action]], [[recv_fame]], [[recv_item]], [[recv_money]], [[set_constrains]], [[system_msg]] et [[teleport]].
  
 
Les '''objectifs''' sont des éléments qui attendent que des conditions soient remplies par le joueur. Le script est bloqué jusqu'à que l'objectif soit, soit atteint, soit manqué, par rapport aux conditions de la mission.
 
Les '''objectifs''' sont des éléments qui attendent que des conditions soient remplies par le joueur. Le script est bloqué jusqu'à que l'objectif soit, soit atteint, soit manqué, par rapport aux conditions de la mission.
  
Les objectifs sont [https://khaganat.net/wikhan/primitivemissiondocbuy buy], [https://khaganat.net/wikhan/primitivemissiondoccast cast], [https://khaganat.net/wikhan/primitivemissiondoccraft craft], [https://khaganat.net/wikhan/primitivemissiondocdo_mission do_mission], [https://khaganat.net/wikhan/primitivemissiondocescort escort], [https://khaganat.net/wikhan/primitivemissiondocforage forage], [https://khaganat.net/wikhan/primitivemissiondocgive_item give_item], [https://khaganat.net/wikhan/primitivemissiondocgive_money give_money], [https://khaganat.net/wikhan/primitivemissiondockill kill], [https://khaganat.net/wikhan/primitivemissiondocloot loot], [https://khaganat.net/wikhan/primitivemissiondocsell sell], [https://khaganat.net/wikhan/primitivemissiondocskill skill], [https://khaganat.net/wikhan/primitivemissiondoctalk_to talk_to], [https://khaganat.net/wikhan/primitivemissiondoctarget target] et [https://khaganat.net/wikhan/primitivemissiondocvisit visit].
+
Les objectifs sont [[buy]], [[cast]], [[craft]], [[do_mission]], [[escort]], [[forage]], [[give_item]], [[give_money]], [[kill]], [[loot]], [[sell]], [[skill]], [[talk_to]], [[target]] et [[visit]].
  
  
Line 31: Line 31:
 
Une branche de script de mission se termine simplement avec une instruction end qui implique l'achèvement de la mission et montre une phrase de succès par défaut.
 
Une branche de script de mission se termine simplement avec une instruction end qui implique l'achèvement de la mission et montre une phrase de succès par défaut.
  
Il y a deux étapes spéciales qui produisent des branches de script : [https://khaganat.net/wikhan/primitivemissiondocstep_if step_if], et [https://khaganat.net/wikhan/primitivemissiondocstep_dyn_chat step_dyn_chat].
+
Il y a deux étapes spéciales qui produisent des branches de script : [[step_if]], et [[step_dyn_chat]].
  
 
En fonction des conditions, une branche est choisie pour l'exécution, et le script continue linéairement à partir de ce point.
 
En fonction des conditions, une branche est choisie pour l'exécution, et le script continue linéairement à partir de ce point.
  
A n'importe quel point, un  [https://khaganat.net/wikhan/primitivemissiondocjump_to jump_to] puet modifier l'exécution linéire du script et aller à n'importe quelle autre étape, sur la même branche, ou sur une autre.
+
A n'importe quel point, un  [[jump_to]] puet modifier l'exécution linéire du script et aller à n'importe quelle autre étape, sur la même branche, ou sur une autre.
  
L'échec est géré par l'étape [https://khaganat.net/wikhan/primitivemissiondocstep_failure step_failure] et l'action [https://khaganat.net/wikhan/primitivemissiondocfail fail] action.
+
L'échec est géré par l'étape [[step_failure]] et l'action [[fail]] action.
  
  

Revision as of 17:03, 15 January 2016

Flag-DE

Übersetzung , bitte.

Flag-EN

Translation requested, please.

Flag-ES

Traducción, por favor.

Flag-RU

перевод, пожалуйста.


Document de référence pour l'organisation de scripts

Règles et informations utiles pour la création de missions.

Éléments de scripts pour les missions

Le script de mission est basé sur une exécution linéaire d'étapes contenant des actions et objectifs.

Les variables sont utilisées quand un script utilise plusieurs occurrences d'un même élément. Ce qui aide beaucoup quand on veut modifier la valeur de cet élément sans avoir à en retrouver toutes les occurrences dans le script.

Les variables sont var_creature, var_faction, var_group, var_item, var_npc, var_place, var_quality, var_quantity et var_text.

Les étapes sont les éléments fondamentaux d'un script de mission qui contient en général un objectif et une liste d'actions à exécuter avant et après l'atteinte de l'objectif. Les étapes sont step, step_any, step_dyn_chat, step_failure, step_if et step_ooo.

Les actions sont des éléments qui sont exécutés ponctuellement, sans apport du joueur. Ils fixent généralement les conditions, ou modifient les variables du jeu comme la quantité d'argent que le joueur a, ou son inventaire, ou ils ont un effet sur l'exécution du script.

Les actions sont add_compass, ai_event, bot_chat, fail, jump_to, learn_action, recv_fame, recv_item, recv_money, set_constrains, system_msg et teleport.

Les objectifs sont des éléments qui attendent que des conditions soient remplies par le joueur. Le script est bloqué jusqu'à que l'objectif soit, soit atteint, soit manqué, par rapport aux conditions de la mission.

Les objectifs sont buy, cast, craft, do_mission, escort, forage, give_item, give_money, kill, loot, sell, skill, talk_to, target et visit.


Branches de mission

Une branche de script de mission se termine simplement avec une instruction end qui implique l'achèvement de la mission et montre une phrase de succès par défaut.

Il y a deux étapes spéciales qui produisent des branches de script : step_if, et step_dyn_chat.

En fonction des conditions, une branche est choisie pour l'exécution, et le script continue linéairement à partir de ce point.

A n'importe quel point, un jump_to puet modifier l'exécution linéire du script et aller à n'importe quelle autre étape, sur la même branche, ou sur une autre.

L'échec est géré par l'étape step_failure et l'action fail action.



←Khaganat

Ryzom Wiki: Ryzom Commons | DE • EN • ESFRRU | Ryzom Forge