ARK, expert - Revision history

Zorroargh at 14:20, 31 October 2021

2021-10-31T14:20:13Z

Dorothée: /* Autre soutils de l'ARCC */

2020-10-12T06:27:04Z

‎Autre soutils de l'ARCC

Zorroargh at 12:31, 31 May 2020

2020-05-31T12:31:02Z

Amosys at 14:50, 2 June 2019

2019-06-02T14:50:49Z

Amosys at 21:46, 1 June 2019

2019-06-01T21:46:22Z

Zorroargh at 11:53, 19 January 2019

2019-01-19T11:53:40Z

Zorroargh at 10:20, 14 June 2018

2018-06-14T10:20:23Z

Zorroargh: Created page with "{{Migrated to|:en:ARK, expert}} {{tabLang|EN|ARCC Expert DE|ARCC Expert EN|ARCC Expert ES|ARCC Expert FR|ARCC Expert RU}} {{toTrad|DE}} {{toTrad|EN|To check the quality of th..."

2018-06-14T08:33:16Z

Created page with "{{Migrated to|:en:ARK, expert}} {{tabLang|EN|ARCC Expert DE|ARCC Expert EN|ARCC Expert ES|ARCC Expert FR|ARCC Expert RU}} {{toTrad|DE}} {{toTrad|EN|To check the quality of th..."

New page

{{Migrated to|:en:ARK, expert}}
{{tabLang|EN|ARCC Expert DE|ARCC Expert EN|ARCC Expert ES|ARCC Expert FR|ARCC Expert RU}}

{{toTrad|DE}}
{{toTrad|EN|To check the quality of the text itself}}
{{toTrad|ES}}
{{toTrad|FR|À corriger par rapport à l'anglais. Attendre qu'il n'y ait plus de "WIP" (marques jaunes) }}
{{toTrad|RU}}

<big>'''User guide for Ark, short for Ryzom Arkitect.'''</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.

*[[ARCC intro EN|Volume I : Quick Start Guide]]
*[[ARCC Guide EN|Volume II : User guide]]
*[[ARCC Expert EN|Volume III: Advanced user guide]]

==Ryzom specific BBCODE==

===data===
====Settings====
*'''text'''
*'''attribute'''
====Exemples====
<hr/>

===date===
''' ''date'' ''' displays date in "human". See also ''[[#time|time]]''.
====Settings====
*'''text''': If empty or zero gives the actual date.
:otherwise, seconds to add to 1970-01-01 00:00.
*'''attribute''': format for the date. By default if empty: "YYYY-MM-DD hh:mm"
====Exemples====
*[date]0[/date] ⇒ 2014-10-24 15:31
*[date]3600[/date] ⇒ 1970-01-01 02:00
*[date]-3600[/date ] ⇒ 1970-01-01 00:00

*[date="%d/%m/%Y %H:%M"]3600[/date] ⇒ "01/01/1970 02:00"
<hr/>

=== db ===
''' ''db'' ''' store or read a value in a DB.
DB is of different kind of rows sets.
For instance, "player" DB will memorize the name of the player in column 0; ARCC DB, will memorize an internal number,...
Columns can be named, otherwise they are referred by the sequential numeration 0 to n
==== Settings ====
* '''text''': (general form: xxx:xxx:xxx)
*# store a data in a cell
*# read the contents in a cell
: A cell is defined as: ''line'':''scope'' where:
# ''line'' is a specific kind of data.
# ''scope'' is associated to the characteristics of the players who are:
## player (by default and equivalent to '0' )
## guild
## arcc
## civ
## cult
## org
## race
* '''attribute''': Name of the database.

==== Examples ====
*[db=TestDB]0:0=100[/db] load 100 in the cell 0:0 of TestDB.
*[db=TestDB]3:0[/db] read the cell 3:0
<hr/>

===div===
''' ''div'' ''' is the equivalent of the HTML bloc <nowiki><div></nowiki>.
That container can divide the page in sections containing the style and other attributes of a HTML bloc.
====Settings====
*'''text''': Any kind of data who can be included in a HTML bloc: text, images... and their format.
*'''attribute''': normaly an array composed by three elements:
** class
** id
** style
====Exemples====
*<nowiki>[div class="Bepock" id="bepock" style="margin:1em;padding:1em;border:none;background:#fed;color:#300;"]Blabla<br/>blabla<br/>...[/div]</nowiki>
displays:
<div style="margin:1em; padding:1em;border: none;background:#fed;color:#300;">Blabla<br/>blabla<br/>...</div>
<hr/>

===expr===
====Settings====
*'''text'''
*'''attribute'''
====Exemples====
<hr/>

===func===
''' ''func'' ''' allow the execution of some functions known in Ryzom.
====Settings====
*'''text''': (general form: <1st_part_of_text>|<2nd_part_of_text>|...). Parameters for the functions (except if function has no parameters, in that cas could be the function itself).
*'''attribute''':one of the next functions:
**now: internal server time in tics
**rand: random value in a range of two limits.
**sqrt: square root.
**log: natural logarithm.
**pow: power of <1st_number_in_text> by <2nd_number_in_text>.
**round: round of a number.
**floor: floor of a number.
**min: min between two numbers.
**max: max between two numbers.
**find: find in the <1st_string_in_text> the <2nd_string_in_text>: return 1 if found, otherwise, 0.
**split: split the <1st_part_of_text> (a string) by the <2nd_part_of_text> (a char) and return the nth element of the split gift by the <3rd_part_of_text> (a number), if define otherwise the first element counting from 0.
**substr: extract a substring from the <1st_part_of_text> (a string) begininh at the <2nd_part_of_text> (a number) till the <3rd_part_of_text> (a number), if define otherwise till the end of the given string. Chars are counted from 0.
**unset_url_param: unset parameters.
**building: include if not already defined an alias to the <1st_string_in_text>.

====Exemples====
*now: [func]now[/func] or [func=now]100[/func]
*rand: [func=rand]0|10[/func]
*sqrt: [func=sqrt]64[/func] = 8
*log: [func=log]10[/func] = 2.302585092994
*pow: [func=pow]10|2[/func] = 100
*round: [func=round]2.85092994[/func] = 3
*floor: [func=floor]2.85092994[/func] = 2
*min: [func=min]10|2[/func] = 2
*max: [func=max]10|2[/func] = 10
*find:
**[func=find]AZERTYUIOP|Y[/func] = 1
**[func=find]azertyuiop|Y[/func] = 0
*split:
**[func=split]A_B_C_D|_[/func] = A
**[func=split]A_B_C_D|_|2[/func] = C
*substr:
**[func=substr]A_B_C_D|2[/func] = B_C_D
**[func=substr]A_B_C_D|2|4[/func] = B_C_
<hr/>

===gender===
''' ''gender'' ''' returns a text according to the gender.
====Settings====
*'''text''': text to display if the char has the gender of the attribute.
*'''attribute''': '''''m''''' or '''''f'''''
====Exemples====
''We assume that the player is male.''
*[gender=m]Sir![/gender] returns '''''Sir!'''''
*[gender=f]Miss![/gender] returns nothing.
<hr/>

===get===
====Settings====
*'''text''':
*'''attribute''': None.
====Exemples====
<hr/>

===hack===
Empty function!
<hr/>

===if===
''' ''if'' ''' displays a text if attribute is OK
====Settings====
*'''text''': text to display if attribute is OK
*'''attribute''': math evaluation.
<hr/>

===ifnot===
''' ''ifnot'' ''' displays a text if attribute is NOT OK
====Settings====
*'''text''': text to display if attribute is NOT OK
*'''attribute''': math evaluation.
<hr/>

===img===
''' ''img'' ''' displays an image.
''Something is wrong because, I (Bepock) obtain always a '' " title="" /> '' after the image. Use [imgurl] instead: it works fine.''
====Settings====
*'''text''': image_URL
*'''attribute''': does not work

====Exemples====
*<nowiki>[img]http://app.ryzom.com//data/icons/32/emotion_happy.png[/img]</nowiki>
displays:
:http://app.ryzom.com//data/icons/32/emotion_happy.png " title="" />
<hr/>

===imgurl===
''' ''imgurl'' ''' displays an image linking to an URL.
====Settings====
*'''text''': (general form: xxx xxx xxx). 2 kinds of data:
*# URL of the image, mandatory: clickable image;
*# Display name of the URL when mouse goes over the image. Preceded by the underscore character ("_"), it is a text that will be translated. It remains enclosed by brackets "{}" if it is not translated.
*'''attribute''': URL

====Exemples====
*<nowiki>[imgurl=http://forge.ryzom.com/wiki/ARCC_Expert_EN]http://app.ryzom.com//data/icons/32/emotion_tongue.png _The_ARCC[/imgurl]</nowiki>
displays:
:[http://forge.ryzom.com/wiki/ARCC_Expert_EN [[file:emotion_tongue.png|The_ARCC]] ]
<hr/>

===itemicon===
''' ''itemicon'' ''' displays a thumbnail of an item.
====Paramètres====
*'''text''': the item ([[Sitem|SITEM file]])
*'''attribute''': None.
====Exemples====
*[itemicon]teddyubo.sitem[/itemicon] or
*[itemicon]teddyubo[/itemicon] displays: http://api.ryzom.com/data/cache/item_icons/0cf49e1620be972028c29a613d11ef2a.png

An anexistant or erroneous file such [itemicon]NoExist[/itemicon] displays : http://api.ryzom.com/data/cache/item_icons/c37962969910e09734d859a89e32085c.png
<hr>

===link===
''' ''link'' ''' builds a internal link.
====Settings====
*'''attribute'''
** if "#", the text is the url name.
** if empty, the text is a list of selected parameters in the script.
====Exemples====
''We assume that the number of the script is 2124.''
*<nowiki>[link=#]A name for that link[/link] ⇒ displays a link with the name "A name for that link" to the URL http://app.ryzom.com/app_arcc/index.php?action=mScript_Edit&script=2124&select=0</nowiki>
*<nowiki>[link]#A B Cl[/link] ⇒ displays the </nowiki>'''text'''<nowiki> (not a link) http://app.ryzom.com/app_arcc/index.php?action=mScript_Edit&script=2124&select=A+B+C</nowiki>
<hr/>

===lua===
''' ''lua'' ''' passes the ''text'' to the [[Ryzom Lua]] interpreter.
====Settings====
*'''text''': Lua script.
*'''attribute''': None.
<hr/>

===map===
''' ''map'' ''' displays a square map of 2000 units around a given point marked by a magenta flag.
====Settings====
*'''text''' : name of a point (for instance city name) or Ryzom coordinates.
*'''attribute''': '' "flags" '' displays with green flags all outposts.
====Exemples====
<div style="overflow: hidden">
[[File:mapLoria.jpeg|200px|thumb|left|Loria map]]
<nowiki>[map]18176,-29492[/map]</nowiki>
</div>
<div style="overflow: hidden">
[[File:mapPyr.jpeg|200px|thumb|left|Pyr map]]
<nowiki>[map flags=markers]pyr[map]</nowiki>
</div>
<hr/>

===math===
''' ''math'' ''' calculates basic calculations.
====Settings====
*'''text''' : a basic calculations with the four arithmetical operators: +, -, *, /.
*'''attribute''': no significative.
====Exemples====
*[math]1+2*3-4/6[/math] = 6.3333333333333
*[math=toto][/math] and [math=toto]1+2*3-4/6t[/math] ⇒ no output

*[math][func=round]6.45[/func][/math] = 6
*[math][func=round]6.45[/func]*2[/math] = 12
<hr/>

===param===
====Settings====
*'''text'''
*'''attribute'''
====Exemples====
<hr/>

===playerbackup===
====Settings====
*'''text''' :
*'''attribute''':
====Exemples====
<hr/>

===playerinfos===
''' ''playerinfos'' ''' gives some informations concerning the player.
====Settings====
*'''text''': (general form: xxx|xxx|xxx) . One of the next keys: 'name', 'fullname', 'id', 'guild', 'guild_id', 'pvp_points', 'money', 'cid', 'gender' or 'api'.
** <small>next fields up to 2: values of that key if needed for api.</small>
*'''attribute''':
** Empty
** #<name>
** <name>
====Exemples tested by Bepock====
*name: [playerinfos]name[/playerinfos] ⇒ Bepock (for instance)
*fullname: [playerinfos]fullname[/playerinfos] ⇒ fullname: Bepock(Atys)
*id: [playerinfos]id[/playerinfos] ⇒ 19089
*guild: [playerinfos]guild[/playerinfos] ⇒ Animation
*guild_id: [playerinfos]guild_id[/playerinfos] ⇒ 105906345
*money: [lua][playerinfos]money[/playerinfos][/lua]
*cid: [playerinfos]cid[/playerinfos] ⇒ 9765472
*gender: [playerinfos]gender[/playerinfos] ⇒ 1 (male)
<hr/>

===playerstat===
====Paramètres====
*'''text''': (general form xxx|xxx|xxx)
*'''attribute''': None.
====Exemples====
<hr/>

===post===
====Settings====
*'''text''':
*'''attribute''': None.
====Exemples====
<hr/>

===scriptinfos===
''' ''scriptinfos'' ''' displays the translations associated to a keyword if it exist in the language of the user (See also the "[[ARCC traductions EN|trad tool]]" of ARK).
====Paramètres====
*'''text''': (general form xxx|xxx|xxx)
*'''attribute''': None.
====Exemples====
<hr/>

===scripturl===
''' ''scripturl'' ''' cats action, action number and extension to be send to the server.
====Settings====
*'''text''': add a PHP extension to the URL gift in the attribute.
*'''attribute''':
** Nothing: current action number of the script.
** Otherwise: first letter of the letter field if not "space". In that case add a "+".
====Exemples====
Launched from script 2088:
:[scripturl]ryform_action=edit&ryform_name=stages%3A0[/scripturl] donne:
:<nowiki>http://app.ryzom.com/app_arcc/index.php?action=script_Edit&script=</nowiki>'''2088'''<big>&</big>''ryform_action=edit&ryform_name=stages%3A0''
<hr/>

===session===
''' ''session'' ''' is the simplest way to memorize data during the session, i.e. the connection. It offers also quicker answer, because it is a temporary memory not stored in the DB server.

<small>It can be use also in some condition as a temporary array, when each ''Rows'' are named, because that is the internal behaviour of ''Session''.</small>
====Settings====
*'''text''': depends of the attribute.
*'''attribute''':
** <empty> : ''text'' is the ''raw name'' of ''Session''.
** any ''raw name'' : save the ''text'' in the temporary memory of ''Session''.
====Exemples====
*Putting a value:
**[session=Name_1]Name one[/session]
**[session=Name_2]⇒Name two⇐[/session]
*Getting the value stored in the session (connection)
**Name_1 = [session]Name_1[/session] displays : "Name one"
**Name_2 = [session]Name_2[/session] displays : "⇒Name two⇐"
<hr/>
===t===
''' ''t'' ''' displays the translations associated to a keyword if it exist in the language of the user (See also the "[[ARCC traductions EN|trad tool]]" of ARK).
====Paramètres====
*'''text''': (general form xxx|xxx|xxx)
*'''attribute''': None.
====Exemples====
*[t]yes[/t] ⇒ gives for French user "Oui"
*[t]text[/t] ⇒ gives for French user "Texte"
But, because keyword is case sensitive:
*[t]Yes[/t] ⇒ gives {Yes}
*[t]Text[/t] ⇒ gives {Text}
<hr/>

===timer===
''' ''timer'' ''' displays time in format "hh:mm:ss".
*See also ''[[#date|date]]''.
====Settings====
*'''text''': If empty or zero or "now()" gives the actual time in ''days_of_the_current_year'':''GMT_hour'':''minutes'':''seconds''.
:otherwise, treats the value in the text as number of seconds, and display the equivalent "hour'':''minutes'':''seconds''.
*'''attribute''': None.
====Exemples====
*[timer][/timer] or [timer]now()[/timer] or [timer]0[/timer] ⇒ 296:13:05:18
*[timer]60[/timer] ⇒ 00:01:00
*[timer]3600[/timer] ⇒ 01:00:00
<hr/>

===trad===
''' ''trad'' ''' displays one of the translations associated to a keyword if it exist in the language of the user (See also the "[[ARCC traductions EN|trad tool]]" of ARK).
====Settings====
*'''text''': (general form: xxx|xxx|xxx, and internal xxx_xxx_xxx).
*'''attribute''': sens if text empty
====Exemples====
*<nowiki>[trad]Hello[/trad] ⇒ displays the local translation</nowiki>
*<nowiki>[trad=Hello][/trad] ⇒ displays the local translation</nowiki>
<hr/>

===url===
''' ''url'' ''' is the standard way to pass an URL. That URL visually is formatted as usual in Ryzom.
====Settings====
*'''text''' : URL or text to display
*'''attribute''':
**if text=<empty>: URL;
**else, text to be displayed: name, description... of the URL.
====Exemples====
*<nowiki>[url]http://forge.ryzom.com/wiki/ARCC_Expert_EN[/url]</nowiki>
*<nowiki>[url=http://forge.ryzom.com/wiki/ARCC_Expert_EN]The ARCC[/url]</nowiki>
<hr/>

===validate===
''' ''validate'' ''' returns a link of the actual stage in the script.
====Settings====
*'''text''': name of the link
*'''attribute''':
====Exemple====
''We assume that the number of the script is 2124.''

<nowiki>[validate]==validate==[/validate] ⇒ displays a link with the name "==validate==" to the URL http://app.ryzom.com/app_arcc/index.php?action=mScript_Edit&script=2124&command_13=validate</nowiki>
<hr/>

==Autre soutils de l'ARCC==
*[[ARCC traductions EN|Traduction automatique]]

'''[[ARCC Guide EN|←ARCC Guide EN]]'''
{{In_Category|ARCC}}
{{TPInWikiRyzom‎}}
[[Category:Tutorials]]
[[Category:ARCC]]
[[Category:EN]]

@@ Line 407: / Line 407: @@
 {{In_Category|ARK}}
 {{Portal Forge}}
-[[Category:ARK]] [[Category:Tutorials]] [[Category:Forge]] [[Category:Reference Guides]]
+[[Category:ARK]] [[Category:Tutorials]]
 {{last version link|ARK, expert}}

@@ Line 407: / Line 407: @@
 {{In_Category|ARK}}
 {{Portal Forge}}
-[[Category:Tutorials]]
+[[Category:ARK]] [[Category:Tutorials]] [[Category:Forge]] [[Category:Reference Guides]]
-[[Category:ARK]]
+{{last version link|ARK, expert}}

@@ Line 405: / Line 405: @@
 '''[[ARCC Guide EN|←ARCC Guide EN]]'''
-{{In_Category|ARCC}}
+{{In_Category|ARK}}
 {{Portal Forge}}
 [[Category:Tutorials]]
 [[Category:ARK]]

@@ Line 8: / Line 8: @@
 <big>'''User guide for Ark, short for Ryzom Arkitect.'''</big>
-XXXXXXXXXXXXXXXXXXXXXXXXXXXX Obsolete xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+{{Cleanup|this article is far too old. }}  [https://fr.wiki.ryzom.com/wiki/Utilisateur:Amosys Amosys] ([https://fr.wiki.ryzom.com/w/index.php?title=Discussion_utilisateur:Amosys&action=edit&section=new talk to Amosys on wiki]) (On RC [https://chat.ryzom.com/channel/pj-ryzom_wiki pj-ryzom_wiki]) 16:47, 2 June 2019 (CEST).
 Backup done on [[ARK, expert Archives]]
 ''For historical reasons, those manuals refers very often, almost always, to '''A.R.C.C.'''.

@@ Line 11: / Line 11: @@
 ''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.
-*[[ARCC intro EN|Volume I : Quick Start Guide]]
+*[[ARK, quick guide|Volume I : Quick Start Guide]]
-*[[ARCC Guide EN|Volume II : User guide]]
+*[[ARK, guide|Volume II : User guide]]
-*[[ARCC Expert EN|Volume III: Advanced user guide]]
+*[[ARK, expert|Volume III: Advanced user guide]]
 ==Ryzom specific BBCODE==

@@ Line 1: / Line 1: @@
-{{Migrated to|:en:ARK, expert}}
+{{Trad
-{{tabLang|EN|ARCC Expert DE|ARCC Expert EN|ARCC Expert ES|ARCC Expert FR|ARCC Expert RU}}
+|DE=
+|EN=ARK, expert
-{{toTrad|DE}}
+|ES=
-{{toTrad|EN|To check the quality of the text itself}}
+|FR=ARK, expert
-{{toTrad|ES}}
+|RU=
-{{toTrad|FR|À corriger par rapport à l'anglais. Attendre qu'il n'y ait plus de "WIP" (marques jaunes) }}
+}}
 <big>'''User guide for Ark, short for Ryzom Arkitect.'''</big>
@@ Line 403: / Line 400: @@
 '''[[ARCC Guide EN|←ARCC Guide EN]]'''
 {{In_Category|ARCC}}
-{{TPInWikiRyzom‎}}
+{{Portal Forge}}
 [[Category:Tutorials]]
-[[Category:ARCC]]
+[[Category:ARK]]