View source for ARK, guide Archives

<noinclude>{{Trad
|DE=
|EN=ARK, guide Archives
|ES=
|FR=ARK, guide Archives
|RU=
}}</noinclude>
{{Obsoleted}}

<big><big><big>ᐘTo updated [[ARK, guide]]</big></big></big>

''For historical reasons, those manuals refers very often, almost always, to '''A.R.C.C.'''. 
''This is due to the fact that the full documentation has been started with the initial name, '''ARCC''', meaning '''A'''dvanced '''R'''yzom '''C'''ontent '''C'''reator.



*[[ARK, quick guide|Volume I : Quick Start Guide]]  - [[ARK, quick Archives|Volume II : quick Archives]]
*[[ARK, guide|Volume II : User guide]] - [[ARK, guide Archives|Volume II : User guide Archives]]
*[[ARK, expert|Volume III: Advanced user guide]] - [[ARK, expert Archives|Volume II : expert Archives]]

<!--{{Banner|ff0|Important Note|[[File:WarningRyzom.png |left|]] To coming on documentation and made quicly enable translations, I try to write as much as possible what I have understood and tested. 

'''What is not clear and validated is highlighted in yellow'''.

You are welcome to improve the documentation.}}

{{Banner|ff0|Important Note|[[File:WarningRyzom.png|left|]] This page is actually a merger of other pages (wiki transclusion). 

With the exception of paragraph 2.1,

'''all paragraphs Level 2 are editable and can be viewed by clicking on the arrow (→) behind the title of the functions'''.}}-->
'''Note''': with the exception of paragraph 2.1, all paragraphs Level 2 are in single page that can be accessed by clicking on the arrow (→) behind the title of the functions.
==The script functions==
This guide is intended to show how to use the scripting capabilities of the ARCC, Advanced Ryzom Content Creator.
It is recommended to read the [[ARCC intro EN|volume I]] for having an overview of the use of the ARCC.
The functions of the script are classified into five groups.
#Visualizations
#Actions without player intervention
#Checks
#Captures information
#Steps to be validated by player

==Visualizations==

This group has only one function, one of the simplest and most common.

'''It serves as a reference with regard to the areas and buttons common to all functions detailed in separate pages for an easy maintenance of the ARRC documentation. 

*Common objects will be reported in the documentation by <span style="color:#f0f">'''[common]'''</span>.
*The tag <span style="color:#f00">'''[expert]'''</span> corresponds to the advanced editing mode (see below paragraph 10).
<div style="overflow: hidden">
[[File:Advanced.png|200px|thumb|left|window title and function name]]
{|
|[[File:User suit.png|32px|Home]]
|The edit mode is also indicated by an icon alongside the function which was published in this mode.
|}
</div>

===weVMessage (Displaying a message)===
{|
|[[File:Style.png|32px|Home]]
|Internal function name: ''' ''weVMessage'' '''
|}
<div style="overflow: hidden">
[[File:WeVMessage 3.png|200px|thumb|left|window title and function name]]
This function displays a message in a WebIG window, with a title (in the sample here: Unit_test: " ''May the Force be with you'' " )
</div>
<div style="overflow: hidden">
[[File:WeVMessage.png|200px|thumb|left|weVMessage_v3]]
*'''1)''' <span style="color:#f0f">'''[commun]'''</span> Function name.
*'''2)''' <span style="color:#f00">'''[expert]'''</span> Always display this message (Yes/No)
*'''3)''' <span style="color:#f00">'''[expert]'''</span> Player must click the link in the message (Yes/No)
*'''4)''' Text field for the message.
</div>
<div style="overflow: hidden">
[[File:WeVMessage 2.png|200px|thumb|left|Text field]]
*'''5)''' <span style="color:#f0f">'''[commun]'''</span> enlargement zone corner '''(4)'''
*'''6)''' <span style="color:#f0f">'''[commun]'''</span> toggle button editor. (assisted mode or not)
</div>
*'''7)''' <span style="color:#f00">'''[expert]'''</span> Type of message content:
:*'''bbcode''' (recommended; an aide-memoire of ryzom  bbcode is provided in a [[ARCC Expert EN|dedicated page]].) 
<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>
	Exemple :
[session=url_validated][scriptinfos]is_valid_url[/scriptinfos][/session]
</poem>
</div>
:*'''html''' (Specific, studied later, but immediately testable in web page)
<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>
	Exemple :
<nowiki><hr/>Hello!
<br/>this is a new line
<hr>External link!
<img src="http://wiki.blender.org/skins/naiad/images/blender_logo.png"/><hr/></nowiki>
</poem>
</div>
:*'''lua''' (very specific; to see later)
<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>
	Exemple :
[lua]
function game:onMissionSelected(index)	
	disableModalWindow()
	self:updateCurrMissionComboBox()
	local missionWnd = getMissionWindow()
	setOnDraw(missionWnd, "game:updateArccMissionCustomDesc()")
end
...
updateArccMissionCustomDesc_loop = 100
game:updateArccMissionCustomDesc(1)
[/lua]
</poem>
</div>
*8) <span style="color:#f0f">'''[commun]'''</span> Internal name of the function. This name is used especially for jumps, loops ...
*9) <span style="color:#f0f">'''[commun]'''</span> Save Changes button.
*10) <span style="color:#f0f">'''[commun]'''</span> toggle the "Basic Edition" mode to "Advanced Edit" mode.
Once in "Advanced Edit" mode, it is no longer possible to return to the "Basic Edition" mode. 

The description of functions in that guide will always be in "Advanced Edit" mode. 
The specific "Advanced objects" are indicated by <span style="color:#f00">'''[expert]'''</span>

==Actions without player intervention==
===End of script [[ARK/End of script|⇒]]===
{{:ARK/End of script}}

===Jump [[ARK/Jump |⇒]]===
{{:ARK/Jump}}

===Include [[ARK/Include |⇒]]===
{{:ARK/Include}}

===While  [[ARK/While |⇒]]===
{{:ARK/While}}

===Window (webig windows management)  [[ARK/Window |⇒]]===
{{:ARK/Window}}

===Display message in game (broadcast, crafting information...) [[ARK/DisplayIgMessageR |⇒]]===
{{:ARK/DisplayIgMessage}}

===ShapeManager [[ARK/ShapeManager |⇒]]===
{{:ARK/ShapeManager}}

===Save value in the database [[ARK/Database |⇒]]===
{{:ARK/Database}}

===Save items given by the player in the event database [[ARK/ItemsDatabase |⇒]]===
{{:ARK/ItemsDatabase}}

===Player received item [[ARK/ReceiveItems |⇒]]===
{{:ARK/ReceiveItems}}

=== DeleteItems [[ARK/DeleteItems |⇒]]===
{{:ARK/DeleteItems }}

===NpcManager [[ARK/NpcManager |⇒]]===
{{:ARK/NpcManager}}

===Send command to server [[ARK/Hmagic |⇒]]===
{{:ARK/Hmagic}}

==Checks==
All these check offers action after a logical evaluation, TRUE or FALSE. 
===Datas [[ARK/Datas |⇒]]===
{{:ARK/Datas}}

===Switch [[ARK/Switch |⇒]]===
{{:ARK/Switch}}

===Verification of value in database [[ARK/Check Database |⇒]]===
{{:ARK/Check Database}}

===Player verification check from server (Fames, Dapper, Position...) [[ARK/Check PlayerInfos |⇒]]===
{{:ARK/Check PlayerInfos}}

==Captures information==
===Captures information on the player [[ARK/PlayerInfos |⇒]]===
{{:ARK/PlayerInfos}}

==Steps to be validated by player==
===NewGiveItems [[ARK/NewGiveItems|⇒]]===
{{: ARK/NewGiveItems}}

===NPC dialog bubble option (like classic missions) [[ARK/NpcDialog |⇒]]===
{{:ARK/NpcDialog}}

===The player must wait X seconds for validation (automated validation possible) [[ARK/Timer |⇒]]===
{{:ARK/Timer}}

===Mission [[ARK/Mission |⇒]]===
{{:ARK/Mission}}

===Itemshop [[ARK/Itemshop |⇒]]===
{{:ARK/Itemshop}}

{{In_Category|ARK}}
{{Portal|Forge}}

[[Category:ARK]]
[[Category:Forge Obsolete‎]]