From Ryzom Forge Wiki
(→Le script) |
|||
(28 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{Migrated to|:fr:ARK, présentation}} | ||
+ | {{tabLang|FR|ARCC_intro_DE|ARCC_intro_EN|ARCC_intro_ES|ARCC_intro_FR|ARCC_intro_RU}} | ||
+ | {{toTrad|FR|À revérifier par rapport à la [[ARCC_intro_EN| version anglaise]] maintenue à jour}} | ||
{{WIP}} | {{WIP}} | ||
− | + | {{Banner|ff0|Remarque importante|[[File:WarningRyzom.png|left|]] | |
− | + | '''Pour avancer la documentation et permettre une rapide traduction et maintenance, car ARK est en toujours en évolution, la référence est désormais en anglais et la partie française n'est momentanément plus suivie.'''}} | |
− | |||
+ | <big>Manuel d’utilisation de l' '''A.R.C.C.'''</big> | ||
+ | *[[ARCC intro FR|Volume I : Guide de démarrage rapide (Quick Start Guide)]] | ||
+ | *[[ARCC Guide FR|Volume II : Guide d'utilisation]] | ||
+ | *[[ARCC Expert FR|Volume III: Guide d'utilisation avancée]] | ||
==L’A.R.C.C.== | ==L’A.R.C.C.== | ||
Ce guide a pour but d’indiquer comment se servir de l’A.R.C.C., l’Advanced Ryzom Content Creator. | Ce guide a pour but d’indiquer comment se servir de l’A.R.C.C., l’Advanced Ryzom Content Creator. | ||
Line 72: | Line 78: | ||
===Utilitaires (Zone 3)=== | ===Utilitaires (Zone 3)=== | ||
La zone 3 a deux utilitaires : | La zone 3 a deux utilitaires : | ||
+ | ====Paramètres de l'event==== | ||
+ | {| | ||
+ | |[[File:Table edit.png |32px]] | ||
+ | |[[ARCC paramètres|Le paramétrage]] | ||
+ | |} | ||
+ | ====Traductions automatisées==== | ||
{| | {| | ||
− | |[[File: | + | |[[File:Langs.png |32px]] |
− | + | |[[ARCC traductions|Les traductions automatiques]] | |
− | |||
− | |[[ | ||
− | |||
|} | |} | ||
===Les scripts (Zone 4)=== | ===Les scripts (Zone 4)=== | ||
Line 221: | Line 230: | ||
[[File:DBfilling.png|200px|thumb|left|Script window]] | [[File:DBfilling.png|200px|thumb|left|Script window]] | ||
Lorsque cette fonction a été activée, la base de données affiche le contenu comme celui-ci. | Lorsque cette fonction a été activée, la base de données affiche le contenu comme celui-ci. | ||
+ | </div> | ||
*'''6)''' Une ligne de données (''n° 1'') a été créée. | *'''6)''' Une ligne de données (''n° 1'') a été créée. | ||
*'''7)''' Une valeur (''64'') a été attribuée à une colonne (''Psi). | *'''7)''' Une valeur (''64'') a été attribuée à une colonne (''Psi). | ||
− | |||
− | |||
− | |||
*'''8)''' | *'''8)''' | ||
{| | {| | ||
Line 231: | Line 238: | ||
|Une icône en bas indique que l'on peut modifier manuellement les données. | |Une icône en bas indique que l'on peut modifier manuellement les données. | ||
|} | |} | ||
− | + | ||
==L’exécution== | ==L’exécution== | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
Line 268: | Line 275: | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
− | [[File:ExecutionTop 1.png|200px|thumb|left| | + | [[File:ExecutionTop 1.png|200px|thumb|left|Top Left Creation Window]] |
</div> | </div> | ||
{| | {| | ||
Line 284: | Line 291: | ||
|} | |} | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
− | [[File: | + | [[File:pazapa.png|200px|thumb|left|Web]] |
+ | *'''17)''' À partir d'une exécution lancée sur le Web, il est possible | ||
+ | {| | ||
+ | |- | ||
+ | |[[File:Script_edit.png|32px]] | ||
+ | | soit d'éditer le script, | ||
+ | |- | ||
+ | |[[File:Arrow_refresh.png|32px]] | ||
+ | |soit de le relancer. | ||
+ | |} | ||
</div> | </div> | ||
+ | *'''18)''' Chaque étape est avancée manuellement | ||
{| | {| | ||
|- | |- | ||
− | |[[File: | + | |[[File:Resultset_next.png|32px|right]] |
− | | | + | |soit simplement, en cliquant sur l'icone d'avancement, |
|- | |- | ||
− | |[[File: | + | |[[File:pazapa_1.png|200px|right]] |
− | | | + | |soit en sélectionnant le choix proposé lorsqu'il y a branchement multiple. |
− | |||
− | |||
− | |||
|} | |} | ||
− | + | *'''19)''' Les colonnes de droite indiquent le statut de chaque fonction du script. | |
− | |||
− | |||
− | *''' | ||
− | |||
===Le Yubo=== | ===Le Yubo=== | ||
+ | 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). | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
− | [[File: | + | [[File:ExecutionTop 2.png|200px|thumb|left|Top Right Creation Window]] |
</div> | </div> | ||
+ | |||
+ | <div style="overflow: hidden"> | ||
+ | [[File:NPC assigned.png|200px|thumb|left|In Game]] | ||
+ | Ici, nous avons sélectionné un garde en poste. | ||
+ | Il affiche son mode d’interaction dans un cartouche : (« ATTAQUER » en français). | ||
{| | {| | ||
− | |[[File: | + | |- |
− | | | + | |[[File:User go.png|32px]] |
+ | |On lui assigne le script courant (ici, Unit_Test) en cliquant sur l'icone '''(3)'''. | ||
|} | |} | ||
− | + | Le résultat de cette assignation n'est pas visible instantanément, même s'il elle est déjà effective. Pour la rendre visible rapidement, il suffit d'aller cliquer sur un autre PNJ, et de revenir ensuite sur celui-ci. On doit voir le cartouche qui a changé (ici : « Live long and prosper »). | |
− | + | Le script peut être maintenant exécuté par le PNJ. | |
</div> | </div> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==Modification et suppression== | ==Modification et suppression== | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
− | [[File: | + | [[File:ExecutionTop 2.png|200px|thumb|left|Top Right Create window]] |
</div> | </div> | ||
{| | {| | ||
− | |[[File: | + | |[[File:Script_code.png|32px]] |
− | |... | + | |Nous avons déjà vu comment utiliser la vue du code source '''(5)''' dans le chapitre 4, lorsqu'il s'agissait de copier/coller le contenu d'un script dans un autre. |
+ | |- | ||
+ | |[[File:Time.png|32px]] | ||
+ | |Lorsque la modification est un échec, il est toujours possible de revenir à une version précédente en cliquant sur '''(6)'''. | ||
|} | |} | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
− | [[File: | + | [[File:Edition.png|200px|thumb|left|Script window]] |
+ | La manière la plus standard pour éditer un script reste en cliquant sur le titre du script (ici : « jumping »), | ||
</div> | </div> | ||
− | + | {| | |
− | + | |[[File:Add.png|32px]] | |
− | + | |puis en ajoutant, | |
+ | |- | ||
+ | |[[File:Delete.png|32px]] | ||
+ | | en retranchant, | ||
+ | |- | ||
+ | |[[File:Arrow down.png|32px]] | ||
+ | |en déplaçant les fonctions, | ||
+ | |- | ||
+ | |[[File:Arrow up.png|32px]] | ||
+ | |et évidement, en modifiant le contenu des fonctions elles-même (ici : « weVMessage_v3_True ») ce qui sera l'objet du volume II. | ||
+ | |} | ||
+ | |||
+ | |||
+ | <div style="overflow: hidden"> | ||
+ | [[File:IsDeadJim.png|200px|thumb|left|Function part of script window]] | ||
Remarque : l'icône d'effacement d'une fonction se trouve à droite de la fonction. L'effacement est instantané, sans fenêtre d'avertissement ou de confirmation. Mais rassurez-vous ! Vous avez l'historique qui vous permet de revenir en arrière. | Remarque : l'icône d'effacement d'une fonction se trouve à droite de la fonction. L'effacement est instantané, sans fenêtre d'avertissement ou de confirmation. Mais rassurez-vous ! Vous avez l'historique qui vous permet de revenir en arrière. | ||
− | |||
− | |||
</div> | </div> | ||
==Autres outils de l'Event== | ==Autres outils de l'Event== | ||
− | + | ===Le statut=== | |
− | |||
− | |||
{| | {| | ||
− | |[[File: | + | |[[File:Bullet red.png |32px]] |
− | |... | + | |Édition |
+ | |- | ||
+ | |[[File:Bullet orange.png |32px]] | ||
+ | |En test | ||
+ | |- | ||
+ | |[[File:Bullet green.png |32px]] | ||
+ | |Actif sur Atys et Yubo | ||
+ | |- | ||
+ | |[[File:Bullet blue.png |32px]] | ||
+ | |Opérationnel et verrouillé | ||
+ | |- | ||
+ | |[[File:Bullet black.png |32px]] | ||
+ | |Désactivé (à effacer) | ||
+ | |} | ||
+ | ===Les droits et raccourcis associés=== | ||
+ | {| | ||
+ | |[[File:Control play.png |32px]] | ||
+ | |Exécuter le script | ||
+ | |- | ||
+ | |[[File:Script code.png |32px]] | ||
+ | |Visualiser et éditer le script en langage humain ou machine. | ||
+ | |- | ||
+ | |[[File:Key.png |32px]] | ||
+ | |Visualiser et éditer les droits d’accès et exécution. | ||
+ | |- | ||
+ | |[[File:Status online.png |32px]] | ||
+ | |Affiche qui utilise le script | ||
+ | |- | ||
+ | |[[File:Basket put.png |32px]] | ||
+ | |Demande de destruction du script. | ||
+ | |- | ||
+ | |[[File:Delete.png |32px]] | ||
+ | |Destruction du script. | ||
|} | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | {{In_Category|ARCC}} | |
+ | {{TPInWikiRyzom}} | ||
+ | [[Category:Tutorials]] | ||
+ | [[Category:ARCC]] | ||
+ | [[Category:FR]] |
Latest revision as of 15:50, 7 June 2018
Migration
Please use the migrated document at URL shown below.
WIP
in Arbeit -
work in progress -
trabajo en curso -
travaux en cours -
незавершенное
Remarque importante
Manuel d’utilisation de l' A.R.C.C.
- Volume I : Guide de démarrage rapide (Quick Start Guide)
- Volume II : Guide d'utilisation
- Volume III: Guide d'utilisation avancée
Contents
L’A.R.C.C.
Ce guide a pour but d’indiquer comment se servir de l’A.R.C.C., l’Advanced Ryzom Content Creator. L’A.R.C.C. 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
Dossiers et events
Ouverture
Dès la connexion, l’utilisateur se trouve sur une page offrant l’accès aux différents éléments de l’ARCC.
- La zone 1 permet de naviguer dans cette profondeur.
- La zone 2 permet de créer un nouveau dossier ou un nouvel event.
- 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 second champ est une liste de choix :
- La valeur par défaut est Folder (Dossier).
- Le second choix, en déroulant la liste, est Event.
- Le troisième et dernier champ, add, est en fait un bouton. Cliquer dessus lance la création de l’objet. À noter que la touche <Entrée> est équivalente au bouton add.
- La zone 3 contient les objets, dossiers ou events, créés dans le dossier affiché dans la zone 1 (ici « maison »).
L'event
La zone 1 affiche l’emplacement de l’event dans l’arborescence des dossiers. Chaque lien cliquable permet de remonter dans le dossier désiré.
Le champ de création (Zone 2)
La zone 2 permet de créer un nouveau script ou une nouvelle base de données.
- 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 second champ est une liste de choix :
- La valeur par défaut est Script.
- Le second choix, en déroulant la liste, est Database.
- Le troisième et dernier champ, add, est en fait un bouton. Cliquer dessus lance la création de l’objet. À noter que la touche <Entrée> est équivalente au bouton add.
Utilitaires (Zone 3)
La zone 3 a deux utilitaires :
Paramètres de l'event
Le paramétrage |
Traductions automatisées
Les traductions automatiques |
Les scripts (Zone 4)
La zone 4 contient les scripts créés dans l'event affiché dans la zone 1 (ici « New Event »).
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 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:
Un script simple | |
un script lié, c'est-à-dire, attribué à un PNJ |
- Le statut du script représenté par une petite pastille colorée dont la signification est indiquée dans la partie inférieure de la fenêtre.
- Le nom du script. Cliquer sur le nom du script permet d’en visualiser et modifier le contenu selon les droits de l’utilisateur.
- Le nom de l’auteur de la création du script.
- Les actions possibles sur les scripts.
Les base de données (Zone 5)
La zone 5 affiche la liste des bases de données de l’event . |
Le script
- La zone 1 affiche l’emplacement de l’event dans l’arborescence des dossiers jusqu’à l’event qui contient les scripts en cours.
Chaque lien cliquable permet de remonter dans le dossier désiré.
- La zone 2 permet de tester script.
- La zone 3 permet de gérer le code source et l’historique des modifications.
- La zone 4 affiche des informations complémentaires pour l’exécution 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'ARCC.
Remplir le nouveau script.
On rejoue les séquences 6 à 8 avec « Script1 »
- 6) ouverture du script
- 7) affichage du source
- 8) affichage du source en Base64
À 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 :
Les bases de données
- Player
- Global
- Civ
- Cult
- Organization (Faction)
- Other
- 3) Number of Rows :Nombre de données ??? (colonnes???)
- 4) Le contenu (vide à la création).
- 6) Une ligne de données (n° 1) a été créée.
- 7) Une valeur (64) a été attribuée à une colonne (Psi).
- 8)
Une icône en bas indique que l'on peut modifier manuellement les données. |
L’exécution
Les paramètres d'exécution
- 9) Hide during launch : Masquer au lancement (Oui/Non)
- 10) Require validation : Nécessite une validation (Oui/Non)
- 11) {singleInstance} (Oui/Non)
- 12) {resetAtStart} (Oui/Non)
- 13) {updateStagesInDb} (Oui/non)
- 14) {missionTimeout} (Unités)
- 15) {replayTimer} (Unités)
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.
Le pas à pas
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 : |
- 18) Chaque étape est avancée manuellement
soit simplement, en cliquant sur l'icone d'avancement, | |
soit en sélectionnant le choix proposé lorsqu'il y a branchement multiple. |
- 19) Les colonnes de droite indiquent le statut de chaque fonction du script.
Le Yubo
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).
Modification et suppression
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. |
Autres outils de l'Event
Le statut
Édition | |
En test | |
Actif sur Atys et Yubo | |
Opérationnel et verrouillé | |
Désactivé (à effacer) |
Les droits et raccourcis associés
63 pages in ARCC