Graal Forums - Documentation Request

Graal Forums (https://forums.graalonline.com/forums/index.php)

- New Scripting Engine (GS2) (https://forums.graalonline.com/forums/forumdisplay.php?f=153)

- - Documentation Request (https://forums.graalonline.com/forums/showthread.php?t=65778)

Problem is, I don't know GS2 well, myself. It'd be nice if Skyld or someone could do this. Most of it is just syntaxing, but things have been removed and there are new additions to the scripting language such as GUI windows and particles.

- shoot real,real,real,real,real,real,string,string
Not only is this posted numerous times, only once does it list it as
shoot x,y,z,angle,zangle,power,ani,aniparams;
which STILL omits the most useful bit of information from the original documentation:
angle is in radians, and what number you set Power to to make it a classic-style goes-until-it-hits-a-wall projectile.

Function prototypes are not documentation by any means.

http://wiki.graal.net/index.php/Crea...ev/Old_GScript

Well, I mean, we got stuff like

NPC Code:



move dx,dy,time,options;	                  moves the npc, options: cachtype(0,1,2) + 

                                                      blockcheck(4) + eventwhendone(8) + 

                                                      applydir(16)

...so I can figure out dx, dy is going to be something like -8, 0 for Move 8 tiles left, and time's probably going to be in seconds, so if you say 1 it'll move those 8 tiles in one second...
So what's cachtype 0,1,and 2? I imagine it's standard-issue binary, 0 means no cachtype, 1 means cachtype 1, 2 means cachtype 2, 3 means both 1 and 2...but what do they DO in vague terms?
Blockcheck 4, I imagine it detects blocking tiles - does it detect water? Chairs? Beds? Lava? Shallows?
Eventwhendone, I remember this being terrifically useful - but what event did it call? With what parameters/arguments?
Applydir? Will that turn the NPC automatically?
I'll grant, I could do some of this legwork myself, but EventWhenDone, that's infinite possible event-calls to detect for...

-5 minutes later-
It's a good thing I keep everything.

From NewFeatures2001.txt:

Quote:

Originally Posted by Stefan

There are also nice options to makes things very simple:
- cachingmode:
- 0: previous movements will be finished immediatelly
- 1: movements will be cached, the previous movements
will only be finished when the cache is too large
(distance to go >5);
this caching can be used on server-side npcs to
make the movement look like non-laggy even when
there are little delays sometimes
- 2: the movement will just be appended to the movement
list; you can add up to 100 movements
- blockcheck: add 4 to the options when you want the
npc to stop when there is a wall blocking the npc
- informmewhendone: if you add 8 to the options then the
script will be called with a 'movementfinished' flag
when the the npc has stopped walking; catch this event
with
if (movementfinished) {...}
if you want to do something when the npc has stopped
(e.g. walking in a different direction)
- applydirection: add 16 to the options if you want the
game to automatically set the direction of the npc
depending on the movement direction (can be good
when using movement caching)

I wonder if I have access to add the old NewFeatures to the Wiki myself...
Nope, sure don't. Oh well.

Quote:

Originally Posted by Tyhm (Post 1243182)

I wonder if I have access to add the old NewFeatures to the Wiki myself...
Nope, sure don't. Oh well.

You do, login to the Bible with your Graal account information and you can add a new page or edit an already existing one.

Tried. The scripting section is locked down, no edit or add links. I can upload graphics for all the good that'd do me. Unless they hide the New Page links somewhere sneaky...

Tyhm, login to the wiki first, I don't think that any page is protected right now except the main page.
Best would be to add the old "newfeatures.txt" to http://wiki.graal.net/index.php/Crea...lient_Releases I guess.

Okay, duh, now I see it, way off to the left...
Well that's cool, if I make the links then the pages create themselves...
Alright, should be up soon then.

:: revives the sticky ::

I would be glad to do some major updating to the wiki (most notably the scripting part) if I got some sort of recognition for it. I know it may be selfish to ask for that but I don't think there is one person on here that doesn't want recognition for their hard work.

EDIT:
I'm sure many of you know I'm plenty capable for the job.