ARK, guide

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

Remarque importante

Sommaire

1 Les fonctions de script
2 Visualizations
- 2.1 Displaying a message
3 Actions without player intervention
4 Checks
5 Captures information
- 5.1 Captures information on the player →
6 Steps to be validated by player

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:updateARKMissionCustomDesc()")
end
...
updateARKMissionCustomDesc_loop = 100
game:updateARKMissionCustomDesc(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]