(→Les scripts (Zone 3)) |
|||
(39 révisions intermédiaires par 3 utilisateurs non affichées) | |||
Ligne 6 : | Ligne 6 : | ||
|RU= | |RU= | ||
}} | }} | ||
− | {{ | + | {{WIP}} |
<big>Guide de l'utilisateur pour Ark, abréviation de Ryzom Arkitect.</big> | <big>Guide de l'utilisateur pour Ark, abréviation de Ryzom Arkitect.</big> | ||
− | ''Pour | + | {{Tape |
− | *[[ARK, présentation|Volume I : Guide de démarrage rapide | + | |3D=out |
− | *[[ARK, guide|Volume II : Guide d'utilisation]] | + | |palette=Alert |
− | *[[ARK, expert|Volume III: Guide d'utilisation avancée]] | + | |text=<big><big><big>'''Remarque de traduction: toutes les images sont des copies d'écran. Pour éviter de surcharger les données du Common, ces images sont faites de manière quasi aléatoire dans l'une des 5 langues du Wiki Ryzom.'''</big></big></big> |
+ | }} | ||
+ | |||
+ | *[[ARK, présentation|Volume I : Guide de démarrage rapide]] | ||
+ | *[[ARK, guide|Volume II : Guide d'utilisation]] - [[ARK, guide/Archives|Archives du Guide d'utilisation]] | ||
+ | *[[ARK, expert|Volume III: Guide d'utilisation avancée]] - [[ARK, expert/Archives|Archives de III: avancée]] | ||
==L’ARK== | ==L’ARK== | ||
+ | '''ARK''' se lance à partir d'un navigateur (https://app.ryzom.com/app_arcc/) , éventuellement directement dans le jeu pour ceux qui sont autorisés. | ||
+ | |||
Ce guide a pour but d’indiquer comment se servir de l’ARK, le Ryzom Arkitect. | Ce guide a pour but d’indiquer comment se servir de l’ARK, le Ryzom Arkitect. | ||
L’ARK est un outil permettant de créer des scripts qui seront interprétés par un serveur web et qui pourront interagir avec le serveur de Ryzom | L’ARK est un outil permettant de créer des scripts qui seront interprétés par un serveur web et qui pourront interagir avec le serveur de Ryzom | ||
== Accès== | == Accès== | ||
+ | ===Login=== | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
− | [[File: | + | [[File:LoginARK.jpg|200px|thumb|left|Login ARK]] |
En haut, à gauche, des drapeaux permettent de choisir la langue de l’interface (ici, dans la vue, le français). | En haut, à gauche, des drapeaux permettent de choisir la langue de l’interface (ici, dans la vue, le français). | ||
Cette fenêtre de connexion est identique partout dans Ryzom. | Cette fenêtre de connexion est identique partout dans Ryzom. | ||
− | Il faut renseigner le premier champ avec son nom de PJ. Attention, pour les | + | Il faut renseigner le premier champ avec son nom de PJ. Attention, pour les animateurs, c’est le nom de l’animateur et non le nom des personnages qu’il aurait pu créer dans le jeu (il a droit à 5 PJ dans le jeu, comme tous les joueurs). |
+ | </div> | ||
+ | ===Fenêtre d'accueil=== | ||
+ | <div style="overflow: hidden"> | ||
+ | [[File:IndexARK.jpg|200px|thumb|left|Accueil ARK]] | ||
+ | La fenêtre présente un ensemble de zones d'activités qui seront détaillées par la suite. | ||
+ | </div> | ||
+ | ==Les dossiers== | ||
+ | ===Mes events=== | ||
+ | <div style="overflow: hidden"> | ||
+ | [[File:MyEventsARK.jpg|200px|thumb|left|My Events]] | ||
+ | |||
+ | L’ARK présente des ensembles de scripts, d'events et de dossiers rassemblés dans des dossiers. Dans l'exemple affiché ici, on peut voir que '''Mes events''' contient un sous dossier dans la première ligne nommé {* MY SPACE *} | ||
+ | </div> | ||
+ | |||
+ | ===Mon espace=== | ||
+ | <div style="overflow: hidden"> | ||
+ | [[File:MySpaceARK.jpg|200px|thumb|left|MySpaceARK]] | ||
+ | |||
+ | '''Mon espace''' est un endroit où l'on peut stocker ses propres créations et ouitls. | ||
</div> | </div> | ||
− | == | + | |
+ | ===Tous les éléments=== | ||
+ | <div style="overflow: hidden"> | ||
+ | [[File:AllInARK.jpg|200px|thumb|left|All in ARK]] | ||
+ | |||
+ | Les deux dossiers précédents sont particulièrement utiles pour s'y retrouver aisément dans '''Tous les éléments''' développés par la communauté. | ||
+ | </div> | ||
+ | |||
+ | ===Les autres dossiers=== | ||
+ | Les autres dossiers catégorisent plus finement les scripts/events/dossiers en fonction de leur emploi. Ce sont: | ||
+ | ;À lancer après le reboot: Sripts à relancer obligatoirement après un reboot | ||
+ | ;Script admin: Spécifique admin système | ||
+ | ;Events actifs: scripts utilisés ou utilisables | ||
+ | ;Ryzhome: | ||
+ | ;Patchlet: | ||
+ | ;Encyclopédie: L'encyclopédie interne du jeu | ||
+ | ;Titres: | ||
+ | ;Boutiques: | ||
+ | ;Tags: | ||
===Ouverture=== | ===Ouverture=== | ||
− | |||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
− | [[File: | + | [[File:1st_Page.png|200px|thumb|left|1st page window]] |
− | + | L’ARK se présente comme un ensemble d’events rassemblés dans des dossiers, nommé en haut à gauche de leur fenêtre respective. | |
− | Chaque dossier peut contenir des events ou | + | Chaque dossier peut contenir des events, des scénarios, ou d'autres dossiers, ce qui peut donner une arborescence plus ou moins profonde. |
+ | Ces éléments s'ajoute dans le dossier à partir du bouton en haut à droite. Le champ qui le précède contiendra le nom de l'objet sélectionné dans le menu qui lui est accolé à gauche (dossier, event ou scénario). | ||
</div> | </div> | ||
− | + | Le contenu de chaque élément est détaillé dans des lignes, découpées en colonnes détaillées ci-après: | |
+ | ====Nom==== | ||
+ | Nom de l'élément appartenant au dossier. | ||
+ | |||
{| | {| | ||
− | |[[File: | + | !colspan="2"|Sur sa gauche les icônes de caractéristiques de l'objet. |
− | | | + | |- |
+ | |[[File:User suit.png|32px|User suit.png]] | ||
+ | |Personnel | ||
+ | |- | ||
+ | |[[File:event_on_yubo.png|32px|event_on_yubo.png]] | ||
+ | |Sur Yubo | ||
+ | |} | ||
+ | |||
+ | {| | ||
+ | !colspan="2"|Sur sa droite, les icônes d'action possibles. | ||
+ | |- | ||
+ | |[[File:add_edit_16.png|32px|add_edit_16.png]] | ||
+ | |Traduisible, par défaut avec Deepl | ||
+ | |} | ||
+ | |||
+ | ====Actions==== | ||
+ | {| | ||
+ | |[[File:tag_blue_edit.png|32px|tag_blue_edit.png]] | ||
+ | |Renommer | ||
+ | |- | ||
+ | |[[File:folder_go.png|32px|folder_go.png]] | ||
+ | |Déplacer | ||
|- | |- | ||
− | |[[File: | + | |[[File:key.png|32px|key.png]] |
− | | | + | |Mettre les droits |
|- | |- | ||
− | |[[File: | + | |[[File:delete.png|32px|delete.png]] |
− | | | + | |Supprimer |
|} | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | ====Propriétaire==== | |
+ | Propriétaire ou responsable du script | ||
+ | ====Auteurs==== | ||
+ | Ensemble des développeurs, scénaristes,... | ||
+ | ====Lecteurs==== | ||
+ | Lecteurs et testeurs | ||
+ | ====Rédacteurs==== | ||
+ | ? | ||
+ | ====Exécuteurs==== | ||
+ | Qui peut lancer le script | ||
− | === | + | ===Navigation=== |
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
− | [[File: | + | [[File:Navigation_1.png|200px|thumb|left|Navigation]] |
− | + | *Cliquer sur le nom de l'objet, permet de naviguer à l'intérieur de cet objet pour y voir ses éléments, dossier[[File:Folder.png|32px|tag_blue_edit.png]], script[[File:Script.png|32px|tag_blue_edit.png]]... | |
− | + | *Cliquer sur le chemin en en-tête de la fenêtre (ALL >> etc.) permet de remonter l'arborescence. </div> | |
− | </div> | ||
<div style="clear: both"></div> | <div style="clear: both"></div> | ||
+ | |||
==L'event== | ==L'event== | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
[[File:Event.png|200px|thumb|left|Event window]] | [[File:Event.png|200px|thumb|left|Event window]] | ||
La fenêtre de l'event permet de gérer les scripts et les bases de données internes à cet event. | La fenêtre de l'event permet de gérer les scripts et les bases de données internes à cet event. | ||
− | Elle est divisée en | + | Elle est divisée en trois zones verticales, et la dernière est divisée en sept colonnes. |
</div> | </div> | ||
− | ===La barre de navigation (Zone 1)=== | + | ===La barre de navigation et ajout déléments(Zone 1)=== |
− | + | À gauche, elle affiche l’emplacement de l'objet dans l’arborescence des dossiers/ensembles. | |
Chaque lien cliquable permet de remonter dans le dossier désiré. | Chaque lien cliquable permet de remonter dans le dossier désiré. | ||
− | + | ||
− | + | À droite, un ensemble de champs/boutons permet de créer un nouveau script, une nouvelle base de données, etc. | |
− | *Le premier champ contiendra le nom de l’objet, de préférence en anglais pour les données communes et de préférence sans caractères accentués ou spécifiques (â, ñ, ß...) | + | *Le premier champ est une liste de choix. La valeur par défaut est ''Script''. |
− | + | *Le second champ contiendra le nom de l’objet, de préférence en anglais pour les données communes et de préférence sans caractères accentués ou spécifiques (â, ñ, ß...) | |
− | + | *Le troisième est un bouton. Cliquer dessus lance la création de l’objet. À noter que la touche <Entrée> est équivalente au bouton ''add''. | |
− | + | ||
− | *Le troisième | + | ===Utilitaires (Zone 2)=== |
− | ===Utilitaires (Zone | ||
− | |||
====Paramètres de l'event==== | ====Paramètres de l'event==== | ||
{| | {| | ||
|[[File:Table edit.png |32px]] | |[[File:Table edit.png |32px]] | ||
− | |[[ | + | |[[ARK/Paramètres|Le paramétrage]] |
|} | |} | ||
+ | |||
====Traductions automatisées==== | ====Traductions automatisées==== | ||
{| | {| | ||
|[[File:Langs.png |32px]] | |[[File:Langs.png |32px]] | ||
− | |[[ | + | |[[ARK/Traductions-à_changer|Les traductions]] |
|} | |} | ||
− | |||
− | |||
− | + | ====Les base de données==== | |
− | + | {| | |
− | + | |[[File:Database.png|32px|Script]] | |
+ | |Liste des [[ARK/Bases de données|bases de données]] de l’event . | ||
+ | |} | ||
− | À chaque script est associé un ensemble d’indicateurs et d’actions | + | ===Les scripts (Zone 3)=== |
− | + | La zone est divisée en 7 colonnes. | |
+ | ====Nom==== | ||
+ | Cette colonne affiche le noms des commandes ARK utilisée dans le script . | ||
+ | À chaque script est associé un ensemble d’indicateurs et d’actions. | ||
+ | Listés ici dans l’ordre d’affichage de gauche à droite. | ||
+ | =====Le type de script===== | ||
{| | {| | ||
|[[File:Script.png|32px|Script]] | |[[File:Script.png|32px|Script]] | ||
Ligne 107 : | Ligne 183 : | ||
|un script lié, c'est-à-dire, attribué à un PNJ | |un script lié, c'est-à-dire, attribué à un PNJ | ||
|} | |} | ||
− | + | =====Le statut du script===== | |
+ | Il est représenté par une petite pastille colorée dont la signification est indiquée dans la partie inférieure de la fenêtre. | ||
{| | {| | ||
|[[File:Bullet_red.png|32px|Red]] | |[[File:Bullet_red.png|32px|Red]] | ||
|[[File:Bullet orange.png|32px|Orange]] | |[[File:Bullet orange.png|32px|Orange]] | ||
− | |[[File:Bullet green.png|32px|Green]] | + | |[[File:Bullet green.png|32px|Green]]<!-- |
− | |[[File:Bullet blue.png|32px|Blue]] | + | |[[File:Bullet blue.png|32px|Blue]]--> |
|[[File:Bullet black.png|32px|Black]] | |[[File:Bullet black.png|32px|Black]] | ||
|} | |} | ||
− | + | =====Le nom du script===== | |
+ | <div style="overflow: hidden">[[File:WeADeleteItems.png|200px|thumb|left|WeADeleteItems]] | ||
+ | Cliquer sur le nom du script permet , selon les droits de l’utilisateur, d’en visualiser et modifier le contenu avec l'outil de commande ARK décrit dans [[Volume II : Guide d'utilisation à réécrire]]. Par exemple, WeADeleteItems. </div> | ||
+ | |||
+ | ====Exécution==== | ||
+ | {{Incomplet}} | ||
+ | |||
+ | ====Édition==== | ||
+ | {| | ||
+ | |[[File:Script_code.png|32px|Script_code]] || code source | ||
+ | |- | ||
+ | |[[File:tag_blue_edit.png|32px|tag_blue_edit]] || renommer | ||
+ | |- | ||
+ | |[[File:arrow_right.png|32px|arrow_right]] || déplacer | ||
+ | |- | ||
+ | |[[File:arrow_branch.png|32px|arrow_branch]] || {clone} | ||
+ | |} | ||
+ | ====Visualisation==== | ||
+ | ====Auteur==== | ||
+ | ===={Vouchers}==== | ||
+ | ====Désactiver==== | ||
+ | |||
+ | |||
+ | La partie inférieure contient la signification des pastilles colorées qui sont accolées aux scripts. | ||
+ | |||
+ | La partie médiane contient la liste des scripts associés à l’event. | ||
+ | |||
*Le nom de l’auteur de la création du script. | *Le nom de l’auteur de la création du script. | ||
*Les actions possibles sur les scripts. | *Les actions possibles sur les scripts. | ||
{| | {| | ||
|[[File:Control_play.png|32px|Control_play]] | |[[File:Control_play.png|32px|Control_play]] | ||
− | |||
|[[File:Key.png|32px|Key]] | |[[File:Key.png|32px|Key]] | ||
|[[File:Status_online.png|32px|Status_online]] | |[[File:Status_online.png|32px|Status_online]] | ||
|[[File:Basket_put.png|32px|Basket_put]] | |[[File:Basket_put.png|32px|Basket_put]] | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
Ligne 144 : | Ligne 241 : | ||
*'''La zone 5''' gère la création proprement dite du script. | *'''La zone 5''' gère la création proprement dite du script. | ||
− | La méthode la plus rapide et la moins fatigante pour créer un script est de le copier à partir d’un autre qui ressemble à ce que l’on souhaite. Cette méthode est très pratique pour rapidement créer un script qui ressemble à un autre, mais il faudra apprendre à le modifier tôt ou tard... sinon à quoi serviraient deux scripts identiques au nom près ? Ce sera le volume II de ce manuel d'utilisation de l' | + | La méthode la plus rapide et la moins fatigante pour créer un script est de le copier à partir d’un autre qui ressemble à ce que l’on souhaite. Cette méthode est très pratique pour rapidement créer un script qui ressemble à un autre, mais il faudra apprendre à le modifier tôt ou tard... sinon à quoi serviraient deux scripts identiques au nom près ? Ce sera le volume II de ce manuel d'utilisation de l'ARK. |
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
[[File:Hackers 1.png|200px|thumb|left|Event window]] | [[File:Hackers 1.png|200px|thumb|left|Event window]] | ||
Ligne 195 : | Ligne 292 : | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
[[File:DBcreating.png|200px|thumb|left|Event window]] | [[File:DBcreating.png|200px|thumb|left|Event window]] | ||
− | Les bases de données de | + | Les bases de données de l’ARK servent à stocker des informations comme le nombre de MP d’un certain type récupéré par un certain joueur. Ce sont en quelque sorte des tableaux simples et dénués de fonctions et de relations complexes comme dans les tableurs ou les bases de données relationnelles. |
</div> | </div> | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> |
Guide de l'utilisateur pour Ark, abréviation de Ryzom Arkitect.
ARK se lance à partir d'un navigateur (https://app.ryzom.com/app_arcc/) , éventuellement directement dans le jeu pour ceux qui sont autorisés.
Ce guide a pour but d’indiquer comment se servir de l’ARK, le Ryzom Arkitect. L’ARK est un outil permettant de créer des scripts qui seront interprétés par un serveur web et qui pourront interagir avec le serveur de Ryzom
Les autres dossiers catégorisent plus finement les scripts/events/dossiers en fonction de leur emploi. Ce sont:
Le contenu de chaque élément est détaillé dans des lignes, découpées en colonnes détaillées ci-après:
Nom de l'élément appartenant au dossier.
Sur sa gauche les icônes de caractéristiques de l'objet. | |
---|---|
Personnel | |
Sur Yubo |
Sur sa droite, les icônes d'action possibles. | |
---|---|
Traduisible, par défaut avec Deepl |
Renommer | |
Déplacer | |
Mettre les droits | |
Supprimer |
Propriétaire ou responsable du script
Ensemble des développeurs, scénaristes,...
Lecteurs et testeurs
?
Qui peut lancer le script
À gauche, elle affiche l’emplacement de l'objet dans l’arborescence des dossiers/ensembles. Chaque lien cliquable permet de remonter dans le dossier désiré.
À droite, un ensemble de champs/boutons permet de créer un nouveau script, une nouvelle base de données, etc.
Le paramétrage |
Les traductions |
Liste des bases de données de l’event . |
La zone est divisée en 7 colonnes.
Cette colonne affiche le noms des commandes ARK utilisée dans le script . À chaque script est associé un ensemble d’indicateurs et d’actions. Listés ici dans l’ordre d’affichage de gauche à droite.
Un script simple | |
un script lié, c'est-à-dire, attribué à un PNJ |
Il est représenté par une petite pastille colorée dont la signification est indiquée dans la partie inférieure de la fenêtre.
code source | |
renommer | |
déplacer | |
{clone} |
La partie inférieure contient la signification des pastilles colorées qui sont accolées aux scripts.
La partie médiane contient la liste des scripts associés à l’event.
Chaque lien cliquable permet de remonter dans le dossier désiré.
La méthode la plus rapide et la moins fatigante pour créer un script est de le copier à partir d’un autre qui ressemble à ce que l’on souhaite. Cette méthode est très pratique pour rapidement créer un script qui ressemble à un autre, mais il faudra apprendre à le modifier tôt ou tard... sinon à quoi serviraient deux scripts identiques au nom près ? Ce sera le volume II de ce manuel d'utilisation de l'ARK.
Remplir le nouveau script.
On rejoue les séquences 6 à 8 avec « Script1 »
À ce niveau, cliquez dans le texte déjà présent (pour positionner le focus) et sélectionnez-le complètement (par exemple : en tapant <Ctrl>+A sur Windows et Unices) pour le remplacer par le texte mémorisé dans le presse-papier (par exemple, en tapant <Ctrl>+V). Quand le texte a été remplacé ; le sauvegarder :
Une icône en bas indique que l'on peut modifier manuellement les données. |
On peut commencer à tester le script dans le navigateur en cliquant sur (1) dans le navigateur. |
Cela permet de tester en grande partie le déroulement du script surtout en ce qui concerne les algorithmes et les affichages. Il faut néanmoins faire attention à l'affichage qui ne correspond pas nécessairement entre le Web et le WebIG. En effet, certaines balises html ne passent pas dans ce dernier. Par exemple, la balise <hr/> (horizontal rule) n'apparaît pas en WebIG, ou le <br/> (line break). C'est pourquoi, il est préférable d'utiliser le bbcode.
En conclusion, le lancement du script dans un navigateur ne doit pas servir pour vérifier la présentation des affichages.
Si un problème d'exécution apparaît, il peut être utile de tester le déroulement. Dans ce cas on clique sur (2). L'image suivante montre le résultat de l'exemple en cours : |
soit simplement, en cliquant sur l'icone d'avancement, | |
soit en sélectionnant le choix proposé lorsqu'il y a branchement multiple. |
Pour tester le script en grandeur nature, il faut le lancer sur le serveur de test au petit nom de « Yubo ». Il faut pour cela se connecter sur le « Yubo » avec un compte autorisé, choisir un PNJ de préférence statique (pour ne pas courir derrière pour les tests) et, évidement libre (donc ne pas réutiliser un PNJ de missions pour ne pas se compliquer la vie).
puis en ajoutant, | |
en retranchant, | |
en déplaçant les fonctions, | |
et évidement, en modifiant le contenu des fonctions elles-même (ici : « weVMessage_v3_True ») ce qui sera l'objet du volume II. |
Édition | |
En test | |
Actif sur Atys et Yubo | |
Opérationnel et verrouillé | |
Désactivé (à effacer) |