Difference between revisions of "ARCC Guide 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

DeutschEnglishEspañolFrançaisРусский219 FR pages.

À 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

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

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

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.

Visualizations
Actions without player intervention
Checks
Captures information
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

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

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

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

Translation requested, please.

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

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

Do not work

Nom interne de la fonction : weAWhile

WIP

1) WIP
2) WIP

Gestion des fenêtres webig →

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

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	où	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

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.

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

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

Obsolète ??

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

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

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

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

1) Text

weASpawnBot

1) Sheet name
2) Quantity
3) dispersion
4) orientation
5) botName
6) posX
7) posY
8) look

weADeSpawnBot

1) immediatly

weAGroupScriptSay

1) Text
2) mode

weAGroupScriptEmote

1) emote

weAGroupScriptAiAction

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 - незавершенное

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?

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.

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?

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

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

weAChangeFame

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

weAChangeFactionPoints

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

weAManageGuildMoney

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

weAManageBuilding

Vendre / Rendre accessible un appartement de joueur ou de guilde

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)

1) hmagicAction: (in/out)

2) triggerId: déclencheur?!!

weASetOrganization

But de la fonction?

Définir la Tierce Faction du joueur

1) orgName: une seule valeur "maraudeur.

weAFixOldBuildings

But et fonctionnement de la fonction

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

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

Translation requested, please.

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

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...) →

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.

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.

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.

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.

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.

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.

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

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

weCPlayerGuildDappers

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

1) Quantity: quantité de dappers requise.

weCPlayerFreetrial

Test si le joueur est en version gratuite ou non.

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

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

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

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

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

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

1) target
2) title
3) Description
4) obj

weAMissionLoot

1) target
2) tool
3) no_tool_message
4) title
5) Description
6) obj

weAMissionTalkTo

1) target
2) actionText
3) title
4) Description
5) obj

weAMissionKillFauna

1) target
2) title
3) Description
4) obj

weAMissionKillNpc

1) target
2) title
3) Description
4) obj

weAMissionRemove

1) mission

Itemshop →

Migration

Please use the migrated document at URL shown below.

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

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

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?

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?

1) virtualItem
2) Icon
3) itemName
4) Quantity

63 pages in ARCC

Ryzom Wiki: Ryzom Commons | DE • EN • ES • FR • RU | Ryzom Forge

@@ 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}}
-{{toTrad}}
 <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==
 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==
-===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:xxx.png|200px|thumb|left|xxx]]
+{{: Window ARCC FR }}
-*'''1)''' [expert] 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 |→]]===
-Nom de la fonction : weAWhile
+{{: DisplayIgMessage ARCC FR }}
+===ShapeManager [[ShapeManager ARCC FR |→]]===
+{{: ShapeManager ARCC FR }}
-WIP
+===Save value in the database [[Database ARCC FR |→]]===
+{{: Database ARCC FR }}
-===Gestion des fenêtres webig ===
+===Save items given by the player in the event database [[ItemsDatabase ARCC FR |→]]===
-Nom de la fonction : weAWindow_v3
+{{: ItemsDatabase ARCC FR }}
-Cette fonction permet de gérer les fenêtres de dialogues ( ouverture/fermeture, taille et position)
+===Player received item [[ReceiveItems ARCC FR |→]]===
-) Action à effectuer : (Activer/Fermer)
+{{: ReceiveItems ARCC FR }}
-Utilisé pour ouvrir une nouvelle fenêtre ou fermer une existante (voir point plus bas).
-) Redimensionner : (Oui/Non), si oui, utiliser les valeurs données dans W(3) et H(4).
-) W : Largeur en pixel (ici 400)
-) H : Hauteur en pixels (ici 300)
-) 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.
-) X en %: Position relative en X, 100 % cadre à droite (Comme ici).
-) Y en %: Position relative en Y, 100 % cadre en haut. (Ici, 50 % positionne à mi-hauteur)
-) [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.
+=== DeleteItems [[DeleteItems ARCC FR |→]]===
+{{: DeleteItems ARCC FR }}
-===Display message in game (broadcast, crafting information...)===
+===NpcManager [[NpcManager ARCC FR |→]]===
-Nom de la fonction : weADisplayIgMessage
+{{: NpcManager ARCC FR }}
-Cette fonction permet d'afficher des messages dans les canaux de discussions (2).
-Il faut noter que l'utilisation de la tarduction permet d'avoir le texte dans la langue du joueur. Le texte en anglais étant : « We call it Voight-Kampff for short. » (Blade Runner).
+===Send command to server [[Hmagic ARCC FR |→]]===
+{{: Hmagic ARCC FR }}
-Le tableau suivant donne la liste les caractéristiques des choix de canaux offerts par la fonction (4).
+==Checks==
+===Datas [[Datas ARCC FR |→]]===
+{{: Datas ARCC FR }}
-Mode
+===Switch [[Switch ARCC FR |→]]===
-où
+{{: Switch ARCC FR }}
-couleur
-canal
-SYS. INFOS
-Default message system
-blanc
+===Verification of value in database [[Check Database ARCC FR |→]]===
+{{: Check Database ARCC FR }}
-Oui
+===Player verification check from server (Fames, Dapper, Position...) [[Check PlayerInfos ARCC FR |→]]===
-Only in arround channel
+{{: Check PlayerInfos ARCC FR }}
-jaune
+==Captures information==
-alentours
+===Captures information on the player [[PlayerInfos ARCC FR |→]]===
-Non
+{{: PlayerInfos ARCC FR }}
-Ambiance
-haut
-jaune
-Oui (3)
+==Steps to be validated by player==
-Task
+===NewGiveItems [[NewGiveItems ARCC FR |→]]===
-bas
+{{: NewGiveItems ARCC FR }}
-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
+===NPC dialog bubble option (like classic missions) [[NpcDialog ARCC FR |→]]===
+{{: NpcDialog ARCC FR }}
-Oui
+===The player must wait X seconds for validation (automated validation possible) [[Timer ARCC FR |→]]===
-Spell from me
+{{: Timer ARCC FR }}
-bleu clair
+===Mission [[Mission ARCC FR |→]]===
+{{: Mission ARCC FR }}
-Oui
+===Itemshop [[Itemshop ARCC FR |→]]===
-Emote
+{{: Itemshop ARCC FR }}
-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
-alentours
-==={weAShapeManager_short_description}===
-Nom de la fonction : weAShapeManager_v2
-WIP
-MC »  SpawnBags
-===Save value in the database===
-Nom de la fonction : weADatabase_v2
-MC »  StartMission
-MC »  SpawnBags
-Cette fonction sert à stocker une information dans une base locale réexplotable parla suite dans le meme 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.
-)  Database name : une base de l'event (omega dans l'exemple).
-) {databaseRow} : une colonne de la base(1) (Khi, dans l'exemple)
-WIP
-) {databaseId} :
-player : signification ?
-[get]bag[/get] signification, fonctionnement ?
-) 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.
-) {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.
-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]
-<empty>
-[db=Player_Bag]Last[/db]
-[param]Max_player_bag[/param]
-===Save items given by the player in the event database===
-Nom de la fonction : weAItemsDatabase
-Obsolète ??
-===Player received item===
-Nom de la fonction : weAReceiveItems
- MC »  StartMission
-teddyubo.sitem
-=== {weADeleteItems_short_description}===
-Nom de la fonction : weADeleteItems
-==={weANpcManager_short_description}===
-Nom de la fonction : weANpcManager
-===Send command to server===
-Nom de la fonction : weAHmagic
-==Checks==
-==={weCSwitch_short_description}===
-Nom de la fonction : weCSwitch_v2
-MC »  StartMission
-MC »  SpawnBags
-===Verification of value in database===
-Nom de la fonction : weCDatabase
-===Player verification check from server (Fames, Dapper, Position...)===
-Nom de la fonction : weCPlayerInfos
-==={weCDatas_short_description}===
-Nom de la fonction : weCDatas
-==Captures information==
-.1- Captures information on the player
-Nom de la fonction : weGPlayerInfos
-==Steps to be validated by player==
-==={weSNewGiveItems_short_description}===
-Nom de la fonction : weSNewGiveItems
-===NPC dialog bubble option (like classic missions)===
-Nom de la fonction : weSNpcDialog_v2
- MC »  StartMission
-===The player must wait X seconds for validation (automated validation possible)===
-Nom de la fonction : weSTimer
-MC »  StartMission
-MC »  AddBoost
-==={weSMission_short_description}===
-Nom de la fonction : weSMission
-MC »  SpawnBags
-==={weSItemshop_short_description}===
-Nom de la fonction : weSItemshop
-==Exécuter le script==
- 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‎}}
 [[Category:Tutorials]]
-[[Category:Dev]]
+[[Category:ARCC]]
 [[Category:FR]]

From Ryzom Forge Wiki

Latest revision as of 09:23, 14 June 2018

Contents

Les fonctions de script

Visualizations

Displaying a message

Actions without player intervention

End of script →

Jump →

Include →

While →

Gestion des fenêtres webig →

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

ShapeManager →

Save value in the database →

Save items given by the player in the event database →

Player received item →

DeleteItems →

NpcManager →

weAGroupScript

weASpawnBot

weADeSpawnBot

weAGroupScriptSay

weAGroupScriptEmote

weAGroupScriptAiAction

Send command to server →

weASendUrl

weATeleport

weATeleportToEntity

weAManageMoney

weAChangeFame

weAChangeFactionPoints

weAManageGuildMoney

weAManageBuilding

weATriggerPacs

weASetOrganization

weAFixOldBuildings

Dans les fonction il faudra analyser:

Checks

Datas →

Switch →

Verification of value in database →

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

weCPlayerFaction

weCPlayerDappers

weCPlayerPosition

weCPlayerItem

weCPlayerTarget

weCPlayerFame

weCPlayerGuild

weCPlayerGuildDappers

weCPlayerFreetrial

Captures information

Captures information on the player →

Steps to be validated by player

NewGiveItems →

NPC dialog bubble option (like classic missions) →

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

Mission →

weAMissionGeneric

weAMissionLoot

weAMissionTalkTo

weAMissionKillFauna

weAMissionKillNpc

weAMissionRemove

Itemshop →

weItems

weNamedItem

weVirtualItem