Difference between revisions of "ARCC Guide FR"

From Ryzom Forge Wiki

Jump to: navigation, search
m ({weCDatas_short_description})
 
(48 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{tabLang|FR|DE|EN|ES|{{FULLPAGENAME}}|RU}}
+
{{Migrated to|:fr:ARK, guide}}
 +
{{tabLang|FR|ARCC Guide DE|ARCC Guide EN|ARCC Guide ES|ARCC Guide FR|ARCC Guide RU}}
 +
{{toTrad|FR|À revérifier par rapport à la [[ARCC Guide EN| version anglaise]] maintenue à jour}}
 
{{WIP}}
 
{{WIP}}
{{toTrad}}
+
 
 
<big>Manuel d’utilisation de l' '''A.R.C.C.'''</big>
 
<big>Manuel d’utilisation de l' '''A.R.C.C.'''</big>
*[[ARCC intro|Volume I : Guide de démarrage rapide (Quick Start Guide)]]
+
*[[ARCC intro FR|Volume I : Guide de démarrage rapide (Quick Start Guide)]]
*[[ARCC Guide|Volume II : Guide d'utilisation]]
+
*[[ARCC Guide FR|Volume II : Guide d'utilisation]]
*[[ARCC Expert|Volume III: Guide d'utilisation avancée]]
+
*[[ARCC Expert FR|Volume III: Guide d'utilisation avancée]]
 +
 
 +
{{Banner|ff0|Remarque importante|[[File:WarningRyzom.png|left|]] Pour avancer la documentation et permettre une rapide traduction, j'essaie d'écrire le plus possible tout ce que j'ai compris et testé.
 +
 
 +
'''Ce qui n'est pas clair et validé est surligné en jaune'''.
 +
 
 +
* * * *
 +
 
 +
Les images sont de deux types pour simplifier le portage interlinguistique:
 +
 
 +
Les images IG sont aléatoirement choisies dans n’importe laquelle des 5 langues de Ryzom.
 +
 
 +
Les images des scripts sont toujours (sauf oubli) en anglais.
 +
}}
 +
 
 +
{{Banner|ff0|Remarque importante|[[File:WarningRyzom.png|left|]] Cette page est en réalité la fusion de plusieurs pages.
 +
 
 +
À l'exception de paragraphe 2.1,
  
 +
'''tous les paragraphes de niveau 2, sont éditables et visualisables en cliquant sur la flèche (→) derrière le titre des fonctions'''.
 +
}}
 
==Les fonctions de script==
 
==Les fonctions de script==
 
Ce guide a pour but d’indiquer comment se servir des fonctions de script de l’A.R.C.C., l’Advanced Ryzom Content Creator.
 
Ce guide a pour but d’indiquer comment se servir des fonctions de script de l’A.R.C.C., l’Advanced Ryzom Content Creator.
Line 94: Line 115:
  
 
==Actions without player intervention==
 
==Actions without player intervention==
===End of script===
+
===End of script [[End of script ARCC FR|]]===
{|
+
{{:ARCC End of script}}
|[[File:End.png|32px|Home]]
 
|Nom interne de la fonction : ''' ''weAEnd_v3'' '''
 
|}
 
Il est « sage » de terminer les scripts systématiquement par un « End of Script ».
 
Le « End of script » peut être judicieusement utilisé pour avorter un script. En fin de script il permet d'avoir une sortie unique accédée par des branchements conditionnels comme {weAJump_short_description}.
 
<div style="overflow: hidden">
 
[[File:WeAEnd.png|200px|thumb|left|function name]]
 
Cette fonction n'a qu'un seul paramètre : le nom.
 
Le nom de toutes les fonctions est toujours initialisé par un code unique, mais il peut être modifié pour faciliter l'écriture et la relecture du script, par exemple et surtout lorsque la fonction peut être appelée par une autre, notamment les sauts et les branchements. (ici la fonction a été renommée : « Terminator »).
 
</div>
 
  
==={weAJump_short_description}===
+
===Jump [[Jump ARCC FR |]]===
{|
+
{{: Jump ARCC FR }}
|[[File:Arrow undo.png|32px|Home]]
 
|Nom interne de la fonction : ''' ''weAJump_v2'' '''
 
|}
 
Cette fonction permet d'interrompre l’enchaînement des étapes en le déroutant vers une autre fonction.
 
Cette fonction ne permet que de sauter en « avant ». Comme elle ne peut revenir en arrière,ll vaut mieux utiliser pour cela la fonction  weAWhile.
 
  
<div style="overflow: hidden">
+
===Include [[Include ARCC FR |]]===
[[File:WeAJump.png|200px|thumb|left|weAJump_V2]]
+
{{: Include ARCC FR }}
Le seul paramètre à fournir, est la fonction qui sera exécutée ensuite.
 
</div>
 
  
==={weAInclude_short_description}===
+
===While  [[While ARCC FR |]]===
{|
+
{{: While ARCC FR }}
|[[File: Arrow down.png|32px]]
 
|Nom interne de la fonction : ''' ''weAInclude'' '''
 
|}
 
Cette fonction permet de faire appel à un autre script de l'event.
 
  
<div style="overflow: hidden">
+
===Gestion des fenêtres webig  [[Window ARCC FR |]]===
[[File: WeAInclude.png|200px|thumb|left| WeAInclude ]]
+
{{: Window ARCC FR }}
*'''1)''' <span style="color:#f00">'''[expert]'''</span> réinitialisation du script lancé (Oui/Non)
 
*'''2)''' Nom du script à lancer.
 
</div>
 
  
==={weAWhile_short_description}===
+
===Display message in game (broadcast, crafting information...) [[DisplayIgMessage ARCC FR |]]===
{|
+
{{: DisplayIgMessage ARCC FR }}
|[[File: Arrow turn left.png|32px]]
 
|Nom interne de la fonction : ''' ''weAWhile'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
  
===Gestion des fenêtres webig ===
+
===ShapeManager [[ShapeManager ARCC FR |]]===
{|
+
{{: ShapeManager ARCC FR }}
|[[File: Application xp.png|32px]]
 
|Nom interne de la fonction : ''' ''weAWindow_v3'' '''
 
|}
 
Cette fonction permet de gérer les fenêtres de dialogues ( ouverture/fermeture, taille et position)
 
<div style="overflow: hidden">
 
[[File: WeAWindow.png|200px|thumb|left| WeAWindow IG ]]
 
[[File: WeAWindow window.png|200px|thumb|left| WeAWindow ARCC ]]
 
*'''1)''' Action à effectuer : (Activer/Fermer). Utilisé pour ouvrir une nouvelle fenêtre ou fermer une existante (voir point plus bas).
 
*'''2)''' Redimensionner : (Oui/Non), si oui, utiliser les valeurs données dans ''W'''(3)''' '' et ''H'''(4)''' ''.
 
*'''3)''' W : Largeur en pixel ''(ici 400)''
 
*'''4)''' H : Hauteur en pixels ''(ici 300)''
 
*'''5)''' Déplacer : (Oui/Non), si oui, utiliser les valeurs données dans ''X'''(6)''' '' et ''Y'''(7)''' ''. Ces valeurs sont en pourcentage par rapport aux dimensions de la fenêtre Ryzom.
 
*'''6)''' X en %: Position relative en X, 100 % cadre à droite ''(Comme ici)''.
 
*'''7)''' Y en %: Position relative en Y, 100 % cadre en haut. ''(Ici, 50 % positionne à mi-hauteur)''
 
*'''8)''' <span style="color:#f00">'''[expert]'''</span> Fenêtre Webig. Par défaut « Current » en mode basic. Ce paramètre permet de choisir qu'elle fenêtre IG controlée.
 
:→ BBCode :Permet de définir le nom de la fenêtre IG à utiliser
 
:→$_GET[« current_window »] :Le nom de la fenetre est donnée par l'url et le parametre current_window
 
:→Webig :Est la fenêtre qui s'ouvre quand on fait <ctrl>+w. C'est celle qui affiche les web apps
 
:→Browse Npc :Est la fenêtre qui s'ouvre quand on parle à un PNJ. Donc, c'est celle qui s'ouvre quand on lie un script à un PNJ.
 
:→Web Transaction :C'est une fenêtre cachée qui reçoit les réponses du serveur. Le joueur ne devrait jamais la voir.
 
</div>
 
  
===Display message in game (broadcast, crafting information...)===
+
===Save value in the database [[Database ARCC FR |]]===
{|
+
{{: Database ARCC FR }}
|[[File: Page red.png|32px]]
 
|Nom interne de la fonction : ''' ''weADisplayIgMessage'' '''
 
|}
 
<div style="overflow: hidden">
 
[[File: WeADisplayIgMessage IG.png|200px|thumb|left| WeADisplayIgMessage IG ]]
 
Cette fonction permet d'afficher des messages dans les canaux de discussions '''(2)'''.
 
  
Il faut noter que l'utilisation de la [[ARCC traduction|traduction]] permet d'avoir le texte dans la langue du joueur. Le texte en anglais étant : « We call it Voight-Kampff for short. » (''Blade Runner'').
+
===Save items given by the player in the event database [[ItemsDatabase ARCC FR |→]]===
</div>
+
{{: ItemsDatabase ARCC FR }}
<div style="overflow: hidden">
 
[[File: WeADisplayIgMessage.png|200px|thumb|left| WeADisplayIgMessagewindow ]]
 
Le tableau suivant donne la liste les caractéristiques des choix de canaux offerts par la fonction '''(4)'''.
 
</div>
 
{| class="wikitable centre"
 
!scope="col"| Mode
 
!scope="col"| où
 
!scope="col"| couleur
 
!scope="col"| canal
 
!scope="col"| SYS. INFOS
 
|-
 
!scope="row"| Default message system
 
|
 
|blanc
 
|
 
|Oui
 
|-
 
!scope="row"| Only in arround channel
 
|
 
|jaune
 
|alentours
 
|Non
 
|-
 
!scope="row"| Ambiance
 
|haut
 
|jaune
 
|
 
|Oui (3)
 
|-
 
!scope="row"| Task
 
|bas
 
|blanc
 
|
 
|Oui
 
|-
 
!scope="row"| Broadcast messages
 
|haut
 
|blanc
 
|alentours
 
|Oui
 
|-
 
!scope="row"| Title
 
|bas
 
|jaune
 
|
 
|Oui (1)
 
|-
 
!scope="row"| Taged broadcast messages...
 
|haut
 
|blanc
 
|alentours
 
|Oui
 
|-
 
!scope="row"| XP gain
 
|bas
 
|jaune
 
|
 
|Oui (1)
 
|-
 
!scope="row"| SP gain
 
|bas
 
|jaune
 
|
 
|Oui (1)
 
|-
 
!scope="row"| Zone
 
|haut
 
|blanc
 
|
 
|Oui
 
|-
 
!scope="row"| Damage to me
 
|
 
|rouge
 
|
 
|Oui (2)
 
|-
 
!scope="row"| Damage to me
 
|
 
|rouge
 
|
 
|Oui (2)
 
|-
 
!scope="row"| Damage to me from player
 
|
 
|rouge foncé
 
|
 
|Oui
 
|-
 
!scope="row"| Damage from me
 
|
 
|orange
 
|
 
|Oui
 
|-
 
!scope="row"| The opponent misses
 
|
 
|gris
 
|
 
|Oui (4)
 
|-
 
!scope="row"| I miss
 
|
 
|blanc
 
|
 
|Oui
 
|-
 
!scope="row"| Item
 
|bas
 
|vert
 
|
 
|Oui
 
|-
 
!scope="row"| Item other in group
 
|bas
 
|gris
 
|
 
|
 
|-
 
!scope="row"| Item failed
 
|bas
 
|magenta
 
|
 
|Oui
 
|-
 
!scope="row"| Spell to me
 
|
 
|bleu
 
|
 
|Oui
 
|-
 
!scope="row"| Spell from me
 
|
 
|bleu clair
 
|
 
|Oui
 
|-
 
!scope="row"| Emote
 
|
 
|rose
 
|
 
|Oui
 
|-
 
!scope="row"| Message of the day
 
|bas
 
|jaune
 
|
 
|Oui (1)
 
|-
 
!scope="row"| Forage Locate Deposit
 
|bas
 
|vert
 
|
 
|
 
|-
 
!scope="row"| False
 
|haut
 
|orange
 
|
 
|Oui
 
|-
 
!scope="row"| False in battle
 
|haut
 
|jaune
 
|
 
|Oui (3)
 
|-
 
!scope="row"| PVP timer
 
|bas
 
|orange
 
|
 
|
 
|-
 
!scope="row"| Thema finished
 
|bas
 
|jaune
 
|
 
|Oui (1)
 
|-
 
!scope="row"| Item special effec
 
|
 
|cyan-gris
 
|
 
|Oui (4)
 
|-
 
!scope="row"| Item special effect with center text
 
|haut
 
|cyan-gris
 
|
 
|Oui
 
|-
 
!scope="row"| Outpost state message
 
|haut
 
|bleu clair
 
|
 
|Oui
 
|-
 
!scope="row"| Ring invitation
 
|
 
|vert
 
|alentour
 
|
 
|}
 
  
==={weAShapeManager_short_description}===
+
===Player received item [[ReceiveItems ARCC FR |]]===
Nom de la fonction : weAShapeManager_v2
+
{{: ReceiveItems ARCC FR }}
WIP
 
{|
 
|[[File: Shape handles.png|32px]]
 
|Nom interne de la fonction : ''' ''weAShapeManager_v2'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
  
WIP
+
=== DeleteItems [[DeleteItems ARCC FR |→]]===
MC »  SpawnBags
+
{{: DeleteItems ARCC FR }}
  
===Save value in the database===
+
===NpcManager [[NpcManager ARCC FR |]]===
{|
+
{{: NpcManager ARCC FR }}
|[[File: Database add value.png|32px]]
 
|Nom interne de la fonction : ''' ''weADatabase_v2'' '''
 
|}
 
Cette fonction sert à stocker une information dans une base locale réexplotable parla suite dans le même script ou dans un autre du même event. Elle peut aussi incrémenter les valeurs numériques.
 
  
Il est préférable d'utiliser le mode d'édition assisté dans un premier temps, comme visualisé ici.
+
===Send command to server [[Hmagic ARCC FR |]]===
<div style="overflow: hidden">
+
{{: Hmagic ARCC FR }}
[[File: WeADatabase.png|200px|thumb|left| WeADatabase window ]]
 
*'''1)'''  Database name : une base de l'event (omega dans l'exemple).
 
*'''2)''' {databaseRow} : une colonne de la base(1) (Khi, dans l'exemple)
 
{{WIP}}
 
*'''3)''' {databaseId} :
 
<div style="margin:0em; padding:0em;border: none;background:yellow;">
 
**player,... : signification ?
 
**[get]bag[/get] signification, fonctionnement ?
 
</div>
 
*'''4)''' Conversion method : (setvalue/addvalue) : il y a deux mode d'insertion dans la base, soit en écrasant le contenu antérieur, soit en ajoutant au sens algébrique du terme une autre valeur.
 
*'''5)''' {param} : peut être différente valeurs statiques, récupérée ailleurs ou calculée :
 
**Le champ vide en mode « setvalue » met à « vide » la cellule de la base consernée. Dans un calcul, le « vide » peut-être assimilé à « zéro ».
 
**Une constante : « -1 » en mode « addvalue » permet de créer une décrémentation.
 
<div style="margin:0em; padding:0em;border: none;background:yellow;">
 
**Un paramètre commun à l'event : [param]Max_player_bag[/param] (comment a été créé ce paramètre?)
 
</div>
 
**Une valeur contenue dans une base : [db=Player_Bag]Last[/db]
 
**Une fonction : [func]now[/func]
 
**Un calcul :
 
<div style="margin:0em; padding:1em 2em;border: thin inset #{{ColorAtys|type=dark|group=HRP}};background:#{{ColorAtys|type=light|group=HRP}};color:#{{ColorAtys|type=fg|group=HRP}};">
 
<poem>
 
[func=min]
 
  [math]
 
    ([func]now[/func]
 
    -
 
    [db=Bags]
 
      Status:[get]bag[/get]
 
    [/db])
 
  [/math]
 
..|12
 
[/func]
 
</poem></div>
 
:<empty>
 
:[db=Player_Bag]Last[/db]
 
:[param]Max_player_bag[/param]
 
</div>
 
 
 
===Save items given by the player in the event database===
 
{|
 
|[[File: Database_add_item.png|32px]]
 
|Nom interne de la fonction : ''' ''weAItemsDatabase'' '''
 
|}
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
Obsolète ??
 
</div>
 
 
 
===Player received item===
 
{|
 
|[[File: Basket add.png|32px]]
 
|Nom interne de la fonction : ''' ''weAReceiveItems'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
 
 
=== {weADeleteItems_short_description}===
 
{|
 
|[[File: Basket delete.png|32px]]
 
|Nom interne de la fonction : ''' ''weADeleteItems'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
 
 
==={weANpcManager_short_description}===
 
{|
 
|[[File: Group link.png|32px]]
 
|Nom interne de la fonction : ''' ''weANpcManager'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
 
 
===Send command to server===
 
{|
 
|[[File: Wand.png|32px]]
 
|Nom interne de la fonction : ''' ''Wand'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
  
 
==Checks==
 
==Checks==
==={weCSwitch_short_description}===
+
===Datas [[Datas ARCC FR |]]===
{|
+
{{: Datas ARCC FR }}
|[[File: Arrow switch.png|32px]]
 
|Nom interne de la fonction : ''' ''weCSwitch_v2'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
  
MC »  StartMission
+
===Switch [[Switch ARCC FR |→]]===
MC »  SpawnBags
+
{{: Switch ARCC FR }}
  
===Verification of value in database===
+
===Verification of value in database [[Check Database ARCC FR |]]===
Nom de la fonction : weCDatabase
+
{{: Check Database ARCC FR }}
WIP
 
{|
 
|[[File: Database check.png|32px]]
 
|Nom interne de la fonction : ''' ''WIP'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
  
===Player verification check from server (Fames, Dapper, Position...)===
+
===Player verification check from server (Fames, Dapper, Position...) [[Check PlayerInfos ARCC FR |]]===
Nom de la fonction : weCPlayerInfos
+
{{: Check PlayerInfos ARCC FR }}
WIP
 
{|
 
|[[File:Vcard.png|32px]]
 
|Nom interne de la fonction : ''' ''WIP'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
 
 
==={weCDatas_short_description}===
 
Nom de la fonction : weCDatas
 
WIP
 
{|
 
|[[File: Tick.png|32px]]
 
|Nom interne de la fonction : ''' ''WIP'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
  
 
==Captures information==
 
==Captures information==
5.1- Captures information on the player
+
===Captures information on the player [[PlayerInfos ARCC FR |]]===
Nom de la fonction : weGPlayerInfos
+
{{: PlayerInfos ARCC FR }}
WIP
 
{|
 
|[[File: WIP.png|32px]]
 
|Nom interne de la fonction : ''' ''WIP'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
  
 
==Steps to be validated by player==
 
==Steps to be validated by player==
==={weSNewGiveItems_short_description}===
+
===NewGiveItems [[NewGiveItems ARCC FR |]]===
Nom de la fonction : weSNewGiveItems
+
{{: NewGiveItems ARCC FR }}
WIP
 
{|
 
|[[File: WIP.png|32px]]
 
|Nom interne de la fonction : ''' ''WIP'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
  
===NPC dialog bubble option (like classic missions)===
+
===NPC dialog bubble option (like classic missions) [[NpcDialog ARCC FR |]]===
Nom de la fonction : weSNpcDialog_v2
+
{{: NpcDialog ARCC FR }}
WIP
 
{|
 
|[[File: WIP.png|32px]]
 
|Nom interne de la fonction : ''' ''WIP'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
  
MC »  StartMission
+
===The player must wait X seconds for validation (automated validation possible) [[Timer ARCC FR |]]===
===The player must wait X seconds for validation (automated validation possible)===
+
{{: Timer ARCC FR }}
Nom de la fonction : weSTimer
 
WIP
 
{|
 
|[[File: WIP.png|32px]]
 
|Nom interne de la fonction : ''' ''WIP'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
  
MC »  StartMission
+
===Mission [[Mission ARCC FR |]]===
MC »  AddBoost
+
{{: Mission ARCC FR }}
==={weSMission_short_description}===
 
WIP
 
{|
 
|[[File: WIP.png|32px]]
 
|Nom interne de la fonction : ''' ''WIP'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
  
Nom de la fonction : weSMission
+
===Itemshop [[Itemshop ARCC FR |]]===
MC »  SpawnBags
+
{{: Itemshop ARCC FR }}
==={weSItemshop_short_description}===
 
Nom de la fonction : weSItemshop
 
WIP
 
{|
 
|[[File: WIP.png|32px]]
 
|Nom interne de la fonction : ''' ''WIP'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
 
 
==Exécuter le script==
 
WIP
 
{|
 
|[[File: WIP.png|32px]]
 
|Nom interne de la fonction : ''' ''WIP'' '''
 
|}
 
WIP
 
<div style="overflow: hidden">
 
[[File: WIP.png|200px|thumb|left| WIP ]]
 
*'''1)''' WIP
 
*'''2)''' WIP
 
</div>
 
 
 
Visualiser et éditer le script en langage humain ou machine.
 
 
 
Visualiser et éditer les droits d’accès et exécution.
 
 
 
Affiche qui utilise le script
 
 
 
Destruction du script.
 
  
 +
{{In_Category|ARCC}}
 
{{TPInWikiRyzom‎}}
 
{{TPInWikiRyzom‎}}
 
 
[[Category:Tutorials]]  
 
[[Category:Tutorials]]  
 
[[Category:ARCC]]
 
[[Category:ARCC]]
 
[[Category:FR]]
 
[[Category:FR]]

Latest revision as of 09:23, 14 June 2018

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK, guide at 2018-06-14

Flag-FR

À revérifier par rapport à la version anglaise maintenue à jour

WIP
in Arbeit - work in progress - trabajo en curso - travaux en cours - незавершенное


Manuel d’utilisation de l' A.R.C.C.


Remarque importante

WarningRyzom.png
Pour avancer la documentation et permettre une rapide traduction, j'essaie d'écrire le plus possible tout ce que j'ai compris et testé.

Ce qui n'est pas clair et validé est surligné en jaune.

  • * * *

Les images sont de deux types pour simplifier le portage interlinguistique:

Les images IG sont aléatoirement choisies dans n’importe laquelle des 5 langues de Ryzom.

Les images des scripts sont toujours (sauf oubli) en anglais.


Remarque importante

WarningRyzom.png
Cette page est en réalité la fusion de plusieurs pages.

À l'exception de paragraphe 2.1,

tous les paragraphes de niveau 2, sont éditables et visualisables en cliquant sur la flèche (→) derrière le titre des fonctions.

Contents

Les fonctions de script

Ce guide a pour but d’indiquer comment se servir des fonctions de script de l’A.R.C.C., l’Advanced Ryzom Content Creator. Il est recommandé d'avoir lu le volume I pour un usage global de l’A.R.C.C.. Les fonctions du script sont classées en cinq groupes.

  1. Visualizations
  2. Actions without player intervention
  3. Checks
  4. Captures information
  5. Steps to be validated by player

Visualizations

Ce groupe n'a qu'une seule fonction, l'une des plus simples et fréquentes.

Elle servira de référence en ce qui concerne zones et les boutons communs à toutes les fonctions détaillés dans des page distinctes pour faciliter la maintenances des documentations de l'ARRC.

  • Les objets communs seront signalés dans la documentation par [commun].
  • La marque [expert] correspondra au mode d'édition avancée (voir plus bas le point 10).
window title and function name
Home Ce mode d'édition est aussi signalé par une icone à côté de la fonction qui a été éditée dans ce mode.

Displaying a message

Home Nom interne de la fonction : weVMessage_v3
window title and function name

Cette fonction affiche un message dans une fenêtre de type WebIG, avec un titre de fenêtre (ici en haut : Unit_test : « May the Force be with you »)

weVMessage_v3
  • 1) [commun] Nom de la fonction.
  • 2) [expert] Afficher le message en permanence (Oui/Non)
  • 3) [expert] Le joueur devra cliquer sur un lien dans le message (Oui/Non)
  • 4) Champ texte pour le message.
Text field
  • 5) [commun] onglet d'agrandissement de la zone (4)
  • 6) [commun] bouton de bascule d'éditeur. (mode assisté ou non)
  • 7) [expert] Le format:
  • bbcode (recommandé ; un aide-mémoire du bbcode ryzom est fourni dans un document dédié.)

Exemple :
[session=url_validated][scriptinfos]is_valid_url[/scriptinfos][/session]

  • html (spécifique, étudié plus tard, mais immédiatement testable sur le web)

Exemple :
<hr/>Hello!
<br/>oren pyr, Deles silam, Lordoy ad toll, Woha mik'ito
<hr>External link!
<img src="http://wiki.blender.org/skins/naiad/images/blender_logo.png"/><hr/>

  • lua (très spécifique ; étudié plus tard)

Exemple :
[lua]
function game:onMissionSelected(index)
disableModalWindow()
self:updateCurrMissionComboBox()
local missionWnd = getMissionWindow()
setOnDraw(missionWnd, "game:updateArccMissionCustomDesc()")
end
...
updateArccMissionCustomDesc_loop = 100
game:updateArccMissionCustomDesc(1)
[/lua]

  • 8) [commun] Nom interne de la fonction. Ce nom est utilisé notamment pour les sauts, boucles...
  • 9) [commun] bouton d'enregistrement des modifications.
  • 10) [commun] bascule du mode « Basic Edition » au mode « Advanced Edition ». Une fois en mode « Advanced Edition », il n'est plus possible de revenir au mode « Basic Edition ». La description des fonctions se fera toujours en mode « Advanced Edition ». Les spécificités sont indiqués par [expert]

Actions without player intervention

End of script

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/End of script at 2018-06-14


Home Nom interne de la fonction : lEnd_v4

Il est « sage » de terminer les scripts systématiquement par un « End of Script ». Le « End of script » peut être judicieusement utilisé pour avorter un script. En fin de script il permet d'avoir une sortie unique accédée par des branchements conditionnels comme {weAJump_short_description}.

function name

Cette fonction n'a qu'un seul paramètre : le nom. Le nom de toutes les fonctions est toujours initialisé par un code unique, mais il peut être modifié pour faciliter l'écriture et la relecture du script, par exemple et surtout lorsque la fonction peut être appelée par une autre, notamment les sauts et les branchements. (ici la fonction a été renommée : « Terminator »).


Jump

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/Jump at 2018-06-14

Flag-{{{1}}}

Translation requested, please.

Home Nom interne de la fonction : lJump_v4

Cette fonction permet d'interrompre l’enchaînement des étapes en le déroutant vers une autre fonction à l'intérieur du script. Elle ne permet que de sauter en « avant ». Pour revenir en arrière, il faut utiliser la fonction weAWhile .

weAJump_V2

Le seul paramètre à fournir, est la fonction qui sera exécutée ensuite.

Include

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/Include at 2018-06-14

Arrow down.png Nom interne de la fonction : lInclude_v4

Cette fonction permet de faire appel à un autre script de l'event puis de reprendre l'execution des étapes .

WeAInclude
  • 1) [expert] réinitialisation du script lancé (Oui/Non)
  • 2) Nom du script à lancer.

While

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/While at 2018-06-14


Bug.png Do not work

Arrow turn left.png Nom interne de la fonction : weAWhile

WIP

WIP
  • 1) WIP
  • 2) WIP


Gestion des fenêtres webig

Application xp.png Nom interne de la fonction : weAWindow_v3

Cette fonction permet de gérer les fenêtres de dialogues ( ouverture/fermeture, taille et position)

WeAWindow IG
WeAWindow ARCC
  • 1) Action à effectuer : (Activer/Fermer). Utilisé pour ouvrir une nouvelle fenêtre ou fermer une existante (voir point plus bas).
  • 2) Redimensionner : (Oui/Non), si oui, utiliser les valeurs données dans W(3) et H(4) .
  • 3) W : Largeur en pixel (ici 400)
  • 4) H : Hauteur en pixels (ici 300)
  • 5) Déplacer : (Oui/Non), si oui, utiliser les valeurs données dans X(6) et Y(7) . Ces valeurs sont en pourcentage par rapport aux dimensions de la fenêtre Ryzom.
  • 6) X en %: Position relative en X, 100 % cadre à droite (Comme ici).
  • 7) Y en %: Position relative en Y, 100 % cadre en haut. (Ici, 50 % positionne à mi-hauteur)
  • 8) [expert] Fenêtre Webig. Par défaut « Current » en mode basic. Ce paramètre permet de choisir qu'elle fenêtre IG controlée.
→ BBCode :Permet de définir le nom de la fenêtre IG à utiliser
→$_GET[« current_window »] :Le nom de la fenetre est donnée par l'url et le parametre current_window
→Webig :Est la fenêtre qui s'ouvre quand on fait <ctrl>+w. C'est celle qui affiche les web apps
→Browse Npc :Est la fenêtre qui s'ouvre quand on parle à un PNJ. Donc, c'est celle qui s'ouvre quand on lie un script à un PNJ.
→Web Transaction :C'est une fenêtre cachée qui reçoit les réponses du serveur. Le joueur ne devrait jamais la voir.

Display message in game (broadcast, crafting information...)

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/DisplayIgMessage at 2018-06-14


Page red.png Nom interne de la fonction : weADisplayIgMessage
WeADisplayIgMessage IG

Cette fonction permet d'afficher des messages dans les canaux de discussions (2).

Il faut noter que l'utilisation de la traduction permet d'avoir le texte dans la langue du joueur. Le texte en anglais étant : « We call it Voight-Kampff for short. » (Blade Runner).

WeADisplayIgMessagewindow

Le tableau suivant donne la liste les caractéristiques des choix de canaux offerts par la fonction (4).

Mode couleur canal SYS. INFOS
Default message system blanc Oui
Only in arround channel jaune alentours Non
Ambiance haut jaune Oui (3)
Task bas blanc Oui
Broadcast messages haut blanc alentours Oui
Title bas jaune Oui (1)
Taged broadcast messages... haut blanc alentours Oui
XP gain bas jaune Oui (1)
SP gain bas jaune Oui (1)
Zone haut blanc Oui
Damage to me rouge Oui (2)
Damage to me rouge Oui (2)
Damage to me from player rouge foncé Oui
Damage from me orange Oui
The opponent misses gris Oui (4)
I miss blanc Oui
Item bas vert Oui
Item other in group bas gris
Item failed bas magenta Oui
Spell to me bleu Oui
Spell from me bleu clair Oui
Emote rose Oui
Message of the day bas jaune Oui (1)
Forage Locate Deposit bas vert
False haut orange Oui
False in battle haut jaune Oui (3)
PVP timer bas orange
Thema finished bas jaune Oui (1)
Item special effec cyan-gris Oui (4)
Item special effect with center text haut cyan-gris Oui
Outpost state message haut bleu clair Oui
Ring invitation vert alentour

ShapeManager

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/ShapeManager at 2018-06-14

Shape handles.png Nom interne de la fonction : weAShapeManager_v2
WeAShapeManager IG

WeAShapeManager permet de poper des objets dans l'espace de Ryzom. Ici, un sac à dos magique apparaît en lévitation au dessus du personnage.

WeAShapeManager Main Window
  • 1) clear
  • 2) shapes: N'importe quelle quantité d'objet (litérallement: de formes) peut être ajouté. Leur description est donnée en bas:
  • 3) [commun] Nom interne de la fonction. Ce nom est utilisé notamment pour les sauts, boucles...
  • {shape}: <un_objet>.ps
  • {shapeName}: Nom donné à l'objet.
  • {shapeUrl}: ???
  • {texture}: ???
  • {posX}: Position x en position absolue dans la carte de Ryzom.
  • {posY}: Position y en position absolue dans la carte de Ryzom.
  • {posZ}: Position z en position absolue dans la carte de Ryzom.

Bug.png some strange problem with calculated position.

  • {posA}: Position A ?
  • {scale}: Échelle. Par défaut = 1.


Save value in the database

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/Database at 2018-06-14


Database add value.png Nom interne de la fonction : weADatabase_v2

Cette fonction sert à stocker une information dans une base locale exploitable par la suite dans le même script ou dans un autre du même event. Elle peut aussi incrémenter les valeurs numériques.

Il est préférable d'utiliser le mode d'édition assisté dans un premier temps, comme visualisé ici.

WeADatabase window
  • 1) Database name : une base de l'event (omega dans l'exemple).
  • 2) {databaseRow} : une colonne de la base(1) (Khi, dans l'exemple)
  • 3) {databaseId} :
  • player,... : signification ?
  • [get]bag[/get] signification, fonctionnement ?
  • 4) Conversion method : (setvalue/addvalue) : il y a deux mode d'insertion dans la base, soit en écrasant le contenu antérieur, soit en ajoutant au sens algébrique du terme une autre valeur.
  • 5) {param} : peut être différente valeurs statiques, récupérée ailleurs ou calculée :
    • Le champ vide en mode « setvalue » met à « vide » la cellule de la base consernée. Dans un calcul, le « vide » peut-être assimilé à « zéro ».
    • <empty> (rien)
    • Une constante : « -1 » en mode « addvalue » permet de créer une décrémentation.
  • Un paramètre commun à l'event : [param]Max_player_bag[/param] (comment a été créé ce paramètre?)
    • Une valeur contenue dans une base : [db=Player_Bag]Last[/db]
    • Une fonction : [func]now[/func]
    • Un calcul :

[func=min]
  [math]
    ([func]now[/func]
    -
    [db=Bags]
      Status:[get]bag[/get]
    [/db])
  [/math]
..|12
[/func]

Save items given by the player in the event database

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/ItemsDatabase at 2018-06-14

End.png Obsolète ??

Database add item.png Nom interne de la fonction : weAItemsDatabase
WIP


Player received item

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/ReceiveItems at 2018-06-14

Basket add.png Nom interne de la fonction : weAReceiveItems
WeAReceiveItems IG
WeAReceiveItems script window
  • 1) Objet ajouté (ici une la peluche a été mise dans le sac du joueur)
  • 2) Plusieurs objet peuvent être ajoutés. Il en faut au moins un.
  • 3) Emplacement où sera déposé l'objet: le sac, la maison, la hall de guilde, un animal (mektoub de monte ou de bât), voire un emplacement temporaire.
  • 4) Au hasard (Oui/Non) Par rapport à quoi
  • 5) Requiert une réponse. A tester. Par défaut "Oui"
  • 6) Il s'agit d'une commande magique (Oui/Non) ???
  • 7) [commun] Nom interne de la fonction.
  • 8) Paramètres créés par la fonction.
WIP
  • 9) Nom de l'item

Question: comment connait-on la liste exhaustive des items?

  • 10) Quatité
  • 11) Qualité
  • 12) Contenu du sac.

Comment s'en servir IG?

  • 13) Quantité Max
  • 14) Qualité Max
  • 15) Nom personnalisé de l'objet
  • 16) Description personnalisée de l'objet


DeleteItems

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/DeleteItems at 2018-06-14


Basket delete.png Nom interne de la fonction : weADeleteItems
WeADeleteItems script window
  • 1) Objet à enlever (ici une la peluche). La feuille de description de l'objet est identique à celle utilisée pour la réception de l'objet.
  • 2) Plusieurs objet peuvent être enlevés. Il en faut au moins un.
  • 3) Emplacement d'où sera retiré l'objet: le sac, la maison, la hall de guilde, un animal (mektoub de monte ou de bât), voire un emplacement temporaire.
  • 4) Au hasard (Oui/Non) Par rapport à quoi
  • 5) [commun] Nom interne de la fonction.
  • 6) Paramètres créés par la fonction.


NpcManager

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/NpcManager at 2018-06-14

Group link.png Nom interne de la fonction : weANpcManager

Gestion du PNJ.

weANpcManager window
  • 1) groupName ???
  • 2) Liste de hmagicActions pour le PNJ
  • 3)  [commun] Nom interne de la fonction. Ce nom est utilisé notamment pour les sauts, boucles...

weAGroupScript

Script.png
  • 1) Text

weASpawnBot

User add.png
  • 1) Sheet name
  • 2) Quantity
  • 3) dispersion
  • 4) orientation
  • 5) botName
  • 6) posX
  • 7) posY
  • 8) look

weADeSpawnBot

User delete.png
  • 1) immediatly

weAGroupScriptSay

User comment.png
  • 1) Text
  • 2) mode

weAGroupScriptEmote

Emotion smile.png
  • 1) emote

weAGroupScriptAiAction

Cog go.png
  • 1) aiAction


Send command to server

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/Hmagic at 2018-06-14

WIP
in Arbeit - work in progress - trabajo en curso - travaux en cours - незавершенное

Wand.png Nom interne de la fonction : Hmagic

Hmagic permet d'envoyer une commande au serveur.

WeHMagic Window
  • 1) Liste de hmagicActions
  • 2) Chaque hmagicActions est éditable.
  • 3) On peut ajouter derrière chacun ou globalement un nouvel hmagicActions
  • 4) Les hmagicActions peuvent être réordonnés.
  • 5) callAfterCheck (Oui/Non)
  • 6) valideAction: action qui sera réalisée si Hmagic est validé. Les choix sont les même que ceux proposé par la fonction Jump.
  • 7) failAction: action qui sera réalisée si Hmagic est invalidé. Les choix sont les même que ceux proposé par la fonction Jump.
  • 8) [commun] Nom interne de la fonction. Ce nom est utilisé notamment pour les sauts, boucles...

weASendUrl

But de cette fonction?

Link go.png
  • 1) isTarget: Oui/Non
  • 2) playerName: il peut s'agir de données récupérées dans les étapes antérieures ou stockées dans les DB de l'évent.
  • 3) appName: il peut s'agir de données récupérées dans les étapes antérieures ou stockées dans les DB de l'évent.
  • 4) appParams: il peut s'agir de données récupérées dans les étapes antérieures ou stockées dans les DB de l'évent.

weATeleport

Ne marche pas toujours?

Téléportage du joueur et éventuellement de sa monture.

Transmit.png
  • 1) x: coordonnées X
  • 2) y: coordonnées Y
  • 3) z: coordonnées Z. La valeur 0 indique que l'objet est posé sur le sol.
  • 4) t: délai en secondes pour lancer la téléportation.
  • 5) tpMektoub (Oui/Non): téléportage du Mektoub. Par défaut: Non
  • 6) forbidWhenPvpFlag (Oui/Non): Interdiction de téléporter avec le drapeau PVP positionné. Par défaut: Oui.

weATeleportToEntity

Ne marche pas?
Transmit go.png
  • 1) entity: Entity vers laquelle sera téléporté le joueur.
  • 2) tpMektoub (Oui/Non): téléportage du Mektoub. Par défaut: Non
  • 3) forbidWhenPvpFlag (Oui/Non): Interdiction de téléporter avec le drapeau PVP positionné. Par défaut: Oui.

weAManageMoney

Donner ou Prendre des Dappers

Money euro.png
  • 1) hmagicAction: (give/take)
  • 2) Dappers: Combien (nombre direct, fourni ou calculé).

weAChangeFame

Award star gold 2.png
  • 1) faction: parmi Fyros, Matis, Tryker, Zoraï, Kami et Karavan.
  • 2) hmagicAction: add/delete/set
  • 3) Quantité: Nombre direct, fourni ou calculé

weAChangeFactionPoints

Medal gold 3.png
  • 1) faction: parmi Fyros, Matis, Tryker, Zoraï, Kami et Karavan.
  • 2) hmagicAction: add/delete/set
  • 3) Quantité: Nombre direct, fourni ou calculé

weAManageGuildMoney

Money dollar.png
  • 1) hmagicAction: (give/take)
  • 2) Dappers: Combien (nombre direct, fourni ou calculé).

weAManageBuilding

Vendre / Rendre accessible un appartement de joueur ou de guilde

House3D.png
  • 1) hmagicAction: achat/vente d'appartement/hall de guilde.
  • 2) building: une longue liste d'immeuble disponible, mais sans références compréhensibles.

weATriggerPacs

Déclencher un évènement PACS (pour activer un ascenseur ou vortex)

JoystickIcon.png
  • 1) hmagicAction: (in/out)
  • 2) triggerId: déclencheur?!!

weASetOrganization

But de la fonction?

Définir la Tierce Faction du joueur

Vcard.png
  • 1) orgName: une seule valeur "maraudeur.

weAFixOldBuildings

But et fonctionnement de la fonction
Brick.png
  • 1) scopeAction: (Joueur/guilde)

Dans les fonction il faudra analyser:

Les Data Processors

  • processor bbcode
  • Timestamp
  • processor splitdata
  • processor splitparam
  • processor randint
  • Random number


Checks

Datas

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/Datas at 2018-06-14


Tick.png Nom interne de la fonction : weCDatas

Cette fonction est l'équivalent d'un si test VRAI alors A sinon B .

weCDatas window
  • 1) Valeur
  • 2) testFunction
  • 3) testValue
  • 4) valideAction
  • 5) failAction
  • 6)  [commun] Nom interne de la fonction. Ce nom est utilisé notamment pour les sauts, boucles...


Switch

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/Switch at 2018-06-14

Flag-{{{1}}}

Translation requested, please.

Arrow switch.png Nom interne de la fonction : weCSwitch_v2

Cette fonction permet de proposer 10 branchements conditionnels + 1 par défaut en fonction d'une valeur fournie en premier paramètre de comparaison.

WeCSwitch window
  • 1) Valeur à analyser fournie par les paramètres locaux ou la base de données.
  • 2) Type de test (==, !=, <, >, <=, >=)
  • 3) Valeur du test
  • 4) Action si le test est "Vrai". La dernière ligne donne l'action par défaut, c'est à dire quand tous les test précédent on donné "Faux".
  • 5) [commun] Nom interne de la fonction.


Verification of value in database

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/Check Database at 2018-06-14


Database check.png Nom interne de la fonction : weCDatabase

Cette fonction permet d'enchainer un action ou une autre selon une valeur contenue dans une pase de donnée de l'event.

WeCDatabase window
  • 1) Database name : une base de l'event (omega dans l'exemple).
  • 2) databaseRow : une colonne de la base(1) (omega, dans l'exemple)
  • 3) databaseId : (global, player, guild) : signification ?
  • 4) testFunction: (==, !=, <, >, <=, >=)
  • 5) testValue: Valeur du test
  • 6) valideAction: Action si le test est "Vrai".
  • 7) failAction: Action si le test est "Faux".
  • 8) [commun] Nom interne de la fonction.


Player verification check from server (Fames, Dapper, Position...)

Vcard.png Nom interne de la fonction : weCPlayerInfos

weCPlayerInfos permet de tester toutes les informations stockées sur le serveur concernant le joueur.

WeCPlayerInfos window
  • 1) checks: Liste des tests qui vont être exécuté dans cette étape ajouté par les icones "plus".
  • 2) valideAction: action si les test sont validés (tous à Vrai).
  • 3) failAction: action si au moins un test est invalidé (Statu Faux)
  • 4) resetScriptIfFailed: (Oui/Non) Réinitialisation du script en cas d'échec.
  • 5) openWindow: Fenêtre ouverte pour afficher les tests (Aucune, WebIG, PNJ au survol, Transaction Web).
  • 6) hiddenWindow (Oui/Non)
  • 7) [commun] Nom interne de la fonction.

weCPlayerFaction

Teste si le joueur appartient à la faction demandée.

Medal gold 1.png
  • 1) faction: faction à tester. Cette faction peut prendre l'une des valeurs suivantes:
  • neutre de civilisation, neutre de culte, neutre des deux à la fois;
  • fyros, matis, tryker, zoraï
  • kami, karavan
  • maraudeur, ranger, trytoniste


weCPlayerDappers

Teste si le joueur a une certaine quantité de dappers.

Money euro.png
  • 1) Quantity: quantité de dappers requise.

weCPlayerPosition

Examine la position du joueur. Si le joueur se trouve dans le rectangle délimité parles coordonnées min/max de x/y la valeur retournée est VRAI.

Map magnify.png
  • 1) min_x: cordonnée minimum en x en absolu par rapport à la carte d'Atys.
  • 2) min_y: cordonnée minimum en y en absolu par rapport à la carte d'Atys.
  • 3) max_x: cordonnée maximum en x en absolu par rapport à la carte d'Atys.
  • 4) max_y: cordonnée maximum en y en absolu par rapport à la carte d'Atys.

weCPlayerItem

Teste si une certaine quantité d'item d'une certain niveau est présent dans l'un des emplacements du joueur.

Package.png
  • 1) inventory: Emplacement où devrait se trouvé l'objet: le sac, la maison, la hall de guilde, un animal (mektoub de monte ou de bât), voire un emplacement temporaire.
  • 2) Nom du sheet: Question: comment connait-on la liste exhaustive des items???
  • 3) Qualité: la qualité requise de l'item
  • 4) minQuantity: sa quantité minimum.

weCPlayerTarget

Teste si la cible est celle souhaitée.

Arrow in.png
  • 1) type de cible: objet, PNJ, joueur, membre d'équipe, de guilde ou de ligue.
  • 2) Valeur: les trois premiers types demandent une précision du nom (nom du sheet, du PNJ ou du joueur)

weCPlayerFame

Teste la réputation dans les nations et factions standard.

Award star gold 1.png
  • 1) faction: les faction qui peuvent être testées sont:
  • fyros, matis, tryker, zoraï
  • kami, karavan

Les autres se déduisent de ces comparaisons.

  • 2) below_or_above: détermine si le test porte sur les valeurs inférieures ou supérieures du champ suivant donnée dans Valeur.
  • 3) Valeur: niveau de réputation requis, maximum ou minimum selon la comparaison choisie dans le champ précédent below_or_above.

weCPlayerGuild

Teste le grade du joueur dans sa guilde

Group.png
  • 1) rank: Chef, Officier supérieur, Officier, Membre.

weCPlayerGuildDappers

Teste si une quantité minimum de dappers est dans le trésor de la guilde.

Money dollar.png
  • 1) Quantity: quantité de dappers requise.

weCPlayerFreetrial

Test si le joueur est en version gratuite ou non.

Emotion tongue.png

no params


Captures information

Captures information on the player

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/PlayerInfos at 2018-06-14


Vcard.png Nom interne de la fonction : weGPlayerInfos

weGPlayerInfos permet de prendre toutes les informations stockées concernant la cible du joueur ou la position de ce dernier.

weGPlayerInfos window
  • 1) source de l'info (cible, position de la cible, position du joueur)
  • 2) [commun] Nom interne de la fonction. Ce nom est utilisé notamment pour les sauts, boucles...


Steps to be validated by player

NewGiveItems

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/NewGiveItems at 2018-06-14


Package go.png Nom interne de la fonction : weSNewGiveItems

weSNewGiveItems permet de donner des items de qui à qui?

WeSNewGiveItems main window
  • 1) Items demandés, au moins un.
  • 2) [commun] Nom interne de la fonction.

Description des items demandés.

WeSNewGiveItems item sub window
  • 1) Nom du sheet: Question: comment connait-on la liste exhaustive des items???
  • 2) Quantité: la quantité requise de l'item
  • 3) Qualité: la qualité requise de l'item
  • 4) quantity_max: la quantité maximum.
  • 5) quality_max: la qualité maximum.


NPC dialog bubble option (like classic missions)

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/NpcDialog at 2018-06-14

User comment.png Nom interne de la fonction : weSNpcDialog_v2

Cette fonction permet de créer une bulle de dialogue d'un PNJ.

WeSNpcDialog IG

Cette bulle es composée de deux parties.

  • La partie supérieure contient un texte d'introduction, qui peut être un long monologue.
  • La partie inférieure contient un ensemble de choix qui enchaîneront d'autres actions.
WIP
  • 1) À noter que cette fonction active un parametre: weSNpcDialog_v2_1rpqpga2:SELECTED qui retourne le numéro du choix de l'utilisateur.
  • 2) {npcRowId} ?
  • 3) Ce champ contient la parie supérieur de la bulle. Le texte peut être relativement long.
  • 4) Cette zone contient 8 choix disponibles pour les joueurs.
  • 5) Chaque option peut conduire à une action spécifique.
  • 5.1) La colonne de droite donne le libellé de la question tel que le joueur la verra éventuellement dans sa langue si on utilise la traduction. Si le champ est vide, il n'y a pas d'option affichée dans la bulle.
WIP
  • 5.2) La colonne de gauche affiche les actions découlant des choix des joueurs.
Les actions sont divisées en:
  • 5.2.1) none
  • 5.2.2) resume or finish de script
  • 5.2.3) open or finish the URL
  • 5.2.4) jump to a stage (seulement après l'étape courante, comme la fonction Jump
  • 5.2.5) run script
  • 5.2.6) include script (même fonction que Include
  • 6) {luaCheck}?

←ARCC Guide FR


The player must wait X seconds for validation (automated validation possible)

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/Timer at 2018-06-14

Time.png Nom interne de la fonction : weSTimer
Timer IG

Cette fonction déclenche un compte à rebours visualisé en haut de la scène IG par le remplissage de la flèche.

Timer Window
  • 1) Durée du compte à rebours en secondes
  • 2) Annuler l'action si le joueur se déplace: (Oui/Non)
  • 3) [commun] Nom interne de la fonction. Ce nom est utilisé notamment pour les sauts, boucles...


Mission

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/Mission at 2018-06-14


Note go.png Nom interne de la fonction : weSMission
Mission IG

Cette fonction permet de créer des missions comme ici. Le PNJ qui annonce l'action "Replicant Kitin Eradicator", a donné la mission "Eradication mission" qui consiste à "You have to kill goo-kitins , now!".

La fonction mission ne permet d'activer qu'une seule mission à la fois.

Mission main window
  • 1) Selection d'une mission.
  • 2) Icône, nom et description de la mission.
  • 3) Compte ???
  • 4)  [commun] Nom interne de la fonction. Ce nom est utilisé notamment pour les sauts, boucles...

weAMissionGeneric

Note.png
  • 1) target
  • 2) title
  • 3) Description
  • 4) obj

weAMissionLoot

Basket put.png
  • 1) target
  • 2) tool
  • 3) no_tool_message
  • 4) title
  • 5) Description
  • 6) obj

weAMissionTalkTo

Comment.png
  • 1) target
  • 2) actionText
  • 3) title
  • 4) Description
  • 5) obj

weAMissionKillFauna

Bomb.png
  • 1) target
  • 2) title
  • 3) Description
  • 4) obj

weAMissionKillNpc

Bomb.png
  • 1) target
  • 2) title
  • 3) Description
  • 4) obj

weAMissionRemove

Note delete.png
  • 1) mission


Itemshop

Migration

Please use the migrated document at URL shown below.

Migrated to fr:ARK/Itemshop at 2018-06-14

Cart put.png Nom interne de la fonction : weSItemshop

Achat d'item? comment le PNJ a ces items?

La fonction Itemshop ne permet d'acheter qu'une seule type d'item à la fois.

WeSItemshopScript main window
  • 1) Selection d'un type d'item.
  • 2) Icône, nom et description de l'item.
  • 3) prix de l'item
  • 4) timer: ???
  • 5) (money/pvp_points) payé en dappers ou en points de faction???
  • 6) stockage en DB de l'item acheté?
  • 7) action suivante si l'item à bien été acheté???
  • 8) fenêtre ouvert pour afficher les tests (Aucune, WebIG, PNJ au survol, Transaction Web).
  • 9) [commun] Nom interne de la fonction.

weItems

Description technique de l'item

Ruby.png
  • 1) Nom du sheet: Question: comment connait-on la liste exhaustive des items???
  • 2) Quantité
  • 3) quantité max
  • 4) Qualité
  • 5) qualité max
  • 6) Nom personnalisé
  • 7) texte descriptif personnalisé

Items in bag: Il est possible d'afficher le contenu du sac, mais comment s'en servir IG?

weNamedItem

Nom de l'item. Pourquoi ne pas passer par la fonction traduction?

Ruby link.png
  • 1) phrase clef identifiant l'item
  • 2) Nom de l'item en FR
  • 3) Nom de l'item en EN
  • 4) Nom de l'item en DE
  • 5) Nom de l'item en RU
  • 6) Nom de l'item en ES

weVirtualItem

Un virtual item, c'est quoi?

Ruby gear.png
  • 1) virtualItem
  • 2) Icon
  • 3) itemName
  • 4) Quantity


63 pages in ARCC

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