Graal Bible - User contributions [en]

Worlds/Dark Rival

2006-12-04T17:41:18Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-12-04T17:40:25Z

Excaliber7388: /* '''About:''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:dr-ss.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
DR recently introduced an in game Computer for staff to test. Basically, it allows the players to send e-mails to each other, chat off the IRC, in game, go on the internet, and soon, play games. After a few days testing we will release it to the public (it will be released without games, however, you will receive a freebie or two automatically, and most you will have to buy). Start saving your money up!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now. For the longest time, Dark Rival was one of the fastest growing servers around. However, due to popularity, lack of staff activity, and a slow internet connection on the owner's part, the server was shut down. Excaliber has decided to RESTART Dark Rival! It will take a while, due to the lack of Mac dev tools
>=(
Once these are available, DR can come back to life.
[[Image:pic_darkrivalgui.png|thumb|center|175px]]
[[Image:darkrival_wiki.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Wood Chopping'''
-Help an elderly man build his lodge by chopping and delivering wood to him from the local area.
[[Image:wood.gif|thumb|left|150px]]

'''Soon to come'''

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (Admin)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps. We also could use someone who can convert normal levels into gmap format.
::LATs::

LATs, (Level Administration Team) would be responsible for the uploading, maintnence, and developement of levels. Currently, we are making a new overworld, so much of the work would go to making a unique world.

NATs, (NPC Administration Team) would be responsible for the uploading, maintnence, and creation of new and exciting scripts and NPCS. Dark Rival has many weapons, and unique systems, and the NAT's input is greatly appreciated.

GATs, (GFX Administration Team) would be responsibe for the uploading, maintnence, and creation of new, unique graphics.

The application is here: http://darkrivalonline.tripod.com/id9.html

== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

--[[User:Excaliber7388|Excaliber7388]] 00:13, 8 May 2006 (CEST)

Creation/Dev/GScript

2006-10-07T15:38:27Z

Excaliber7388:

'''GScript''' is [[Graal]]'s scripting language.

Its syntax and some of its semantics might seem familiar to those who program in [[WikiPedia:C (Programming Language) |C]] or [[WikiPedia:Java_programming_language|Java]]. In some ways it is more dynamic, e.g. supporting dynamicly joining and leaving of classes, and brings support for easy management of online game content.

GScript started as a very limited language ([[Creation/Dev/Old GScript|Old GScript]]) and has since kept up with improvements to the game engine and can now be used for pretty sophisticated scripts that greatly customise the gaming experience.

It is used, with minor differences, for [[Clientside]] tasks like [[GUI | GUI programming]], special effects with nifty 3d lighting and custom [[NPC weapon|NPC Weapons]] or "engines", and [[Serverside]] systems like player housing, complex baddies or pets.

GScript can be discussed in the non-official [[GScript IRC channel]].

'''If you would like to contribute to the GraalBible's GScript documentation, you might want to [[Creation/Dev/GScript/Contribute|read this article]].'''

In your scripting quest, you may find the following articles to be of use:

'''Basic information'''
* [[Creation/Dev/Script/Starting Guide|Starting Guide]]
* [[Creation/Dev/Script/Client|Functions, variables and objects (clientside)]]
* [[Creation/Dev/Script/Client/GuiControls_List|GUI Controls]]

'''Specific Features'''
* [[Creation/Dev/GS1_To_GS2|GS1 To GS2: Guide for fixing scripts to work with the new engine]]
* [[Particle Engine|Particle Engine]]
* [[Creation/Dev/Graal v4 IRC|Graal IRC Scripting: Graal IRC Scripting Reference]]
* [[Creation/Dev/Troubleshooting Graal v4 IRC|Graal IRC Scripting: Troubleshooting Scripting Reference]]
* [[Creation/Dev/Output Methods|Output methods]]
* [[Creation/Dev/Using Classes Effectively|Use of classes]]
* [[Creation/Dev/GScript/Understanding GUI Profiles|GUI Features: Understanding GUI profiles]]
* [[Creation/Dev/GScript/Constants|Constants]]

'''Tutorials'''
* [[Creation/Dev/Creating Tabbed Window Panes|Creating Tabbed Window Panes]]
* [[Creation/Dev/Database_Communication|Indexed Database Communication]]
* [[Creation/Dev/Excalibur's scripting guide|Excalibur's Scripting Guide]]
'''Script Functions'''

These are frequently updated, to get the latest list run Graal with the -listscriptfunctions option:
* [[Creation/Dev/Script/Clientside_Functions|Client side]]
* [[Creation/Dev/Script Functions: NPC Server|Server side]]

[[Creation/Dev/Script/Index|Related Artices]]

Creation/Dev/GScript

2006-10-07T15:37:58Z

Excaliber7388:

'''GScript''' is [[Graal]]'s scripting language.

Its syntax and some of its semantics might seem familiar to those who program in [[WikiPedia:C (Programming Language) |C]] or [[WikiPedia:Java_programming_language|Java]]. In some ways it is more dynamic, e.g. supporting dynamicly joining and leaving of classes, and brings support for easy management of online game content.

GScript started as a very limited language ([[Creation/Dev/Old GScript|Old GScript]]) and has since kept up with improvements to the game engine and can now be used for pretty sophisticated scripts that greatly customise the gaming experience.

It is used, with minor differences, for [[Clientside]] tasks like [[GUI | GUI programming]], special effects with nifty 3d lighting and custom [[NPC weapon|NPC Weapons]] or "engines", and [[Serverside]] systems like player housing, complex baddies or pets.

GScript can be discussed in the non-official [[GScript IRC channel]].

'''If you would like to contribute to the GraalBible's GScript documentation, you might want to [[Creation/Dev/GScript/Contribute|read this article]].'''

In your scripting quest, you may find the following articles to be of use:

'''Basic information'''
* [[Creation/Dev/Script/Starting Guide|Starting Guide]]
* [[Creation/Dev/Script/Client|Functions, variables and objects (clientside)]]
* [[Creation/Dev/Script/Client/GuiControls_List|GUI Controls]]

'''Specific Features'''
* [[Creation/Dev/GS1_To_GS2|GS1 To GS2: Guide for fixing scripts to work with the new engine]]
* [[Particle Engine|Particle Engine]]
* [[Creation/Dev/Graal v4 IRC|Graal IRC Scripting: Graal IRC Scripting Reference]]
* [[Creation/Dev/Troubleshooting Graal v4 IRC|Graal IRC Scripting: Troubleshooting Scripting Reference]]
* [[Creation/Dev/Output Methods|Output methods]]
* [[Creation/Dev/Using Classes Effectively|Use of classes]]
* [[Creation/Dev/GScript/Understanding GUI Profiles|GUI Features: Understanding GUI profiles]]
* [[Creation/Dev/GScript/Constants|Constants]]

'''Tutorials'''
* [[Creation/Dev/Creating Tabbed Window Panes|Creating Tabbed Window Panes]]
* [[Creation/Dev/Database_Communication|Indexed Database Communication]]
* [[Excalibur's scripting guide|Excalibur's Scripting Guide]]
'''Script Functions'''

These are frequently updated, to get the latest list run Graal with the -listscriptfunctions option:
* [[Creation/Dev/Script/Clientside_Functions|Client side]]
* [[Creation/Dev/Script Functions: NPC Server|Server side]]

[[Creation/Dev/Script/Index|Related Artices]]

Creation/Dev/Excalibur's scripting guide

2006-10-07T15:37:36Z

Excaliber7388:

== '''Excalibur's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow. This should help you get started out. I'm afraid it isn't complete and there are a few typos in it. I'm working on it.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

Creation/Dev/GScript

2006-10-07T15:37:15Z

Excaliber7388:

Worlds/Dark Rival

2006-10-07T14:59:26Z

Excaliber7388:

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:dr-ss.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
DR recently introduced an in game Computer for staff to test. Basically, it allows the players to send e-mails to each other, chat off the IRC, in game, go on the internet, and soon, play games. After a few days testing we will release it to the public (it will be released without games, however, you will receive a freebie or two automatically, and most you will have to buy). Start saving your money up!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now. For the longest time, Dark Rival was one of the fastest growing servers around. However, due to popularity, lack of staff activity, and a slow internet connection on the owner's part, the server was shut down. Excaliber has decided to start on another server, Legend, but it's progress may be slow due to the lack of a new offline editor, and a slow internet connection.
[[Image:pic_darkrivalgui.png|thumb|center|175px]]
[[Image:darkrival_wiki.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Wood Chopping'''
-Help an elderly man build his lodge by chopping and delivering wood to him from the local area.
[[Image:wood.gif|thumb|left|150px]]

'''Soon to come'''

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (Admin)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps. We also could use someone who can convert normal levels into gmap format.
::LATs::

LATs, (Level Administration Team) would be responsible for the uploading, maintnence, and developement of levels. Currently, we are making a new overworld, so much of the work would go to making a unique world.

NATs, (NPC Administration Team) would be responsible for the uploading, maintnence, and creation of new and exciting scripts and NPCS. Dark Rival has many weapons, and unique systems, and the NAT's input is greatly appreciated.

GATs, (GFX Administration Team) would be responsibe for the uploading, maintnence, and creation of new, unique graphics.

The application is here: http://darkrivalonline.tripod.com/id9.html

== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

--[[User:Excaliber7388|Excaliber7388]] 00:13, 8 May 2006 (CEST)

File:Login server darkrival.png

2006-09-07T16:38:46Z

Excaliber7388:

Worlds/Dark Rival

2006-06-11T02:06:55Z

Excaliber7388:

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:dr-ss.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
DR recently introduced an in game Computer for staff to test. Basically, it allows the players to send e-mails to each other, chat off the IRC, in game, go on the internet, and soon, play games. After a few days testing we will release it to the public (it will be released without games, however, you will receive a freebie or two automatically, and most you will have to buy). Start saving your money up!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]
[[Image:darkrival_wiki.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Wood Chopping'''
-Help an elderly man build his lodge by chopping and delivering wood to him from the local area.
[[Image:wood.gif|thumb|left|150px]]

'''Soon to come'''

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (Admin)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps. We also could use someone who can convert normal levels into gmap format.
::LATs::

LATs, (Level Administration Team) would be responsible for the uploading, maintnence, and developement of levels. Currently, we are making a new overworld, so much of the work would go to making a unique world.

NATs, (NPC Administration Team) would be responsible for the uploading, maintnence, and creation of new and exciting scripts and NPCS. Dark Rival has many weapons, and unique systems, and the NAT's input is greatly appreciated.

GATs, (GFX Administration Team) would be responsibe for the uploading, maintnence, and creation of new, unique graphics.

The application is here: http://darkrivalonline.tripod.com/id9.html

== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

--[[User:Excaliber7388|Excaliber7388]] 00:13, 8 May 2006 (CEST)

File:Dr-ss.png

2006-06-11T02:06:22Z

Excaliber7388:

Worlds/Dark Rival

2006-05-21T21:42:49Z

Excaliber7388:

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
DR recently introduced an in game Computer for staff to test. Basically, it allows the players to send e-mails to each other, chat off the IRC, in game, go on the internet, and soon, play games. After a few days testing we will release it to the public (it will be released without games, however, you will receive a freebie or two automatically, and most you will have to buy). Start saving your money up!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]
[[Image:darkrival_wiki.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Wood Chopping'''
-Help an elderly man build his lodge by chopping and delivering wood to him from the local area.
[[Image:wood.gif|thumb|left|150px]]

'''Soon to come'''

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (Admin)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps. We also could use someone who can convert normal levels into gmap format.
::LATs::

LATs, (Level Administration Team) would be responsible for the uploading, maintnence, and developement of levels. Currently, we are making a new overworld, so much of the work would go to making a unique world.

NATs, (NPC Administration Team) would be responsible for the uploading, maintnence, and creation of new and exciting scripts and NPCS. Dark Rival has many weapons, and unique systems, and the NAT's input is greatly appreciated.

GATs, (GFX Administration Team) would be responsibe for the uploading, maintnence, and creation of new, unique graphics.

The application is here: http://darkrivalonline.tripod.com/id9.html

== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

--[[User:Excaliber7388|Excaliber7388]] 00:13, 8 May 2006 (CEST)

Worlds/Dark Rival

2006-05-10T19:12:34Z

Excaliber7388: /* '''About:''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]
[[Image:darkrival_wiki.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Wood Chopping'''
-Help an elderly man build his lodge by chopping and delivering wood to him from the local area.
[[Image:wood.gif|thumb|left|150px]]

'''Soon to come'''

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps. We also could use someone who can convert normal levels into gmap format.
::LATs::

LATs, (Level Administration Team) would be responsible for the uploading, maintnence, and developement of levels. Currently, we are making a new overworld, so much of the work would go to making a unique world.

NATs, (NPC Administration Team) would be responsible for the uploading, maintnence, and creation of new and exciting scripts and NPCS. Dark Rival has many weapons, and unique systems, and the NAT's input is greatly appreciated.

GATs, (GFX Administration Team) would be responsibe for the uploading, maintnence, and creation of new, unique graphics.

The application is here: http://darkrivalonline.tripod.com/id9.html

== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

--[[User:Excaliber7388|Excaliber7388]] 00:13, 8 May 2006 (CEST)

Worlds/Dark Rival

2006-05-07T22:13:44Z

Excaliber7388:

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!Also Look For Instruments!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]
[[Image:darkrival_wiki.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Wood Chopping'''
-Help an elderly man build his lodge by chopping and delivering wood to him from the local area.
[[Image:wood.gif|thumb|left|150px]]

'''Soon to come'''

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps. We also could use someone who can convert normal levels into gmap format.
::LATs::

LATs, (Level Administration Team) would be responsible for the uploading, maintnence, and developement of levels. Currently, we are making a new overworld, so much of the work would go to making a unique world.

NATs, (NPC Administration Team) would be responsible for the uploading, maintnence, and creation of new and exciting scripts and NPCS. Dark Rival has many weapons, and unique systems, and the NAT's input is greatly appreciated.

GATs, (GFX Administration Team) would be responsibe for the uploading, maintnence, and creation of new, unique graphics.

The application is here: http://darkrivalonline.tripod.com/id9.html

== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

--[[User:Excaliber7388|Excaliber7388]] 00:13, 8 May 2006 (CEST)

Worlds/Dark Rival

2006-05-07T22:11:17Z

Excaliber7388: /* '''Hiring!''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!Also Look For Instruments!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]
[[Image:darkrival_wiki.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Wood Chopping'''
-Help an elderly man build his lodge by chopping and delivering wood to him from the local area.
[[Image:wood.gif|thumb|left|150px]]

'''Soon to come'''

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps. We also could use someone who can convert normal levels into gmap format.
::LATs::

LATs, (Level Administration Team) would be responsible for the uploading, maintnence, and developement of levels. Currently, we are making a new overworld, so much of the work would go to making a unique world.

NATs, (NPC Administration Team) would be responsible for the uploading, maintnence, and creation of new and exciting scripts and NPCS. Dark Rival has many weapons, and unique systems, and the NAT's input is greatly appreciated.

GATs, (GFX Administration Team) would be responsibe for the uploading, maintnence, and creation of new, unique graphics.

The application is here: http://darkrivalonline.tripod.com/id9.html

== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

Worlds/Dark Rival

2006-05-07T22:06:34Z

Excaliber7388: /* '''Current staff:''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!Also Look For Instruments!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]
[[Image:darkrival_wiki.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Wood Chopping'''
-Help an elderly man build his lodge by chopping and delivering wood to him from the local area.
[[Image:wood.gif|thumb|left|150px]]

'''Soon to come'''

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps.
The application is here: http://darkrivalonline.tripod.com/id9.html
== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

Worlds/Dark Rival

2006-05-07T22:06:18Z

Excaliber7388:

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!Also Look For Instruments!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]
[[Image:darkrival_wiki.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Wood Chopping'''
-Help an elderly man build his lodge by chopping and delivering wood to him from the local area.
[[Image:wood.gif|thumb|left|150px]]

'''Soon to come'''

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps.
The application is here: http://darkrivalonline.tripod.com/id9.html
== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

Worlds/Dark Rival

2006-05-07T22:05:44Z

Excaliber7388: /* '''Jobs:''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!Also Look For Instruments!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]
[[Image:darkrival_wiki.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Wood Chopping'''
-Help an elderly man build his lodge by chopping and delivering wood to him from the local area.
[[Image:wood.gif|thumb|left|150px]]

'''Soon to come'''

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps.
The application is here: http://darkrivalonline.tripod.com/id9.html
== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

File:Wood.gif

2006-05-07T22:04:40Z

Excaliber7388:

Talk:Creation/Dev/Script/Client

2006-04-12T23:56:45Z

Excaliber7388:

I need help with a new system I'm making for my server, I've posted some info on the forums, but it hasn't gotten replys, and I'm stumped. Here's the forums site, it would mean a lot to me if someone could help me out a bit, thanks!!!
http://forums.graalonline.com/forums/showthread.php?t=65330

Worlds/Dark Rival

2006-04-03T13:53:36Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!Also Look For Instruments!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]
[[Image:darkrival_wiki.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Soon to come'''

-Wood chopping

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps.
The application is here: http://darkrivalonline.tripod.com/id9.html
== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onActiontouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time++;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
wile(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other rational expressions you may use. (Well, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEEDS to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

Now, back to the 'for' loop.
This a very interesting loop it's format is as follows:
<pre>
for(command;expression;command)
{
}
</pre>
Here's an example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
for(this.i=0;this.i<10;this.i++)
{
chat="Loops: " @this.i;
sleep(.5);
}
}
</pre>
This loop would be activated when the player touchs it.
It would go through 10 loops, displaying the count, and taking .5 seconds for each loop (due to the sleep() command)
Now remember this while loop?
<pre>
function onCreated()
{
this.size=10;
}
while(this.size<=20)
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
There's an easier way of doing it with a for loop, in fact all loops done with wile can be replaced by for.
<pre>
for(this.size=10;this.size<=20;this.size++)
{
chat="The fish was " @this.size@ " centimeters long!";
sleep(.5);
}
</pre>
See? Much shorter and easier to use!
Once you know the format of a for loop, you can make longer and more complex loops as well, and they'll take less time to script, which is always a bonus.

Some more detail on actions:
An action is an effective way to use a portion of script more than once, have one script act on another script, more script to serverside from clientside (and the other way) and more.
So how do you use them? Here's the format:
<pre>
triggeraction(x,y,"params[0]","params[1]");
</pre>
You must have two parameters, but you can have as many as you want a quick example:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontrigger()
{
player.chat="Account: " @params[1]@ " Sword " @params[2]@ " head: " @params[3];
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="Who am I?") //amnesia? multiple identities?
{
triggeraction(x,y,"trigger",player.account,player.swordimg,player.headimg);
}
}
</pre>
See? You can make more than one parameter.
Now, there are a few differences between a level NPC with a triggeraction, and a weapon with a triggeraction. Weapons need their location (serverside or clientside) as the first parameter, params[0] is the one after it. Here, you can have just one parameter, and the x and y is always 0 (because the npc server is at 0,0), and you need to include the name of the weapon in the action.
here's an example:
<pre>
//weapon script with a triggeraction
//Weapon name: Fire Ball
function onActionserverside()
{
if(params[0]=="mp")
{
playermp-=10
}
}
//#CLIENTSIDE
function onWeaponfired()
{
if(playermp>=10)
{
shootfireball(playerdir);
triggeraction(0,0,"serverside","Fireball","mp");
}
else
{
player.chat="Not enough mp!";
}
}
</pre>
This nifty little weapon will cost 10 mp per use, and fires a fireball in the direction the player is facing. Hopefully, you can learn to make many weapons of your own!
Triggeractions can be used in shops as well (and these are the scripts people ask for the most).
<pre>
//a shop script, yay!
function onCreated()
{
setshape 1,32,32;
}
function onActionbuy()
{
if(playerrupees>=100)
{
addweapon Fire Ball;
playerrupees-=100;
}
}
//#CLIENTSIDE
function onPlayerchats()
{
if(player.chat=="buy fire ball")
{
triggeraction(x,y,"buy","buy");
//the level npc triggeraction type
}
}
</pre>
There, now you can make a little shop that sells a Fire Ball weapon. Have fun with it, search the commands, there's plenty of easy weapons you can make, and the weapon script is easy to follow and modify as well. Hopefully, you know enough about parameters to make more than one weapon for sale in the same NPC, just make the weapon name part of the action, then check for that parameter before they can buy.
Now there are other types of loops. One I commonly see is a timeout loop. You should understand why. Back with GS1, it was a bit easier to tell what was happening in the script. In GS1 the script for function onTimeout() would be displayed as if(timeout). It was a bit easier to tell that when a timeout was done, it set a flag that if(timeout) would check. function onTimeout does the same thing, however, for new users this may be harder to tell. here's an example of an NPC that uses a timeout loop:
<pre>
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
player.chat="Counter: " @this.time;
this.time++;
settimer(1);
//after 1 second, the timeout loop will restart
}
</pre>
This would cause the player to count up every second.
You may have noticed that the variables often start of with client. or this. There are actually a few prefixes, each does a different thing:
<pre>
client. variable is saved to the client, it can be modified on the clientside or serverside, and read from either.
clientr. variables can be rad from server or clientside, but only written from serverside. This is more secure, but only if you use it right.
server. variables are saved to the server, can only be written on the serverside, read on either side
serverr. more secure version of server. read only on clientside
this. is a variable that only functions in the NPC it is in. This prevents NPCs from morifying each others variables
temp. only exists in between the brackets of a function
</pre>
To use scripts effectivly, you should know how to use each of these.
I will add more over time.

Some important commands can be found here:
page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
Which is also helpful for learning how to script. Enjoy!

Worlds/Dark Rival

2006-03-31T20:48:18Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-30T22:44:16Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-30T17:32:22Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-29T14:46:43Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-29T03:06:49Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-28T20:43:16Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-28T20:42:22Z

Excaliber7388: /* Old script compatibility */

Worlds/Dark Rival

2006-03-28T20:41:53Z

Excaliber7388: /* '''Jobs:''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Soon to come'''

-Wood chopping

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps.
The application is here: http://darkrivalonline.tripod.com/id9.html
== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onTouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time+=1;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
with(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other ration expressios you may use. (Hell, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEED to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

I will add more over time.

Note: if you know gs1, gs2 is easy to learn, below is a list of commands in their old form and their new format, on the right. You can also use this list to learn the commands. This is taken from this page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
which is also helpful for learning how to script. Enjoy!
== Old script compatibility ==

=== Removed functionality ===
<pre>
- toinventory
- followplayer
- playersays()
- setbackpal
</pre>
=== Supported old scripting commands and their mapping to new script ===
<pre>
addstring oldstring, oldstring;
list.add(string);
addtiledef oldstring, oldstring, float;
addtiledef(string,string,float);
addtiledef2 oldstring, oldstring, float, float;
addtiledef2(string,string,float,float);
attachplayertoobj float, float;
attachplayertoobj(float,float);
blockagain;
blockagain();
blockagainlocal;
blockagainlocal();
callnpc float, oldstring;
callnpc(float,string);
callweapon float, oldstring;
callweapon(float,string);
canbecarried;
canbecarried();
canbepulled;
canbepulled();
canbepushed;
canbepushed();
cannotbecarried;
cannotbecarried();
cannotbepulled;
cannotbepulled();
cannotbepushed;
cannotbepushed();
canwarp;
canwarp();
canwarp2;
canwarp2();
carryobject oldstring;
carryobject(string);
changeimgcolors float, float, float, float, float;
changeimgcolors(float,float,float,float,float);
changeimgmode float, float;
changeimgmode(float,float);
changeimgpart float, float, float, float, float;
changeimgpart(float,float,float,float,float);
changeimgvis float, float;
changeimgvis(float,float);
changeimgzoom float, float;
changeimgzoom(float,float);
deletestring oldstring, float;
deletestring(string,float);
destroy;
destroy();
detachplayer;
detachplayer();
disabledefmovement;
disabledefmovement();
disablemap;
disablemap();
disablepause;
disablepause();
disableselectweapons;
disableselectweapons();
disableweapons;
disableweapons();
dontblock;
dontblock();
dontblocklocal;
dontblocklocal();
drawaslight;
drawaslight();
drawoverplayer;
drawoverplayer();
drawunderplayer;
drawunderplayer();
enabledefmovement;
enabledefmovement();
enablefeatures float;
enablefeatures(float);
enablemap;
enablemap();
enablepause;
enablepause();
enableselectweapons;
enableselectweapons();
enableweapons;
enableweapons();
explodebomb float;
explodebomb(float);
followplayer;
followplayer();
freezeplayer float;
freezeplayer(float);
freezeplayer2;
freezeplayer2();
hide;
hide();
hideimg float;
hideimg(float);
hideimgs float, float;
hideimgs(float,float);
hidelocal;
hidelocal();

hitcompu float, float, float, float;
hitcompu(float,float,float,float);
hitnpc float, float, float, float;
hitnpc(float,float,float,float);
hitobjects float, float, float;
hitobjects(float,float,float);
hideplayer float;
hideplayer(float);
hidesword float;
hidesword(float);
hitplayer float, float, float, float;
hitplayer(float,float,float,float);
hurt float;
hurt(float);
insertstring oldstring, float, oldstring;
insertstring(string,float,string);
join oldstring;
join(string);
lay oldstring;
lay(string);
lay2 oldstring, float, float;
lay2(string,float,float);
loadmap oldstring;
loadmap(string);
message oldstring;
message(string);
move float, float, float, float;
move(float,float,float,float);
noplayerkilling;
noplayerkilling();
openurl oldstring;
openurl(string);
openurl2 oldstring, float, float;
openurl2(string,float,float);
play oldstring;
play(string);
play2 oldstring, float, float, float;
play2(string,float,float,float);
playlooped oldstring;
playlooped(string);
putbomb float, float, float;
putbomb(float,float,float);
putcomp oldstring, float, float;
putcomp(string,float,float);
putexplosion float, float, float;
putexplosion(float,float,float);
putexplosion2 float, float, float, float;
putexplosion2(float,float,float,float);
puthorse oldstring, float, float;
puthorse(string,float,float);
putleaps float, float, float;
putleaps(float,float,float);
putnewcomp oldstring, float, float, oldstring, float;
putnewcomp(string,float,float,string,float);
putnpc oldstring, oldstring, float, float;
putnpc(string,string,float,float);
putnpc2 float, float, oldstring;
putnpc2(float,float,string);
reflectarrow float;
reflectarrow(float);
removearrow float;
removearrow(float);
removebomb float;
removebomb(float);
removecompus;
removecompus();
removeexplo float;
removeexplo(float);
removehorse float;
removehorse(float);
rmeoveitem float;
removeitem(float)
removestring oldstring, oldstring;
removestring(string,string);
removetiledefs oldstring;
removetiledefs(string);
replaceani oldstring, oldstring;
replaceani(string,string);
replacestring oldstring, float, oldstring;
replacestring(string,float,string);
resetfocus;
resetfocus();
savelog oldstring;
savelog(string);
savelog2 oldstring, oldstring;
savelog2(string,string);
say float;
say(float);
say2 oldstring;
say2(string);
sendrpgmessage oldstring;
sendrpgmessage(string);
sendpm oldstring;
sendpm(string);
sendtonc oldstring;
sendtonc(string);
sendtorc oldstring;
sendtorc(string);
serverwarp oldstring;
serverwarp(string);
set oldstring;
set(string);
setani oldstring, oldstring;
setani(string,string);
setarray float, float;
setarray(var,float);
setbeltcolor oldstring;
setbeltcolor(string);
setbow oldstring;
setbow(string);
setcharani oldstring, oldstring;
setcharani(string,string);
setchargender oldstring;
setchargender(string);
setcharprop oldstring, oldstring;
string = string;
setcoatcolor oldstring;
setcoatcolor(string);
setcoloreffect float, float, float, float;
setcoloreffect(float,float,float,float);
setcursor float;
setcursor(float);
setcurcor2 oldstring;
setcursor2(string);
seteffect float, float, float, float;
seteffect(float,float,float,float);
seteffectmode float;
seteffectmode(float);
setfocus float, float;
setfocus(float,float);
setgender oldstring;
setgender(string);
sethead oldstring;
sethead(string);
setlevel oldstring;
setlevel(string);
setlevel2 oldstring, float, float;
setlevel2(string,float,float);
setmap oldstring, oldstring, float, float;
setmap(string,string,float,float);
setminimap oldstring, oldstring, float, float;
setminimap(string,string,float,float);
setmusicvolume float, float;
setmusicvolume(float,float);
setimg oldstring;
setimg(string);
setimgpart oldstring, float, float, float, float;
setimgpart(string,float,float,float,float);
setletters oldstring;
setletters(string);
setplayerdir oldstring;
setplayerdir(string);
setplayerprop oldstring, oldstring;
string = string;
setpm oldstring;
setpm(string);
setshape float, float, float;
setshape(float,float,float);
setshape2 float, float, float;
setshape2(float,float,float);
setshield oldstring, float;
setshield(string,float);
setshoecolor oldstring;
setshoecolor(string);
setshootparams oldstring;
setshootparams(string);
setskincolor oldstring;
setskincolor(string);
setsleevecolor oldstring;
setsleevecolor(string);
setstring oldstring, oldstring;
setstring(string,string);
setsword oldstring, float;
setsword(string,float);
seturllevel oldstring;
seturllevel(string);
setz float, float, float, float, float, float, float, float;
setz(float,float,float,float,float,float,float,float);
setzoomeffect float;
setzoomeffect(float);
shoot float, float, float, float, float, float, oldstring, oldstring;
shoot(float,float,float,float,float,float,string,string);
shootarrow float;
shootarrow(float);
shootball;
shootball();
shootfireball float;
shootfireball(float);
shootfireblast float;
shootfireblast(float);
shootnuke float;
shootnuke(float);
show;
show();
showani float, float, float, float, oldstring;
showani(float,float,float,float,string);
showani2 float, float, float, float, float, oldstring;
showani2(float,float,float,float,float,string);
showcharacter;
showcharacter();
showfile oldstring;
showfile(string);
showimg float, oldstring, float, float;
showimg(float,string,float,float);
showimg2 float, oldstring, float, float, float;
showimg2(float,string,float,float,float);
showlocal;
showlocal();

showpoly float, float;
showpoly(float,array);
showpoly2 float, float;
showpoly2(float,array);
showstats float;
showstats(float);
showtext float, float, float, oldstring, oldstring, oldstring;
showtext(float,float,float,string,string,string);
showtext2 float, float, float, float, oldstring, oldstring, oldstring;
showtext2(float,float,float,float,string,string,string);
sleep float;
sleep(float);
spyfire float, float;
spyfire(float,float);
stopmidi;
stopmidi();
stopsound oldstring;
stopsound(string);
take oldstring;
take(string);
take2 float;
take2(float);
takehorse float;
takehorse(float);
takeplayercarry;
takeplayercarry();
takeplayerhorse;
takeplayerhorse();
throwcarry;
throwcarry();
timereverywhere;
timereverywhere();
timershow;
timershow();
toinventory oldstring;
toinventory(string);
tokenize oldstring;
tokens = string.tokenize();
tokenize2 oldstring, oldstring;
tokens = string.tokenize(" ," @ string);
toweapons oldstring;
toweapons(string);
triggeraction float, float, oldstring, oldstring;
triggeraction(float,float,string,string);
unfreezeplayer;
unfreezeplayer();
unset oldstring;
unset(string);
updateboard float, float, float, float;
updateboard(float,float,float,float);
updateterrain;
updateterrain();
wraptext float, oldstring, oldstring;
tokens = wraptext(float," ," @ string,string);
wraptext2 float, float, oldstring, oldstring;
tokens = wraptext2(float,float," ," @ string,string);
</pre>

=== Supported old string operations ===
<pre>
These old string operators can be used in string parameters
for the old commands, also you can use them directly as operators, e.g.
#c = "hello"
is actually doing
player.chat = "hello"

#a player.account
#a(float) players[float].account
#m player.ani
ani
#m(float) players[float].ani
#K(float) char(float)
#8 player.bodyimg
bodyimg
#8(float) players[float].bodyimg
#c player.chat
chat
#c(float) players[float].chat
#C0 player.colors[0]
colors[0]
#C0(float) players[float].colors[0]
#C1 player.colors[1]
colors[1]
#C1(float) players[float].colors[1]
#C2 player.colors[2]
colors[2]
#C2(float) players[float].colors[2]
#C3 player.colors[3]
colors[3]
#C3(float) players[float].colors[3]
#C4 player.colors[4]
colors[4]
#C4(float) players[float].colors[4]
#C5 player.colors[5]
colors[5]
#C5(float) players[float].colors[5]
#D downloadfile()
#E emoticonchar()
#e(float,float,oldstring)
string.substring(float,float)
#g player.guild
guild
#g(float) players[float].guild
#3 player.headimg
headimg
#3(float) players[float].headimg
#5 player.horseimg
horseimg
#5(float) players[float].horseimg
#k(float) keyname(float)
#L player.level
#I(oldstring,float)
getstring(string)[float]
#n player.nick
nick
#n(float) players[float].nick
#f image
#f(float) npcs[float].image
#F level
#p(float) params[float]
#P(float) player.attr[float]
attr[float]
#P(float_1,float_2)
players[float_2].attr[float_1]
#P1 player.attr[1]
attr[1]
#P1(float) players[float].attr[1]
#P2 player.attr[2]
attr[2]
#P2(float) players[float].attr[2]
#P3 player.attr[3]
attr[3]
#P3(float) players[float].attr[3]
#P4 player.attr[4]
attr[4]
#P4(float) players[float].attr[4]
#P5 player.attr[5]
attr[5]
#P5(float) players[float].attr[5]
#P6 player.attr[6]
attr[6]
#P6(float) players[float].attr[6]
#P7 player.attr[7]
attr[7]
#P7(float) players[float].attr[7]
#P8 player.attr[8]
attr[8]
#P8(float) players[float].attr[8]
#P9 player.attr[9]
attr[9]
#P9(float) players[float].attr[9]
#R(oldstring) string.random()
#2 player.shieldimg
shieldimg
#2(float) players[float].shieldimg
#s(oldstring) getstring(string)
#1 player.swordimg
swordimg
#1(float) players[float].swordimg
#S player.sword.script
#t(float) tokens[float]
#T(oldstring) string.trim()
#v(float) float
#W player.weapon.image
#W(float) weapons[float].image
#w player.weapon.name
#w(float) weapons[float].name
</pre>
Compatibility note:
When you use the command setcharprop then the first parameter
is handled differently: instead of changing 'player.chat' it
is changing 'chat', the chat text of the npc. So 'setcharprop #c,hello'
would be translated into
chat = "hello"
while 'setplayerprop #c,hello' is translated into
player.chat = "hello"
In the list above both possibilities are listed.

Worlds/Dark Rival

2006-03-28T20:41:24Z

Excaliber7388: /* '''Jobs:''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Soon to come'''

-Wood chopping

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps.
The application is here: http://darkrivalonline.tripod.com/id9.html
== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onTouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time+=1;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
with(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other ration expressios you may use. (Hell, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEED to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

I will add more over time.

Note: if you know gs1, gs2 is easy to learn, below is a list of commands in their old form and their new format, on the right. You can also use this list to learn the commands. This is taken from this page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
which is also helpful for learning how to script. Enjoy!
== Old script compatibility ==

=== Removed functionality ===
<pre>
- toinventory
- followplayer
- playersays()
- setbackpal
</pre>
=== Supported old scripting commands and their mapping to new script ===
<pre>
addstring oldstring, oldstring;
list.add(string);
addtiledef oldstring, oldstring, float;
addtiledef(string,string,float);
addtiledef2 oldstring, oldstring, float, float;
addtiledef2(string,string,float,float);
attachplayertoobj float, float;
attachplayertoobj(float,float);
blockagain;
blockagain();
blockagainlocal;
blockagainlocal();
callnpc float, oldstring;
callnpc(float,string);
callweapon float, oldstring;
callweapon(float,string);
canbecarried;
canbecarried();
canbepulled;
canbepulled();
canbepushed;
canbepushed();
cannotbecarried;
cannotbecarried();
cannotbepulled;
cannotbepulled();
cannotbepushed;
cannotbepushed();
canwarp;
canwarp();
canwarp2;
canwarp2();
carryobject oldstring;
carryobject(string);
changeimgcolors float, float, float, float, float;
changeimgcolors(float,float,float,float,float);
changeimgmode float, float;
changeimgmode(float,float);
changeimgpart float, float, float, float, float;
changeimgpart(float,float,float,float,float);
changeimgvis float, float;
changeimgvis(float,float);
changeimgzoom float, float;
changeimgzoom(float,float);
deletestring oldstring, float;
deletestring(string,float);
destroy;
destroy();
detachplayer;
detachplayer();
disabledefmovement;
disabledefmovement();
disablemap;
disablemap();
disablepause;
disablepause();
disableselectweapons;
disableselectweapons();
disableweapons;
disableweapons();
dontblock;
dontblock();
dontblocklocal;
dontblocklocal();
drawaslight;
drawaslight();
drawoverplayer;
drawoverplayer();
drawunderplayer;
drawunderplayer();
enabledefmovement;
enabledefmovement();
enablefeatures float;
enablefeatures(float);
enablemap;
enablemap();
enablepause;
enablepause();
enableselectweapons;
enableselectweapons();
enableweapons;
enableweapons();
explodebomb float;
explodebomb(float);
followplayer;
followplayer();
freezeplayer float;
freezeplayer(float);
freezeplayer2;
freezeplayer2();
hide;
hide();
hideimg float;
hideimg(float);
hideimgs float, float;
hideimgs(float,float);
hidelocal;
hidelocal();

hitcompu float, float, float, float;
hitcompu(float,float,float,float);
hitnpc float, float, float, float;
hitnpc(float,float,float,float);
hitobjects float, float, float;
hitobjects(float,float,float);
hideplayer float;
hideplayer(float);
hidesword float;
hidesword(float);
hitplayer float, float, float, float;
hitplayer(float,float,float,float);
hurt float;
hurt(float);
insertstring oldstring, float, oldstring;
insertstring(string,float,string);
join oldstring;
join(string);
lay oldstring;
lay(string);
lay2 oldstring, float, float;
lay2(string,float,float);
loadmap oldstring;
loadmap(string);
message oldstring;
message(string);
move float, float, float, float;
move(float,float,float,float);
noplayerkilling;
noplayerkilling();
openurl oldstring;
openurl(string);
openurl2 oldstring, float, float;
openurl2(string,float,float);
play oldstring;
play(string);
play2 oldstring, float, float, float;
play2(string,float,float,float);
playlooped oldstring;
playlooped(string);
putbomb float, float, float;
putbomb(float,float,float);
putcomp oldstring, float, float;
putcomp(string,float,float);
putexplosion float, float, float;
putexplosion(float,float,float);
putexplosion2 float, float, float, float;
putexplosion2(float,float,float,float);
puthorse oldstring, float, float;
puthorse(string,float,float);
putleaps float, float, float;
putleaps(float,float,float);
putnewcomp oldstring, float, float, oldstring, float;
putnewcomp(string,float,float,string,float);
putnpc oldstring, oldstring, float, float;
putnpc(string,string,float,float);
putnpc2 float, float, oldstring;
putnpc2(float,float,string);
reflectarrow float;
reflectarrow(float);
removearrow float;
removearrow(float);
removebomb float;
removebomb(float);
removecompus;
removecompus();
removeexplo float;
removeexplo(float);
removehorse float;
removehorse(float);
rmeoveitem float;
removeitem(float)
removestring oldstring, oldstring;
removestring(string,string);
removetiledefs oldstring;
removetiledefs(string);
replaceani oldstring, oldstring;
replaceani(string,string);
replacestring oldstring, float, oldstring;
replacestring(string,float,string);
resetfocus;
resetfocus();
savelog oldstring;
savelog(string);
savelog2 oldstring, oldstring;
savelog2(string,string);
say float;
say(float);
say2 oldstring;
say2(string);
sendrpgmessage oldstring;
sendrpgmessage(string);
sendpm oldstring;
sendpm(string);
sendtonc oldstring;
sendtonc(string);
sendtorc oldstring;
sendtorc(string);
serverwarp oldstring;
serverwarp(string);
set oldstring;
set(string);
setani oldstring, oldstring;
setani(string,string);
setarray float, float;
setarray(var,float);
setbeltcolor oldstring;
setbeltcolor(string);
setbow oldstring;
setbow(string);
setcharani oldstring, oldstring;
setcharani(string,string);
setchargender oldstring;
setchargender(string);
setcharprop oldstring, oldstring;
string = string;
setcoatcolor oldstring;
setcoatcolor(string);
setcoloreffect float, float, float, float;
setcoloreffect(float,float,float,float);
setcursor float;
setcursor(float);
setcurcor2 oldstring;
setcursor2(string);
seteffect float, float, float, float;
seteffect(float,float,float,float);
seteffectmode float;
seteffectmode(float);
setfocus float, float;
setfocus(float,float);
setgender oldstring;
setgender(string);
sethead oldstring;
sethead(string);
setlevel oldstring;
setlevel(string);
setlevel2 oldstring, float, float;
setlevel2(string,float,float);
setmap oldstring, oldstring, float, float;
setmap(string,string,float,float);
setminimap oldstring, oldstring, float, float;
setminimap(string,string,float,float);
setmusicvolume float, float;
setmusicvolume(float,float);
setimg oldstring;
setimg(string);
setimgpart oldstring, float, float, float, float;
setimgpart(string,float,float,float,float);
setletters oldstring;
setletters(string);
setplayerdir oldstring;
setplayerdir(string);
setplayerprop oldstring, oldstring;
string = string;
setpm oldstring;
setpm(string);
setshape float, float, float;
setshape(float,float,float);
setshape2 float, float, float;
setshape2(float,float,float);
setshield oldstring, float;
setshield(string,float);
setshoecolor oldstring;
setshoecolor(string);
setshootparams oldstring;
setshootparams(string);
setskincolor oldstring;
setskincolor(string);
setsleevecolor oldstring;
setsleevecolor(string);
setstring oldstring, oldstring;
setstring(string,string);
setsword oldstring, float;
setsword(string,float);
seturllevel oldstring;
seturllevel(string);
setz float, float, float, float, float, float, float, float;
setz(float,float,float,float,float,float,float,float);
setzoomeffect float;
setzoomeffect(float);
shoot float, float, float, float, float, float, oldstring, oldstring;
shoot(float,float,float,float,float,float,string,string);
shootarrow float;
shootarrow(float);
shootball;
shootball();
shootfireball float;
shootfireball(float);
shootfireblast float;
shootfireblast(float);
shootnuke float;
shootnuke(float);
show;
show();
showani float, float, float, float, oldstring;
showani(float,float,float,float,string);
showani2 float, float, float, float, float, oldstring;
showani2(float,float,float,float,float,string);
showcharacter;
showcharacter();
showfile oldstring;
showfile(string);
showimg float, oldstring, float, float;
showimg(float,string,float,float);
showimg2 float, oldstring, float, float, float;
showimg2(float,string,float,float,float);
showlocal;
showlocal();

showpoly float, float;
showpoly(float,array);
showpoly2 float, float;
showpoly2(float,array);
showstats float;
showstats(float);
showtext float, float, float, oldstring, oldstring, oldstring;
showtext(float,float,float,string,string,string);
showtext2 float, float, float, float, oldstring, oldstring, oldstring;
showtext2(float,float,float,float,string,string,string);
sleep float;
sleep(float);
spyfire float, float;
spyfire(float,float);
stopmidi;
stopmidi();
stopsound oldstring;
stopsound(string);
take oldstring;
take(string);
take2 float;
take2(float);
takehorse float;
takehorse(float);
takeplayercarry;
takeplayercarry();
takeplayerhorse;
takeplayerhorse();
throwcarry;
throwcarry();
timereverywhere;
timereverywhere();
timershow;
timershow();
toinventory oldstring;
toinventory(string);
tokenize oldstring;
tokens = string.tokenize();
tokenize2 oldstring, oldstring;
tokens = string.tokenize(" ," @ string);
toweapons oldstring;
toweapons(string);
triggeraction float, float, oldstring, oldstring;
triggeraction(float,float,string,string);
unfreezeplayer;
unfreezeplayer();
unset oldstring;
unset(string);
updateboard float, float, float, float;
updateboard(float,float,float,float);
updateterrain;
updateterrain();
wraptext float, oldstring, oldstring;
tokens = wraptext(float," ," @ string,string);
wraptext2 float, float, oldstring, oldstring;
tokens = wraptext2(float,float," ," @ string,string);
</pre>

=== Supported old string operations ===
<pre>
These old string operators can be used in string parameters
for the old commands, also you can use them directly as operators, e.g.
#c = "hello"
is actually doing
player.chat = "hello"

#a player.account
#a(float) players[float].account
#m player.ani
ani
#m(float) players[float].ani
#K(float) char(float)
#8 player.bodyimg
bodyimg
#8(float) players[float].bodyimg
#c player.chat
chat
#c(float) players[float].chat
#C0 player.colors[0]
colors[0]
#C0(float) players[float].colors[0]
#C1 player.colors[1]
colors[1]
#C1(float) players[float].colors[1]
#C2 player.colors[2]
colors[2]
#C2(float) players[float].colors[2]
#C3 player.colors[3]
colors[3]
#C3(float) players[float].colors[3]
#C4 player.colors[4]
colors[4]
#C4(float) players[float].colors[4]
#C5 player.colors[5]
colors[5]
#C5(float) players[float].colors[5]
#D downloadfile()
#E emoticonchar()
#e(float,float,oldstring)
string.substring(float,float)
#g player.guild
guild
#g(float) players[float].guild
#3 player.headimg
headimg
#3(float) players[float].headimg
#5 player.horseimg
horseimg
#5(float) players[float].horseimg
#k(float) keyname(float)
#L player.level
#I(oldstring,float)
getstring(string)[float]
#n player.nick
nick
#n(float) players[float].nick
#f image
#f(float) npcs[float].image
#F level
#p(float) params[float]
#P(float) player.attr[float]
attr[float]
#P(float_1,float_2)
players[float_2].attr[float_1]
#P1 player.attr[1]
attr[1]
#P1(float) players[float].attr[1]
#P2 player.attr[2]
attr[2]
#P2(float) players[float].attr[2]
#P3 player.attr[3]
attr[3]
#P3(float) players[float].attr[3]
#P4 player.attr[4]
attr[4]
#P4(float) players[float].attr[4]
#P5 player.attr[5]
attr[5]
#P5(float) players[float].attr[5]
#P6 player.attr[6]
attr[6]
#P6(float) players[float].attr[6]
#P7 player.attr[7]
attr[7]
#P7(float) players[float].attr[7]
#P8 player.attr[8]
attr[8]
#P8(float) players[float].attr[8]
#P9 player.attr[9]
attr[9]
#P9(float) players[float].attr[9]
#R(oldstring) string.random()
#2 player.shieldimg
shieldimg
#2(float) players[float].shieldimg
#s(oldstring) getstring(string)
#1 player.swordimg
swordimg
#1(float) players[float].swordimg
#S player.sword.script
#t(float) tokens[float]
#T(oldstring) string.trim()
#v(float) float
#W player.weapon.image
#W(float) weapons[float].image
#w player.weapon.name
#w(float) weapons[float].name
</pre>
Compatibility note:
When you use the command setcharprop then the first parameter
is handled differently: instead of changing 'player.chat' it
is changing 'chat', the chat text of the npc. So 'setcharprop #c,hello'
would be translated into
chat = "hello"
while 'setplayerprop #c,hello' is translated into
player.chat = "hello"
In the list above both possibilities are listed.

Worlds/Dark Rival

2006-03-28T20:40:40Z

Excaliber7388:

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Soon to come'''

-Wood chopping

-Fighting

-Gardening

-Bounty Hunting

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps.
The application is here: http://darkrivalonline.tripod.com/id9.html
== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onTouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time+=1;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
with(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other ration expressios you may use. (Hell, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEED to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

I will add more over time.

Note: if you know gs1, gs2 is easy to learn, below is a list of commands in their old form and their new format, on the right. You can also use this list to learn the commands. This is taken from this page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
which is also helpful for learning how to script. Enjoy!
== Old script compatibility ==

=== Removed functionality ===
<pre>
- toinventory
- followplayer
- playersays()
- setbackpal
</pre>
=== Supported old scripting commands and their mapping to new script ===
<pre>
addstring oldstring, oldstring;
list.add(string);
addtiledef oldstring, oldstring, float;
addtiledef(string,string,float);
addtiledef2 oldstring, oldstring, float, float;
addtiledef2(string,string,float,float);
attachplayertoobj float, float;
attachplayertoobj(float,float);
blockagain;
blockagain();
blockagainlocal;
blockagainlocal();
callnpc float, oldstring;
callnpc(float,string);
callweapon float, oldstring;
callweapon(float,string);
canbecarried;
canbecarried();
canbepulled;
canbepulled();
canbepushed;
canbepushed();
cannotbecarried;
cannotbecarried();
cannotbepulled;
cannotbepulled();
cannotbepushed;
cannotbepushed();
canwarp;
canwarp();
canwarp2;
canwarp2();
carryobject oldstring;
carryobject(string);
changeimgcolors float, float, float, float, float;
changeimgcolors(float,float,float,float,float);
changeimgmode float, float;
changeimgmode(float,float);
changeimgpart float, float, float, float, float;
changeimgpart(float,float,float,float,float);
changeimgvis float, float;
changeimgvis(float,float);
changeimgzoom float, float;
changeimgzoom(float,float);
deletestring oldstring, float;
deletestring(string,float);
destroy;
destroy();
detachplayer;
detachplayer();
disabledefmovement;
disabledefmovement();
disablemap;
disablemap();
disablepause;
disablepause();
disableselectweapons;
disableselectweapons();
disableweapons;
disableweapons();
dontblock;
dontblock();
dontblocklocal;
dontblocklocal();
drawaslight;
drawaslight();
drawoverplayer;
drawoverplayer();
drawunderplayer;
drawunderplayer();
enabledefmovement;
enabledefmovement();
enablefeatures float;
enablefeatures(float);
enablemap;
enablemap();
enablepause;
enablepause();
enableselectweapons;
enableselectweapons();
enableweapons;
enableweapons();
explodebomb float;
explodebomb(float);
followplayer;
followplayer();
freezeplayer float;
freezeplayer(float);
freezeplayer2;
freezeplayer2();
hide;
hide();
hideimg float;
hideimg(float);
hideimgs float, float;
hideimgs(float,float);
hidelocal;
hidelocal();

hitcompu float, float, float, float;
hitcompu(float,float,float,float);
hitnpc float, float, float, float;
hitnpc(float,float,float,float);
hitobjects float, float, float;
hitobjects(float,float,float);
hideplayer float;
hideplayer(float);
hidesword float;
hidesword(float);
hitplayer float, float, float, float;
hitplayer(float,float,float,float);
hurt float;
hurt(float);
insertstring oldstring, float, oldstring;
insertstring(string,float,string);
join oldstring;
join(string);
lay oldstring;
lay(string);
lay2 oldstring, float, float;
lay2(string,float,float);
loadmap oldstring;
loadmap(string);
message oldstring;
message(string);
move float, float, float, float;
move(float,float,float,float);
noplayerkilling;
noplayerkilling();
openurl oldstring;
openurl(string);
openurl2 oldstring, float, float;
openurl2(string,float,float);
play oldstring;
play(string);
play2 oldstring, float, float, float;
play2(string,float,float,float);
playlooped oldstring;
playlooped(string);
putbomb float, float, float;
putbomb(float,float,float);
putcomp oldstring, float, float;
putcomp(string,float,float);
putexplosion float, float, float;
putexplosion(float,float,float);
putexplosion2 float, float, float, float;
putexplosion2(float,float,float,float);
puthorse oldstring, float, float;
puthorse(string,float,float);
putleaps float, float, float;
putleaps(float,float,float);
putnewcomp oldstring, float, float, oldstring, float;
putnewcomp(string,float,float,string,float);
putnpc oldstring, oldstring, float, float;
putnpc(string,string,float,float);
putnpc2 float, float, oldstring;
putnpc2(float,float,string);
reflectarrow float;
reflectarrow(float);
removearrow float;
removearrow(float);
removebomb float;
removebomb(float);
removecompus;
removecompus();
removeexplo float;
removeexplo(float);
removehorse float;
removehorse(float);
rmeoveitem float;
removeitem(float)
removestring oldstring, oldstring;
removestring(string,string);
removetiledefs oldstring;
removetiledefs(string);
replaceani oldstring, oldstring;
replaceani(string,string);
replacestring oldstring, float, oldstring;
replacestring(string,float,string);
resetfocus;
resetfocus();
savelog oldstring;
savelog(string);
savelog2 oldstring, oldstring;
savelog2(string,string);
say float;
say(float);
say2 oldstring;
say2(string);
sendrpgmessage oldstring;
sendrpgmessage(string);
sendpm oldstring;
sendpm(string);
sendtonc oldstring;
sendtonc(string);
sendtorc oldstring;
sendtorc(string);
serverwarp oldstring;
serverwarp(string);
set oldstring;
set(string);
setani oldstring, oldstring;
setani(string,string);
setarray float, float;
setarray(var,float);
setbeltcolor oldstring;
setbeltcolor(string);
setbow oldstring;
setbow(string);
setcharani oldstring, oldstring;
setcharani(string,string);
setchargender oldstring;
setchargender(string);
setcharprop oldstring, oldstring;
string = string;
setcoatcolor oldstring;
setcoatcolor(string);
setcoloreffect float, float, float, float;
setcoloreffect(float,float,float,float);
setcursor float;
setcursor(float);
setcurcor2 oldstring;
setcursor2(string);
seteffect float, float, float, float;
seteffect(float,float,float,float);
seteffectmode float;
seteffectmode(float);
setfocus float, float;
setfocus(float,float);
setgender oldstring;
setgender(string);
sethead oldstring;
sethead(string);
setlevel oldstring;
setlevel(string);
setlevel2 oldstring, float, float;
setlevel2(string,float,float);
setmap oldstring, oldstring, float, float;
setmap(string,string,float,float);
setminimap oldstring, oldstring, float, float;
setminimap(string,string,float,float);
setmusicvolume float, float;
setmusicvolume(float,float);
setimg oldstring;
setimg(string);
setimgpart oldstring, float, float, float, float;
setimgpart(string,float,float,float,float);
setletters oldstring;
setletters(string);
setplayerdir oldstring;
setplayerdir(string);
setplayerprop oldstring, oldstring;
string = string;
setpm oldstring;
setpm(string);
setshape float, float, float;
setshape(float,float,float);
setshape2 float, float, float;
setshape2(float,float,float);
setshield oldstring, float;
setshield(string,float);
setshoecolor oldstring;
setshoecolor(string);
setshootparams oldstring;
setshootparams(string);
setskincolor oldstring;
setskincolor(string);
setsleevecolor oldstring;
setsleevecolor(string);
setstring oldstring, oldstring;
setstring(string,string);
setsword oldstring, float;
setsword(string,float);
seturllevel oldstring;
seturllevel(string);
setz float, float, float, float, float, float, float, float;
setz(float,float,float,float,float,float,float,float);
setzoomeffect float;
setzoomeffect(float);
shoot float, float, float, float, float, float, oldstring, oldstring;
shoot(float,float,float,float,float,float,string,string);
shootarrow float;
shootarrow(float);
shootball;
shootball();
shootfireball float;
shootfireball(float);
shootfireblast float;
shootfireblast(float);
shootnuke float;
shootnuke(float);
show;
show();
showani float, float, float, float, oldstring;
showani(float,float,float,float,string);
showani2 float, float, float, float, float, oldstring;
showani2(float,float,float,float,float,string);
showcharacter;
showcharacter();
showfile oldstring;
showfile(string);
showimg float, oldstring, float, float;
showimg(float,string,float,float);
showimg2 float, oldstring, float, float, float;
showimg2(float,string,float,float,float);
showlocal;
showlocal();

showpoly float, float;
showpoly(float,array);
showpoly2 float, float;
showpoly2(float,array);
showstats float;
showstats(float);
showtext float, float, float, oldstring, oldstring, oldstring;
showtext(float,float,float,string,string,string);
showtext2 float, float, float, float, oldstring, oldstring, oldstring;
showtext2(float,float,float,float,string,string,string);
sleep float;
sleep(float);
spyfire float, float;
spyfire(float,float);
stopmidi;
stopmidi();
stopsound oldstring;
stopsound(string);
take oldstring;
take(string);
take2 float;
take2(float);
takehorse float;
takehorse(float);
takeplayercarry;
takeplayercarry();
takeplayerhorse;
takeplayerhorse();
throwcarry;
throwcarry();
timereverywhere;
timereverywhere();
timershow;
timershow();
toinventory oldstring;
toinventory(string);
tokenize oldstring;
tokens = string.tokenize();
tokenize2 oldstring, oldstring;
tokens = string.tokenize(" ," @ string);
toweapons oldstring;
toweapons(string);
triggeraction float, float, oldstring, oldstring;
triggeraction(float,float,string,string);
unfreezeplayer;
unfreezeplayer();
unset oldstring;
unset(string);
updateboard float, float, float, float;
updateboard(float,float,float,float);
updateterrain;
updateterrain();
wraptext float, oldstring, oldstring;
tokens = wraptext(float," ," @ string,string);
wraptext2 float, float, oldstring, oldstring;
tokens = wraptext2(float,float," ," @ string,string);
</pre>

=== Supported old string operations ===
<pre>
These old string operators can be used in string parameters
for the old commands, also you can use them directly as operators, e.g.
#c = "hello"
is actually doing
player.chat = "hello"

#a player.account
#a(float) players[float].account
#m player.ani
ani
#m(float) players[float].ani
#K(float) char(float)
#8 player.bodyimg
bodyimg
#8(float) players[float].bodyimg
#c player.chat
chat
#c(float) players[float].chat
#C0 player.colors[0]
colors[0]
#C0(float) players[float].colors[0]
#C1 player.colors[1]
colors[1]
#C1(float) players[float].colors[1]
#C2 player.colors[2]
colors[2]
#C2(float) players[float].colors[2]
#C3 player.colors[3]
colors[3]
#C3(float) players[float].colors[3]
#C4 player.colors[4]
colors[4]
#C4(float) players[float].colors[4]
#C5 player.colors[5]
colors[5]
#C5(float) players[float].colors[5]
#D downloadfile()
#E emoticonchar()
#e(float,float,oldstring)
string.substring(float,float)
#g player.guild
guild
#g(float) players[float].guild
#3 player.headimg
headimg
#3(float) players[float].headimg
#5 player.horseimg
horseimg
#5(float) players[float].horseimg
#k(float) keyname(float)
#L player.level
#I(oldstring,float)
getstring(string)[float]
#n player.nick
nick
#n(float) players[float].nick
#f image
#f(float) npcs[float].image
#F level
#p(float) params[float]
#P(float) player.attr[float]
attr[float]
#P(float_1,float_2)
players[float_2].attr[float_1]
#P1 player.attr[1]
attr[1]
#P1(float) players[float].attr[1]
#P2 player.attr[2]
attr[2]
#P2(float) players[float].attr[2]
#P3 player.attr[3]
attr[3]
#P3(float) players[float].attr[3]
#P4 player.attr[4]
attr[4]
#P4(float) players[float].attr[4]
#P5 player.attr[5]
attr[5]
#P5(float) players[float].attr[5]
#P6 player.attr[6]
attr[6]
#P6(float) players[float].attr[6]
#P7 player.attr[7]
attr[7]
#P7(float) players[float].attr[7]
#P8 player.attr[8]
attr[8]
#P8(float) players[float].attr[8]
#P9 player.attr[9]
attr[9]
#P9(float) players[float].attr[9]
#R(oldstring) string.random()
#2 player.shieldimg
shieldimg
#2(float) players[float].shieldimg
#s(oldstring) getstring(string)
#1 player.swordimg
swordimg
#1(float) players[float].swordimg
#S player.sword.script
#t(float) tokens[float]
#T(oldstring) string.trim()
#v(float) float
#W player.weapon.image
#W(float) weapons[float].image
#w player.weapon.name
#w(float) weapons[float].name
</pre>
Compatibility note:
When you use the command setcharprop then the first parameter
is handled differently: instead of changing 'player.chat' it
is changing 'chat', the chat text of the npc. So 'setcharprop #c,hello'
would be translated into
chat = "hello"
while 'setplayerprop #c,hello' is translated into
player.chat = "hello"
In the list above both possibilities are listed.

Worlds/Dark Rival

2006-03-28T20:39:14Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld will be replaced by a larger one soon. It will have more of a square shape, allowing players to roam Dark Rival a bit more. It will also have many more secrets than the current overworld. Eventually, there will be 3 active overworlds, for the three parts of the Dark Rival storyline. We are currently adding features to DR now. Including longer quests for rare items, more exclusive items and games, Auction House, marketplace, pets, games, lotteries, casino games, and more! There may be some small bugs, if you have any trouble, use the in game bug report system (found in the Player System weapon, under systems), or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
We are currently making the switch to GS2, and I have added new features that make use of this engine, including a better playersystem, better tailor system, and nore. Eventually, all of Dark Rival will take advantage of this new engine.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, and the server is now for V4 only (due to the growing number of GS2 scripts). We are also currently adding new weapons and features. Like a new larger quests, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, lotery, pets, and more!

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having around 400 levels to well over 1000 now, and it's STILL growing! Dark Rival remains to be one of the fastest growing servers around! Dark Rival also has some of the most unique elements, including a storyline, weapons, and the general feel that Dark Rival brings to Graal. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. DR offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is much more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, and will soon be replaced by an even larger overworld. This is actually the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

Join in on the action!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Neu, (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps.
The application is here: http://darkrivalonline.tripod.com/id9.html
== '''How to become a good staff member'''==
ALWAYS practice your skills. If yo're an LAT, look at levels other players have made the Graal forums, [http://forums.graalonline.com]is a great place to do this.
The forums aren't just good for LATs, however, they provide help on scripting, ganis, and gfx. It's a great place to learn, and become a part of the Graal community. I suggest to all current DR staff, and to all potential staff, to take advantage of the forums, Graal Bible, and any other resources they can find to become better developers. If you want to become an Events Team member, or a GP, I suggest asking other Events/GPs on multiple servers about their jobs, what they have to do, and how they became staff. Play on the server a lot, follow all the rules on that server, and play events. Really, this goes for all possitions as well. Get to know the server before you apply. Dark Rival, and the rest of Graal for that matter, is always looking for more developers, and more staff. It's not to hard to learn, so get a jump on it now! I hope to see you as staff on Dark Rival in the future!
-Excaliber Owner/Creator of Dark Rival

== '''Excaliber's Scripting Guide''' ==
I'm hoping this allows people to learn how to script a bit easier, I believe all staff should know some scripting basics, and I find other GS2 guides hard to follow.

Starting:

Level NPCs:

A level NPC is an npc that functions in a specific level. These are the most common on most servers. They are also a very important part of developement.

A script:
<pre>
//this is a note
/*

this is also a note, these help make scripts more clear
this type of note can go on as longe as it's inclosed
*/
//#CLIENTSIDE
//This tells the computer that the following
//script will be on the players client,
//as opposed to the server, this is very important.
function onPlayertouchesme()
//this checks if the player has touched the NPC
{ // starting bracket
message("Hey!"); //displays a message above the NPC
}//closing bracket
</pre>
The above script checks to see if the event, playertouchsme is true, then acts on what is in the bracket. It is important to include this clientside, because too many serverside scripts can cause problems for an NPC server, however thay are more secure. If you wanted to do the last script serverside, you would omit the //#CLIENTSIDE , and add the shape to the NPC:
<pre>
function onCreated()
{
setshape(1,32,32);
setimg("block.png");
//img can also be done in the box above the script
}
function onPlayertouchsme()
{
message("You made a serverside script!");
}
</pre>
This takes a bit longer than clientside commands, and it takes up serverside script time, however, for secure actions, it may be necessary.
A secure script example:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onPlayertouchsme()
{
if(player.account==this.account)
{
chat="This is a secure message!";
}
}
</pre>
First, I would like to quickly point out the 'if' statement. Some guides go into this a lot, but it's actually quite simple. The if statement is a very important part of scripting. It's what allows the NPC to make choices. The code withing the brackests of an if statement will only execute if the statement is true. Also, there is a catchall statement you can use, else. If the if statement is not true, the else will exectue it's script, other wise it is ignored.
Example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.a=1;
}
if(this.a==1)
//always use '==' for comparasons, NEVER just '=' as '=' is for assignments
{
this.b=2;
}
else if(this.a==2) //will only execute if first is false, AND this.a==2
{
this.b=3;
}
else //catch all if above 2 statements are false
{
this.b=4;
}
</pre>
Now, in the above example, this.b will always be 2, however, it's the format that's important.
<pre>
if(statement)
else if(statement)
else if(statement //may be used many times
else //catch all
</pre>
Now, back to serverside and clientside scripts:
By putting the checks on serverside, you disable a hackers ability to send an action from their client. So, this script is much more secure, and can only be accessed by the specified account (Excaliber7388 in this case). Dark Rival does these checks serverside as well, but we also apply a different method, to avoid having too much serverside script time:
<pre>
function onCreated()
{
this.account="Excaliber7388";
setshape 1,32,32;
chat="Excaliber's Chest";
}
function onTouched()
{
if(player.account==this.account)
{
chat="Yup, this is still secure, yay!";
}
}
//#CLIENTSIDE
function onPlayertouchsme()
{
triggeraction(x,y,"Touched","Touched";//no params needed
}
</pre>
This script will take up more time, but the playertouchsme check is clientside. Would this help much? Probably not, in fact, sending the action in this case would probably create more lag than having the script serverside. However, if a large portion of the script is serverside, and can be moved to clientside without risking security, it may be a good idea.
Serverisde timeouts=bad idea.
You shouldn't send to many actions to serverside, especially if you do so quickly. You should always limit the serverside timeouts, and the amount of time between actions to the server from client should be spaced out. Also, you should never have a timeout shorter than .05 on serverside, though it is possible, please do not do it. Dark Rival has had problems in the ast regarding serverside loops, however these have ben fixed.
Here are two examples of serverside scripts, the first it [b]VERY[/b] bad, the second is more productive:
<pre>
function onCreated()
{
setshape 1,32,32;
}
function onActiontime()
{
for(server.i=0;server.i<5;server.i++)
//WHY use server for this???
//for loops, use this. it works only for this NPC
{
sleep(.01);
//WAY to short of a sleep time for the server
}
server.time+=.1;
}
//#CLIENTSIDE
function onCreated()
{
settimer(.05); //minimum clientside timeout
}
function onTimeout()
{
trigegraction(x,y,"time","time");
settimer(.05);
//will cause a loop through the timeout, sending action
//to serverside TOO quickly, AND while the server is
//still working on the last action. This WILL cause the
//server to crash.
}
</pre>
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly!
A better version:
<pre>function onCreated()
{
setshape 1,32,32;
//setshape is needed for all level NPCs triggeractions
//this setsit to a square of tiles 32 pix by 32 pix
}
function onActiontime()
{
server.time+=1;
//no need for incredible accuracy
}
//#CLIENTSIDE
function onCreated()
{
settimer(1);
}
function onTimeout()
{
triggeraction(x,y,"time","time");
settimer(1);
}
</pre>
This will execute the script less often, however, it still is an unlimited loop. Don't have too many of these NPCs, or you could have problems!

Now, you may have noticed this line in the bad script:
<pre>
for(server.i=0;server.i<5;server.i++)
</pre>
This is a 'for' loop. There are many types of loops, however the foor loop isn't the easiers to learn first. Therefore, I will show you the 'while loop' first.
The while loop executes whatever is held within it's brackets as lond as the statement within it is true. The while loop is just like an if statement, but you cannot use else with a with statement.
format:
<pre>
with(statments)
{
//commands
}
//if statment is still true, it will loop
</pre>
here's a script example:
<pre>
//#CLIENTSIDE
function onCreated()
{
this.size=10;
}
while(this.size<=20) //while this.size is less than or equal to 20
{
chat="The fish was " @this.size@ " centimeters long!";
//as the story is retold....
sleep(.5);
this.size=this.size+1;
//increment the size
}
</pre>
The above script will run through the loop until this.size is equal or greater than 20.
Some important things to know:
<pre>
if(a==b) means if a is equal to b
if(a<b) means if a is less than b
if(a>b) means if a is greater than b
if(a<=b) means if a is less than or equal to be
if(a>=b) means if a is greater than or equal to be
a++ is the same as a=a+1
a-- is the same as a=a-1
a+=b means a=a+b
a-=b means a=a-b
a*=b means a=a*b (multiplied by b)
a/=b means a=a/b
++a is just like a, but it will add to a before anything else in the line,
this is not important to know now
--a just like ++a, but with subtraction
a%b Modulus, basically, its a/b and th remainder is the output
for example 10%3=1
</pre>
These may be helpfull in loops, or in any other ration expressios you may use. (Hell, it's important for all scripting!)
Now, recall this line:
<pre>
chat="The fish was " @this.size@ " centimeters long!";
</pre>
The output for this is: The fish was (size here) centimeters long!
The script NEED to know where a variable is, so if you want to put it in between a string you surround it with the '@' symbol. Or if it's at the end, you only put the '@' at the beggining of the variable. The variable and the '@' do NOT go in the quotes. Example:
<pre>
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
</pre>
This would display the player's account, and sword image.

I will add more over time.

Note: if you know gs1, gs2 is easy to learn, below is a list of commands in their old form and their new format, on the right. You can also use this list to learn the commands. This is taken from this page:http://wiki.graal.net/index.php/Creation/Dev/Script/Starting_Guide#Introduction
which is also helpful for learning how to script. Enjoy!
== Old script compatibility ==

=== Removed functionality ===
<pre>
- toinventory
- followplayer
- playersays()
- setbackpal
</pre>
=== Supported old scripting commands and their mapping to new script ===
<pre>
addstring oldstring, oldstring;
list.add(string);
addtiledef oldstring, oldstring, float;
addtiledef(string,string,float);
addtiledef2 oldstring, oldstring, float, float;
addtiledef2(string,string,float,float);
attachplayertoobj float, float;
attachplayertoobj(float,float);
blockagain;
blockagain();
blockagainlocal;
blockagainlocal();
callnpc float, oldstring;
callnpc(float,string);
callweapon float, oldstring;
callweapon(float,string);
canbecarried;
canbecarried();
canbepulled;
canbepulled();
canbepushed;
canbepushed();
cannotbecarried;
cannotbecarried();
cannotbepulled;
cannotbepulled();
cannotbepushed;
cannotbepushed();
canwarp;
canwarp();
canwarp2;
canwarp2();
carryobject oldstring;
carryobject(string);
changeimgcolors float, float, float, float, float;
changeimgcolors(float,float,float,float,float);
changeimgmode float, float;
changeimgmode(float,float);
changeimgpart float, float, float, float, float;
changeimgpart(float,float,float,float,float);
changeimgvis float, float;
changeimgvis(float,float);
changeimgzoom float, float;
changeimgzoom(float,float);
deletestring oldstring, float;
deletestring(string,float);
destroy;
destroy();
detachplayer;
detachplayer();
disabledefmovement;
disabledefmovement();
disablemap;
disablemap();
disablepause;
disablepause();
disableselectweapons;
disableselectweapons();
disableweapons;
disableweapons();
dontblock;
dontblock();
dontblocklocal;
dontblocklocal();
drawaslight;
drawaslight();
drawoverplayer;
drawoverplayer();
drawunderplayer;
drawunderplayer();
enabledefmovement;
enabledefmovement();
enablefeatures float;
enablefeatures(float);
enablemap;
enablemap();
enablepause;
enablepause();
enableselectweapons;
enableselectweapons();
enableweapons;
enableweapons();
explodebomb float;
explodebomb(float);
followplayer;
followplayer();
freezeplayer float;
freezeplayer(float);
freezeplayer2;
freezeplayer2();
hide;
hide();
hideimg float;
hideimg(float);
hideimgs float, float;
hideimgs(float,float);
hidelocal;
hidelocal();

hitcompu float, float, float, float;
hitcompu(float,float,float,float);
hitnpc float, float, float, float;
hitnpc(float,float,float,float);
hitobjects float, float, float;
hitobjects(float,float,float);
hideplayer float;
hideplayer(float);
hidesword float;
hidesword(float);
hitplayer float, float, float, float;
hitplayer(float,float,float,float);
hurt float;
hurt(float);
insertstring oldstring, float, oldstring;
insertstring(string,float,string);
join oldstring;
join(string);
lay oldstring;
lay(string);
lay2 oldstring, float, float;
lay2(string,float,float);
loadmap oldstring;
loadmap(string);
message oldstring;
message(string);
move float, float, float, float;
move(float,float,float,float);
noplayerkilling;
noplayerkilling();
openurl oldstring;
openurl(string);
openurl2 oldstring, float, float;
openurl2(string,float,float);
play oldstring;
play(string);
play2 oldstring, float, float, float;
play2(string,float,float,float);
playlooped oldstring;
playlooped(string);
putbomb float, float, float;
putbomb(float,float,float);
putcomp oldstring, float, float;
putcomp(string,float,float);
putexplosion float, float, float;
putexplosion(float,float,float);
putexplosion2 float, float, float, float;
putexplosion2(float,float,float,float);
puthorse oldstring, float, float;
puthorse(string,float,float);
putleaps float, float, float;
putleaps(float,float,float);
putnewcomp oldstring, float, float, oldstring, float;
putnewcomp(string,float,float,string,float);
putnpc oldstring, oldstring, float, float;
putnpc(string,string,float,float);
putnpc2 float, float, oldstring;
putnpc2(float,float,string);
reflectarrow float;
reflectarrow(float);
removearrow float;
removearrow(float);
removebomb float;
removebomb(float);
removecompus;
removecompus();
removeexplo float;
removeexplo(float);
removehorse float;
removehorse(float);
rmeoveitem float;
removeitem(float)
removestring oldstring, oldstring;
removestring(string,string);
removetiledefs oldstring;
removetiledefs(string);
replaceani oldstring, oldstring;
replaceani(string,string);
replacestring oldstring, float, oldstring;
replacestring(string,float,string);
resetfocus;
resetfocus();
savelog oldstring;
savelog(string);
savelog2 oldstring, oldstring;
savelog2(string,string);
say float;
say(float);
say2 oldstring;
say2(string);
sendrpgmessage oldstring;
sendrpgmessage(string);
sendpm oldstring;
sendpm(string);
sendtonc oldstring;
sendtonc(string);
sendtorc oldstring;
sendtorc(string);
serverwarp oldstring;
serverwarp(string);
set oldstring;
set(string);
setani oldstring, oldstring;
setani(string,string);
setarray float, float;
setarray(var,float);
setbeltcolor oldstring;
setbeltcolor(string);
setbow oldstring;
setbow(string);
setcharani oldstring, oldstring;
setcharani(string,string);
setchargender oldstring;
setchargender(string);
setcharprop oldstring, oldstring;
string = string;
setcoatcolor oldstring;
setcoatcolor(string);
setcoloreffect float, float, float, float;
setcoloreffect(float,float,float,float);
setcursor float;
setcursor(float);
setcurcor2 oldstring;
setcursor2(string);
seteffect float, float, float, float;
seteffect(float,float,float,float);
seteffectmode float;
seteffectmode(float);
setfocus float, float;
setfocus(float,float);
setgender oldstring;
setgender(string);
sethead oldstring;
sethead(string);
setlevel oldstring;
setlevel(string);
setlevel2 oldstring, float, float;
setlevel2(string,float,float);
setmap oldstring, oldstring, float, float;
setmap(string,string,float,float);
setminimap oldstring, oldstring, float, float;
setminimap(string,string,float,float);
setmusicvolume float, float;
setmusicvolume(float,float);
setimg oldstring;
setimg(string);
setimgpart oldstring, float, float, float, float;
setimgpart(string,float,float,float,float);
setletters oldstring;
setletters(string);
setplayerdir oldstring;
setplayerdir(string);
setplayerprop oldstring, oldstring;
string = string;
setpm oldstring;
setpm(string);
setshape float, float, float;
setshape(float,float,float);
setshape2 float, float, float;
setshape2(float,float,float);
setshield oldstring, float;
setshield(string,float);
setshoecolor oldstring;
setshoecolor(string);
setshootparams oldstring;
setshootparams(string);
setskincolor oldstring;
setskincolor(string);
setsleevecolor oldstring;
setsleevecolor(string);
setstring oldstring, oldstring;
setstring(string,string);
setsword oldstring, float;
setsword(string,float);
seturllevel oldstring;
seturllevel(string);
setz float, float, float, float, float, float, float, float;
setz(float,float,float,float,float,float,float,float);
setzoomeffect float;
setzoomeffect(float);
shoot float, float, float, float, float, float, oldstring, oldstring;
shoot(float,float,float,float,float,float,string,string);
shootarrow float;
shootarrow(float);
shootball;
shootball();
shootfireball float;
shootfireball(float);
shootfireblast float;
shootfireblast(float);
shootnuke float;
shootnuke(float);
show;
show();
showani float, float, float, float, oldstring;
showani(float,float,float,float,string);
showani2 float, float, float, float, float, oldstring;
showani2(float,float,float,float,float,string);
showcharacter;
showcharacter();
showfile oldstring;
showfile(string);
showimg float, oldstring, float, float;
showimg(float,string,float,float);
showimg2 float, oldstring, float, float, float;
showimg2(float,string,float,float,float);
showlocal;
showlocal();

showpoly float, float;
showpoly(float,array);
showpoly2 float, float;
showpoly2(float,array);
showstats float;
showstats(float);
showtext float, float, float, oldstring, oldstring, oldstring;
showtext(float,float,float,string,string,string);
showtext2 float, float, float, float, oldstring, oldstring, oldstring;
showtext2(float,float,float,float,string,string,string);
sleep float;
sleep(float);
spyfire float, float;
spyfire(float,float);
stopmidi;
stopmidi();
stopsound oldstring;
stopsound(string);
take oldstring;
take(string);
take2 float;
take2(float);
takehorse float;
takehorse(float);
takeplayercarry;
takeplayercarry();
takeplayerhorse;
takeplayerhorse();
throwcarry;
throwcarry();
timereverywhere;
timereverywhere();
timershow;
timershow();
toinventory oldstring;
toinventory(string);
tokenize oldstring;
tokens = string.tokenize();
tokenize2 oldstring, oldstring;
tokens = string.tokenize(" ," @ string);
toweapons oldstring;
toweapons(string);
triggeraction float, float, oldstring, oldstring;
triggeraction(float,float,string,string);
unfreezeplayer;
unfreezeplayer();
unset oldstring;
unset(string);
updateboard float, float, float, float;
updateboard(float,float,float,float);
updateterrain;
updateterrain();
wraptext float, oldstring, oldstring;
tokens = wraptext(float," ," @ string,string);
wraptext2 float, float, oldstring, oldstring;
tokens = wraptext2(float,float," ," @ string,string);
</pre>

=== Supported old string operations ===
<pre>
These old string operators can be used in string parameters
for the old commands, also you can use them directly as operators, e.g.
#c = "hello"
is actually doing
player.chat = "hello"

#a player.account
#a(float) players[float].account
#m player.ani
ani
#m(float) players[float].ani
#K(float) char(float)
#8 player.bodyimg
bodyimg
#8(float) players[float].bodyimg
#c player.chat
chat
#c(float) players[float].chat
#C0 player.colors[0]
colors[0]
#C0(float) players[float].colors[0]
#C1 player.colors[1]
colors[1]
#C1(float) players[float].colors[1]
#C2 player.colors[2]
colors[2]
#C2(float) players[float].colors[2]
#C3 player.colors[3]
colors[3]
#C3(float) players[float].colors[3]
#C4 player.colors[4]
colors[4]
#C4(float) players[float].colors[4]
#C5 player.colors[5]
colors[5]
#C5(float) players[float].colors[5]
#D downloadfile()
#E emoticonchar()
#e(float,float,oldstring)
string.substring(float,float)
#g player.guild
guild
#g(float) players[float].guild
#3 player.headimg
headimg
#3(float) players[float].headimg
#5 player.horseimg
horseimg
#5(float) players[float].horseimg
#k(float) keyname(float)
#L player.level
#I(oldstring,float)
getstring(string)[float]
#n player.nick
nick
#n(float) players[float].nick
#f image
#f(float) npcs[float].image
#F level
#p(float) params[float]
#P(float) player.attr[float]
attr[float]
#P(float_1,float_2)
players[float_2].attr[float_1]
#P1 player.attr[1]
attr[1]
#P1(float) players[float].attr[1]
#P2 player.attr[2]
attr[2]
#P2(float) players[float].attr[2]
#P3 player.attr[3]
attr[3]
#P3(float) players[float].attr[3]
#P4 player.attr[4]
attr[4]
#P4(float) players[float].attr[4]
#P5 player.attr[5]
attr[5]
#P5(float) players[float].attr[5]
#P6 player.attr[6]
attr[6]
#P6(float) players[float].attr[6]
#P7 player.attr[7]
attr[7]
#P7(float) players[float].attr[7]
#P8 player.attr[8]
attr[8]
#P8(float) players[float].attr[8]
#P9 player.attr[9]
attr[9]
#P9(float) players[float].attr[9]
#R(oldstring) string.random()
#2 player.shieldimg
shieldimg
#2(float) players[float].shieldimg
#s(oldstring) getstring(string)
#1 player.swordimg
swordimg
#1(float) players[float].swordimg
#S player.sword.script
#t(float) tokens[float]
#T(oldstring) string.trim()
#v(float) float
#W player.weapon.image
#W(float) weapons[float].image
#w player.weapon.name
#w(float) weapons[float].name
</pre>
Compatibility note:
When you use the command setcharprop then the first parameter
is handled differently: instead of changing 'player.chat' it
is changing 'chat', the chat text of the npc. So 'setcharprop #c,hello'
would be translated into
chat = "hello"
while 'setplayerprop #c,hello' is translated into
player.chat = "hello"
In the list above both possibilities are listed.

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

'''Soon to come'''

-Wood chopping

-Fighting

-Gardening

-Bounty Hunting

Worlds/Dark Rival

2006-03-28T20:35:22Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-28T16:29:28Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-28T16:27:51Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-28T16:23:28Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-28T16:14:31Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-28T16:05:40Z

Excaliber7388: /* '''Excaliber's Scripting Guide''' */

Worlds/Dark Rival

2006-03-24T16:29:23Z

Excaliber7388:

Worlds/Dark Rival

2006-03-22T16:23:32Z

Excaliber7388:

Worlds/Dark Rival

2006-03-22T13:11:34Z

Excaliber7388: /* '''How to become a good staff member''' */

Worlds/Dark Rival

2006-03-22T13:11:02Z

Excaliber7388: /* '''Hiring!''' */

Worlds/Dark Rival

2006-03-22T13:05:08Z

Excaliber7388: /* '''Play Now:''' */

Worlds/Dark Rival

2006-03-22T13:04:21Z

Excaliber7388: /* '''Play Now:''' */

Worlds/Dark Rival

2006-03-22T13:03:23Z

Excaliber7388:

Worlds/Dark Rival

2006-03-22T13:02:26Z

Excaliber7388: /* '''Jobs:''' */

Worlds/Dark Rival

2006-03-22T13:01:34Z

Excaliber7388:

Worlds/Dark Rival

2006-03-17T23:31:18Z

Excaliber7388: /* '''Hiring!''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld of Dark Rival is nearly complete. (There will be 3). We are currently adding features to it now. Including longer quests for rare items, more exclusive items and games,Auction House and more! There may be some small bugs, if you have any trouble, use the in game bug report system, or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, made the server compatable for V4 and we are currently adding new weapons and features. Like a new large quest, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, and more! We are also working on becoming a GS2 only server. V2 and V4 are allowed to play here, however for the time being, V2 is suggested for full gameplay (for lighting effects, day/night, map, and gmap, use V2).

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having only 400+ levels to over 1000 now, and it's STILL growing! Dark Rival also has some of the most unique storyline, weapons, and general feel. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. It offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Burning Ice, burningicic678 (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps.
The application is here: http://darkrivalonline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

Worlds/Dark Rival

2006-03-17T23:30:54Z

Excaliber7388: /* '''Hiring!:''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld of Dark Rival is nearly complete. (There will be 3). We are currently adding features to it now. Including longer quests for rare items, more exclusive items and games,Auction House and more! There may be some small bugs, if you have any trouble, use the in game bug report system, or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, made the server compatable for V4 and we are currently adding new weapons and features. Like a new large quest, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, and more! We are also working on becoming a GS2 only server. V2 and V4 are allowed to play here, however for the time being, V2 is suggested for full gameplay (for lighting effects, day/night, map, and gmap, use V2).

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having only 400+ levels to over 1000 now, and it's STILL growing! Dark Rival also has some of the most unique storyline, weapons, and general feel. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. It offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Burning Ice, burningicic678 (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!''' ==

We are hiring LATs, NATs, GATs, Events, and Gps.
The application is here: http://darkrivalobnline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

Worlds/Dark Rival

2006-03-17T23:30:42Z

Excaliber7388:

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld of Dark Rival is nearly complete. (There will be 3). We are currently adding features to it now. Including longer quests for rare items, more exclusive items and games,Auction House and more! There may be some small bugs, if you have any trouble, use the in game bug report system, or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, made the server compatable for V4 and we are currently adding new weapons and features. Like a new large quest, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, and more! We are also working on becoming a GS2 only server. V2 and V4 are allowed to play here, however for the time being, V2 is suggested for full gameplay (for lighting effects, day/night, map, and gmap, use V2).

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having only 400+ levels to over 1000 now, and it's STILL growing! Dark Rival also has some of the most unique storyline, weapons, and general feel. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. It offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

Burning Ice, burningicic678 (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Hiring!:''' ==

We are hiring LATs, NATs, GATs, Events, and Gps.
The application is here: http://darkrivalobnline.tripod.com/id9.html

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]

Worlds/Dark Rival

2006-03-14T02:42:01Z

Excaliber7388: /* '''News:''' */

http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png

[[Image:main.png|thumb|center|175px]]

The current overworld of Dark Rival is nearly complete. (There will be 3). We are currently adding features to it now. Including longer quests for rare items, more exclusive items and games,Auction House and more! There may be some small bugs, if you have any trouble, use the in game bug report system, or e-mail Excaliber (the owner) at excaliber7388@yahoo.com

== '''News:''' ==
[[Image:events_out.png|thumb|left|150px]]

Dark Rival is trying out for the hosted tab. Wish us luck!
We're currently working on a new overworld/gmap. It will be bigger and better looking than the last one.
NEW markets! Now players can sell or auction their items. have fun with it ^_^.
Now there are 3 different 'camera' modes, chase, 'player' and the normal one. Enjoy!
The outfit viewer has now been added, please report any bugs you encounter.
We have recently added more events, made the server compatable for V4 and we are currently adding new weapons and features. Like a new large quest, rpg style weapons, telescope, CTF, lazer tag, mini games, 3D games and events, nations, instruments, RPG elements, and more! We are also working on becoming a GS2 only server. V2 and V4 are allowed to play here, however for the time being, V2 is suggested for full gameplay (for lighting effects, day/night, map, and gmap, use V2).

== '''About:''' ==

Dark Rival first went online July 27th 2005. From there it grew from having only 400+ levels to over 1000 now, and it's STILL growing! Dark Rival also has some of the most unique storyline, weapons, and general feel. RPG elements will also soon be added, in the prequel and sequel, as well as weapon skills in the current game. It offers plenty of jobs, skills, quests, and mysteries for the player to solve. It plays like a classic server, but is more complex. Dark Rival will continue to grow, hopefully, you can be a part of it!
[[Image:pic_darkrivalgui.png|thumb|center|175px]]

== '''Story:''' ==

Dark Rival is basically a three part story, played out on three different overworlds. So far, only one of these overworlds is near completion, the middle part of the story. You play as yourself in the first part, taking over for a hero who has disapeared. Then you enter a flashback, and play as the old hero, finding out more about the plot. Finally, you team up to defeat the 'Dark Rival' in the final part, introducing new ways of playing graal. After that, it's up to the players to see what direction Dark Rival will go in, as they have to 'rebuild' the world after Ceverous (the Dark Rival) is defeated, and there will be a power struggle for control of the world, as 2 nations fight for control. It's going to be a very realistic, time and player based server, and I hope you can be a part of it!

== '''Play Now:''' ==

Follow this link to play Dark Rival now!

graal://Dark Rival

== '''Website:''' ==

http://darkrivalonline.tripod.com

'''Staff application (we need LATs NATs and GATs):'''

http://darkrivalonline.tripod.com/id9.html

== '''Current staff:''' ==
Admins:

Excaliber, Excaliber7388 (Owner/Manager): excaliber7388@yahoo.com

336,Vima (Co/manager)

SaCReD, Mrswhoopie (LAT Admin)

Burning Ice, burningicic678 (Events Admin)

Shad, xshadx (GP Chief)

John, silverice (GAT Admin)

Sam, lisia (FAQ Admin)

== '''Jobs:''' ==

'''Fishing'''
-fish using two different rods to earn money.
[[Image:fishing_pic.png|thumb|left|150px]]

'''Mining'''
-mine up loose rock, then search through the piles to find minerals
[[Image:pic_mining.png|thumb|left|150px]]

'''Shoveling'''
-search the ground for money, this can only be done on soft grass
[[Image:shoveling_pic.png|thumb|right|150px]]