en:ARK, quick guide
es:ARK, guía rápida
fr:ARK, présentation
 
UnderConstruction.png
Translation to review
Don't blame the contributors, but come and help them 😎

Reference text ( Maintained text, used as reference ) :
Notes: (Dorothée, 2020-10-12)

Cleanup
It has been suggested that this article should be rewritten or updated, because: this article is far too old..
Amosys (talk to Amosys on wiki) (On RC pj-ryzom_wiki) 16:47, 2 June 2019 (CEST).


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.

Ready for the v4 documentation (to write):

Backup:


Contents

Ark

This guide aims at explaining how to use Ark, the Ryzom Arkitect tool that allows the creation of scripts interpreted by a web server and interacting with Ryzom's server.

Access

ARCC Login window

In the top left corner, flags allow you to choose the language of the interface (current screenshots show French view - to be changed whenever someone has time to do it). This login window is the same everywhere in Ryzom. You'll have to fill in the first field with your Character (PC) name. Beware, for the animation team, it should be the name of their animation toon, and not the one of the private characters they could have created in the game (they are allowed 5 PC in game, as any player).

Folders and events

Open

((~This is going to have to be changed because of the selection panel that Ulukyn has made which is divided into different areas of the basic tree structure~)) As soon as login on, the user finds a page offering access to various areas of the ARK.

1st page window

The ARK is laid out as an ensemble of events gathered in folders.

Each folder may contain either events or other folders, which can produce a tree that is more or less complex.

Home The root directory appears as a small «house» icon. The «house» is the first folder, the one that contains all other elements, events and folders.
Folder Generally, folders are represented with classical icons for folders (the last two ones in the example shown here above). Some important folders are given a specific icon.
Event Events are represented with the icon shown on the left.

Navigation

Navigation successive windows

The Zone 3 area allows one to navigate through the directory and event tree. In the example shown, the «TESTS» folder contains the «bepock» folder which, in turn, contains the «test» folder. This one contains one event («Event0») which consists of several scripts. The event is a «sheet» of the tree view browsed during the navigation. (NOTE: For illustration the windows of the browser have been overlapped to show the progress; your browser will only show one pane at a time.) If you need to back up one or several levels you can click on the level you want to go to in Zone 1.

Event

Event window

The event window is a specialized folder with a separate window. The event window allows you to manage the scripts and databases of the event. It is divided into five zones.

Navigation bar (Zone 1)

Zone 1 shows the place of the event in the folders tree. Each clickable link allows you to go to the specified folder (but remember to save your progress first).

Creation field (Zone 2)

Zone 2 allows you to create a new script or a new database.

Tools (Zone 3)

Zone 3 contains two tools:

Parameters of the event

((This link does not yet point to anything substantial - Ceru 25 Sept 2014.))

Table edit.png Set-up

Automated translations

Langs.png How to do automated translations

Scripts (Zone 4)

Zone 4 contains the scripts created in the event shown in zone 1 (here «New Event»).

The bottom part contains the meaning of the colored bullets appended to the scripts.

The middle part contains the list of the scripts associated to the event.

To each script is associated a set of indicators and actions, listed here bellow as they appear from left to right. (to be checked with the English version of the screenshots)

Script A simple script
Linked Script A linked script, meaning assigned to a NPC
Red Orange Green Blue Black
Control_play Script_code Key Status_online Basket_put

Databases (Zone 5)

Script Zone 5 shows the list of the databases of the event.

Script

Script window

To create a script, it is only required to give an name in the text field of Zone 2 of the Event page, and to hit <enter> or to click on the «add» button. Creating the script will open the following window, made op five zones.

Eack clickable link allows to go to the intended folder.

The quickest and least wearying method to create a script is to copy it from another one ressembling to what we want to produce. This method is very useful to create quickly a script that looks like another one, but you'll have to learn how to modify it sooner or later... otherwise, of which use would it be to have two script identical except for their names? That will be explaned in part II of the this user guide for ARK.

Event window

Start with creating a new script with the default values.

Event window

Open the script you want to copy.

It is only needed to click on the «Script2» link, in the example, which opens the script window.

Script window

What appears isn't best fitted for a copy/paste.

Script window

It's better but...

Script window

The display is the one of a file that can easily been copied (ASCII printables characters). To copy, just save it in the clipboard by any method, for example: click on the text (to place the focus), then hit <Ctrl>+A, <Ctrl>+C on Windows and most of the Unices (Unix, Linux, BSD, Androïd...). Beware! If you don't click on the text, you're at risk of saving the whole window with its icons... wich isn't much useful. Replace <Ctrl> with <Apple'>' on Mac.

Fill the new script.

Replay sequences 6 to 8 with «Script1»

Then, click in the already existing text (to place the focus) and select it all (for example: by hitting <Ctrl>+A on Windows and Unices) to replace it with the text saved in the clipboard (for example, by hitting <Ctrl>+V). Once the text has been replaced, save it:

Script window

«Script1» is now a copy of «Script2».

Databases

Event window

ARK databases are used to store information such as the number of mats of a given type gathered by a given player. They're much lick simple tables and don't hold any function nore complex relationships such as the ones that can be found in spreadsheets or relational databases.

DB window

If no name is given at the DB creation, this one will nonetheless be prepared (DB icon without any name on the left). it is always possible to rename a DB. Beware! This rename won't be passed on the scripts which call this base.

DB window

Initialy, creation of a database shows as follow:

DB window

Current example will give the following DB, where:

These fields can be named to make it easier to read and use the scripts which call these data.

Script window

Filling the base is down by the script, as shown in the left image. Writing such a script will be explained in the «Part II: User Guide».

Once this function has been activated, the database shows a content like this one.

DB window
Script An icone at the bottom indicates that the data can be modified manually.

Here you have a filling of databases with different context.

DB window

All mode coexists.

Running

Script window

First, the parameters which affect the running of the script (from 7 to 16) will be described.

Running set-up

Event window
IG window
In Game

Testing in browser

Top Left Creation Window
Script You can start by testing the script in the browser by clicking on (1) in the browser.

It allows to test most or the script proceedings, especially the part about algorithms and displays. Be aware nonetheless to the display which doesn't necessarily appear exactly the same way in the Web and in the WebIG. Indeed some html tags doesn't pass through the last one. For example the <hr/> tag (horizontal rule) doesn't appear in the WebIg, and neither does <br/> (line break). That's why it's better to use bbcode.

To conclude, launching a script in a browser shouldn't be used to check the appearance of a display.

Step by step

Bug go.png If a problem appears during the execution, it may be useful to test the proceedings. In this case, click on (2). The following image shows the result for the current example:
Web
Script edit.png either to edit the script,
Arrow refresh.png or to relaunch it.
Resultset next.png
either simply by clicking on the progess icon,
Pazapa 1.png
or by selecting the proposed choice when there is a multiple connection.

Yubo

To test the script life-size, it has to be lauchned on the test server known under the name of «Yubo». For this, connect on the «Yubo» with an authorized account, choose preferabily a static NPC (so that you don't have to run behind him for the tests) and, of course, a free one (don't re-use a mission NPC so that you don't get unexpected complications).

Top Right Creation Window
In Game

Here, a posted guard has been selected. It shows its interaction mode in a cartouche: ((«ATTACK» in French).

User go.png It is assigned the current script (here, Unit_Test) by a click on the icon (3).

The result of this assignment can't be seen instantaneously, even if it's already active. To make it visible quickly, just click on another NPC and come back on this one. Now, the cartouche should have changed (here: « Live long and prosper »). The script can now be run by the NPC.

Update and removal

Top Right Create window
Script code.png Using the source code has been seen (5) in chapter 4, when copying/pasting the content of a script into another one.
Time.png When update fails, it is always possible to come back to a former version by clicking on (6).
Script window

The most standard way to edit a script is by clicking on its title (here: « jumping »),

Add.png then by adding,
Delete.png removing,
Arrow down.png moving functions,
Arrow up.png and of course, by modifiant the content of the functions themselves (here: « weVMessage_v3_True ») which will be seen in Part II.


Function part of script window

Nota: the erasure icon for a function is at its right. Erasure is immediate, without any alerte or confirmation window. But feel reassured! The history allows you to rollback.

Other tools for the Event

Status

Bullet red.png Being edited.
Bullet orange.png Undergoing testing
Bullet green.png Active on Atys and Yubo
Bullet blue.png Working and locked
Bullet black.png Deactivated (to be removed)

Related rights and shortcuts

Control play.png Run the script.
Script code.png See and edit the script both in human and machine language.
Key.png See and edit the access and running rights.
Status online.png Show who is using the script.
Basket put.png Ask for the script deletion.
Delete.png Deletion of the script.


There are currently 34 elements in the category ARK.


Portal of the Forge of Ryzom Portal of the Forge of Ryzom
Last version 2021-10-31•


Retrieved from "https://en.wiki.ryzom.com/w/index.php?title=ARK,_quick_guide&oldid=39167"