Difference between revisions of "ARK, guide"

From EncyclopAtys

Jump to: navigation, search
Line 13: Line 13:
  
 
*[[ARCC intro EN|Volume I : Quick Start Guide]]
 
*[[ARCC intro EN|Volume I : Quick Start Guide]]
βˆ’
*[[ARCC Guide EN|Volume II : User guide]]
+
*[[ARCC ARK, guide|Volume II : User guide]]
 
*[[ARCC Expert EN|Volume III: Advanced user guide]]
 
*[[ARCC Expert EN|Volume III: Advanced user guide]]
  

Revision as of 13:49, 16 June 2018

en:ARK, guide
fr:ARK, guide
 
UnderConstruction.png
Translation to review
Don't blame the contributors, but come and help them 😎

Reference text ( Maintained text, used as reference ) :
Notes: (Zorroargh, 2018-06-16)


User guide for Ark, short for Ryzom Arkitect.

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 Advanced Ryzom Content Creator.

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 volume I for having an overview of the use of the ARCC. The functions of the script are classified into five groups.

  1. Visualizations
  2. Actions without player intervention
  3. Checks
  4. Captures information
  5. 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 [common].
  • The tag [expert] corresponds to the advanced editing mode (see below paragraph 10).
window title and function name
Home The edit mode is also indicated by an icon alongside the function which was published in this mode.

weVMessage (Displaying a message)

Home Internal function name: weVMessage
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 " )

weVMessage_v3
  • 1) [commun] Function name.
  • 2) [expert] Always display this message (Yes/No)
  • 3) [expert] Player must click the link in the message (Yes/No)
  • 4) Text field for the message.
Text field
  • 5) [commun] enlargement zone corner (4)
  • 6) [commun] toggle button editor. (assisted mode or not)
  • 7) [expert] Type of message content:
  • bbcode (recommended; an aide-memoire of ryzom bbcode is provided in a dedicated page.)

Exemple :
[session=url_validated][scriptinfos]is_valid_url[/scriptinfos][/session]

  • html (Specific, studied later, but immediately testable in web page)

Exemple :
<hr/>Hello!
<br/>this is a new line
<hr>External link!
<img src="http://wiki.blender.org/skins/naiad/images/blender_logo.png"/><hr/>

  • lua (very specific; to see later)

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] Internal name of the function. This name is used especially for jumps, loops ...
  • 9) [commun] Save Changes button.
  • 10) [commun] 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 [expert]

Actions without player intervention

End of script β†’

End of script ARCC EN

Jump β†’

Jump ARCC EN

Include β†’

Include ARCC EN

While β†’

While ARCC EN

Window (webig windows management) β†’

Window ARCC EN

DisplayIgMessage (Display message in game: broadcast, crafting information...) β†’

DisplayIgMessage ARCC EN

ShapeManager β†’

ShapeManager ARCC EN

Database (Save value in the database) β†’

Database ARCC EN

ReceiveItems (Player received item) β†’

ReceiveItems ARCC EN

DeleteItems β†’

DeleteItems ARCC EN

NpcManager β†’

NpcManager ARCC EN

Hmagic (Send command to server) β†’

Hmagic ARCC EN

Checks

All these check offers action after a logical evaluation, TRUE or FALSE.

Check Datas β†’

Datas ARCC EN

Switch β†’

Switch ARCC EN

Check Database (Verification of value in database) β†’

Check Database ARCC EN

Check PlayerInfos (Player verification check from server: Fames, Dapper, Position...) β†’

Check PlayerInfos ARCC EN

Captures information

PlayerInfos (Captures information on the player) β†’

PlayerInfos ARCC EN

Steps to be validated by player

NewGiveItems β†’

NewGiveItems ARCC EN

NpcDialog (NPC dialog bubble option like classic missions) β†’

NpcDialog ARCC EN

Timer (The player must wait X seconds for validation, automated validation possible) β†’

Timer ARCC EN

Mission β†’

Mission ARCC EN

Itemshop β†’

Itemshop ARCC EN

There are currently 34 elements in the category ARK.