Worlds/Dark Rival
http://img208.imageshack.us/img208/7503/darkrivalnamething5gd.png
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 [email protected]
News:
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!
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): [email protected]
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, [1]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:
//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
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:
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!");
}
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:
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!";
}
}
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:
//#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;
}
Now, in the above example, this.b will always be 2, however, it's the format that's important.
if(statement) else if(statement) else if(statement //may be used many times else //catch all
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:
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
}
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:
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.
}
If you put the above script on a server, say goodbye to your NPC server, because it will crach pretty quickly! A better version:
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);
}
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:
for(server.i=0;server.i<5;server.i++)
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:
with(statments)
{
//commands
}
//if statment is still true, it will loop
here's a script example:
//#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
}
The above script will run through the loop until this.size is equal or greater than 20. Some important things to know:
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
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:
chat="The fish was " @this.size@ " centimeters long!";
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:
//#CLIENTSIDE
function onPlayertouchsme()
{
chat="Well hi there, " @player.account@ " I like your sword, " @player.swordimg;
}
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
- toinventory - followplayer - playersays() - setbackpal
Supported old scripting commands and their mapping to new script
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);
Supported old string operations
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
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.
Mining -mine up loose rock, then search through the piles to find minerals
Shoveling -search the ground for money, this can only be done on soft grass
Soon to come
-Wood chopping
-Fighting
-Gardening
-Bounty Hunting