Basic NO PREVIOUS KNOWLEDGE TUTORIALS

[DustyPorViva]

Maybe, but he's not always sure if he is.

[PrinceOfKenshin]

ok well lets say im going to script simple gun what would i use?

[DustyPorViva]

shoot(), would be the simplest of ways, and can be done with one command and a couple of ganis. Sorry I can't provide the details, I don't remember. I'll look it up after House is done.

EDIT:

PHP Code:

//#CLIENTSIDE
function onWeaponfired() {
  shoot(x,y,z,angle,zangle,power,"gani",param1,param2,...[these params are sent to the GANI, not passed in the shoot command]);
} 


//#CLIENTSIDE // Everything following this is dealt on the clientside of things. shoot() is clientside.
function onWeaponfired() {..} // Everything inside this function is called when the weapon is fired.
shoot(stuff)... // Shoots a projectile that is visible as whatever gani is defined. As for the specs, straight from newfeatures, as no need to repeat them in different words:
x,y and z - specify the starting position
angle - shoot angle (when looking from the top): east is 0, north 3.14/2, west is 3.14, south 3.14*3/2)
zangle - the angle in vertical direction, 0 means the projectile is shoot horizontal, 3.14/2 means straight to the sun
power - the shoot power which is used to shoot the projectile; if it's 0 then the projectile is shoot like an old arrow (doesn't fall down, moves 20 tiles each second)
gani - the animation that is used for the projectile; the animation can be multidirectional, the engine automatically selects the best direction for the flying direction; the animation can have 1 step (not animated) or 7 steps, then the engine is automatically choosing the good animation step for the projectile flying angle - when its raising then step 1 is taken, when flying horizontal it is step 4, when it is short before the impact then the engine displays step 7

If anything confuses you, I'll try to answer. There's a lot more to it than this, but I figured you should start off with just getting a bullet going.

[PrinceOfKenshin]

not that simple lol you would use keydown gani scripts. Is that it?

[DustyPorViva]

Originally Posted by PrinceOfKenshin

not that simple lol you would use keydown gani scripts. Is that it?

What do you mean?

[killerogue]

I think he means something along the lines of pressing a key and it playing a gani, i.e.:

PHP Code:

function onKeyPressed( keynr, keyname )
{
  if (keyname == "s")
  {
    setani("fireani", "");
  }
} 


E: My final suggestion, if you have a friend who's a good scripter...ask him to tutor you. It's easier to learn from someone rather than something ( I.E. the wiki ). The wiki's just there for informational purposes really, otherwises it's just..blegh.

[DustyPorViva]

Originally Posted by killerogue

I think he means something along the lines of pressing a key and it playing a gani, i.e.:

I don't think that was the context of his post. I assume it had something to do with what I posted, but I have no idea.

[zokemon]

I try to teach lots of people GS2 who choose to come to me and it usually works rather well. I PERSONNALY believe the best way to start teaching it is to explain the following:
- How a script is read (compiled together and all the functions are stored to be run when "called")
- The 2 different things you can do in a gs2 script (call functions and set variables)
- How functions work (Also: calling built-in functions [such as onCreated()] and redefining built-in functions [such as function show() {}])
- The 4 variable types: (Float, String, Object, Array)

I believe the last of those things to be the MOST important to actually grasp the concepts of gs2 coding. I am a GUI man though, so my ideas may just be biased as I use objects a lot.

If anyone wants to try to make a guide like such, feel free!
I should get around to actually making one sometime (when I'm not so swamped D: ).

[Crow]

Originally Posted by zokemon

- The 4 variable types: (Float, String, Object, Array)

GScript variables are always 'Double' though. Sorry, just had to point that out

[zokemon]

Originally Posted by Crow

GScript variables are always 'Double' though. Sorry, just had to point that out

In C++, yes. But if you use the wiki.graal.net at all you will notice every parameter marked with one of these 4 variable types. You don't ever see one marked with "double".

[killerogue]

Thought I'd do my best to explain objects simply, and a few things of what you can do with them.

This Lesson One, focuses mainly on using text files with objects.

PHP Code:

// Lesson 1: Objects and How They Work

// Today we're going to make objects and use a few object functions!
// Objects must be created by making TStaticVars like below:

// temp.objName = new TStaticVar();

// Keep in mine, the capitalization in my var name is just a stylistic
// choice and has no effect on the outcome of the script. Tho, it's
// a good idea to make sure you've got all the capitalization correct 
// when using TStaticVars() and things like it!

// Let's Begin!

function onCreated()
{
  temp.newObj = new TStaticVar(); // Here we create the object.
  
  // Below we will define some variables of the new object
  // It being a created object, we can create as many vars
  // as we want for the damn thing. :)
  
  temp.newObj.personOne   = "Stan";
  temp.newObj.personTwo   = "Zero";
  temp.newObj.personThree = "Twinny";
  temp.newObj.personFour  = "James";
  
  // With the newly created variables above, there are a number 
  // of things you can do with the information stored in each variable
  // in the object.
  
  // Let's look at a few!
  
  // * - Files - * \\
  // Here we will save the vars into a text file:
  
  // temp.newObj.saveVars("textfilepath/textfilename.txt", 0);
  
  // Keep in mind saveLines is another form of saving variables
  // from objects into text files. However it saves each var line
  // for line. I'm not too big on explanations right now as I don't
  // use saveLines often.
  
  // The first param for saveVars() is pretty obvious. :p
  // The second param however, decides whether the file is overwritten,
  // or merely if the file is just added onto!
  
  
  // Having saved these informations into a text file, we can then later
  // receive this information through a command we shall learn in the next
  // lesson, dubbed: loadVars();
  
  /* Special Practice Notes:
        1. Things like saveVars(), or loadVars() are object only functions.
           Meaning they can only be attached onto the tail of an object that
           has, or in the case of loadVars sometimes, doesn't have information in it.
  */
}

// Lesson 1: Objects and How They Work, cont.

  // Now that you understand the basics of objects and how you can understand the 
  // uses and storing of informations inside of them. Let's look a bit deeper
  // our target for this lesson is loadVars.
  
  // Now, when you first create an object, it usually has nothing in it.
  // Of course that applies to IF you create the object first, but in my opinion,
  // it's always best to clearly state out the new static variable assignment.
  
  //Like before loadVars is am object only function, let's take a look at it's use.
  
  function onStuff()
  {
    // Again we create the object.
  
    temp.newObj = new TStaticVar();
    
    // Now we load the vars from a text file, consider your test text file is named
    // test.txt. And it contains the 5 names from before. We simply do this:
    
    temp.newObj.loadVars("test.txt");
    
    // But what if you wanted to get the information from an object through a script?
    // We certainly can't just yank it out now can we? Of course not!
    
    // There's only one sure shot thing that can get us the variables we want, 
    // and it's an object function! Aptly named, getDynamicVarNames().
    
    // Dynamic variables are variables that never stay the same and could change
    // at any time they or the person controlling them wishes for them to.
    
    // Now the way to access the dynamic variables is a bit more difficult than the talk
    // that's been going on around here. We're going to use a "for each" look,
    // to go through the dynamic var names of an object.
    
    // The for each loop allows us to apply a variable name to each piece of information
    // in an array. So let's do something like this:
    
    for (temp.oV: temp.newObj.getDynamicVarNames()) // In case you were wondering, getDynamicVarNames returns an array allowing for a for each loop to have it's way with the text file/
    {
      temp.someArray.add(temp.oV);
    }
    // We can now echo all the information from the dynamic variables in the object because
    // the for each loop going through the values, added each value to "temp.someArray" one value
    // at a time.
    
    // Now that array contains all the information from the object. A simple way to echo all this info.
    // to RC. Like so:
    
    // echo(temp.someArray);
  } 


[zokemon]

The problem with that as being a starting tutorial Stan is, You don't exactly explain what a function or object IS.

[Pimmeh]

I think the most important thing for me, and I think others as well, is to have a list of thingies that I can pull out of my sleeve while scripting... I learned the very basics (compared to dontblock;drawoverplayer shizzle from GS1) from Chandler (cool guy btw ) but I really should find someone to learn the more complex things like setting a UI or a staffblock that you can spawn with a mouseclick if you have a certain weapon ready.
But the most important thing is how the heck I can be able to UNDERSTAND what is happening in really important scripts. This helped me a lot with GS1.

[Crono]

gscript 2 is just more confusing for nublets (hell it confuses me). experiment offline with gscript 1 to learn the basics then move on to gscript 2.

im sure im one of the few here who has this opinion though

[zokemon]

I personally just think it depends the type of person. GS2 was a ton easier to understand for me then GS1 was.

GS2 is easier for people that are in the mindset of object oriented coding. Otherwise, it seems a ton harder then GS1.

[Rapidwolve]

CREATED is when the weapon is first initialized or updated.

[DustyPorViva]

Well if you're joking, then, it means when God said let there be an NPC.
If you're not, then it means exactly what Rapidwolve said. The first time the NPC is 'loaded'(first time a/the[not sure] player enters the level), and is not to be confused with onPlayerenters, which executes each time a/the player enters the level, or like mentioned, the NPC/level is updated.

[Switch]

Originally Posted by DustyPorViva

it means when God said let there be an NPC.

Thanks for being an ass ;( Like we said we have NO backround of ANYTHING x.x

[killerogue]

Originally Posted by Switch

Thanks for being an ass ;( Like we said we have NO backround of ANYTHING x.x

Thank you for being an ass. Because the guy was just joking, then he provided you with a serious explanation.

And you begin to wonder why it is, that I dislike you.

@ Zero, well to be honest...lol..I did't give an explanation because I don't know the word for word definition of an object and I'm not too good at explaining singular things.

[Admins]

onCreated = when the npc is created/added, or you update the script (this behaviour has been changed from GS1, to avoid needing to reset the npc all the time)
onInitialized = called on server restart

[Twinny]

Originally Posted by Stefan

onCreated = when the npc is created/added, or you update the script (this behaviour has been changed from GS1, to avoid needing to reset the npc all the time)
onInitialized = called on server restart

PHP Code:

function onInitialized()
{
  this.whoops++;
  printf("This is the %i time NPC-Server has died",this.whoops);
} 


[Sum41Freeeeek]

I remember the old old gscript bible. It explained everything for newbie scripters.

[PrinceOfKenshin]

I was reading the gscript thing skyld made (very helpful not to mention) but i dont get what you use parameters are for. Someone want to explain?

[killerogue]

Parameters are information based inside the current event. So if I did something like this.

PHP Code:

function onCreated()
{
  temp.chatText = "stuff";
  this.doFunction(temp.chatText);
}

function doFunction()
{
  echo(params[0]);
} 


Take a guess what that would echo?

[PrinceOfKenshin]

Originally Posted by killerogue

Parameters are information based inside the current event. So if I did something like this.

PHP Code:

function onCreated()
{
  temp.chatText = "stuff";
  this.doFunction(temp.chatText);
}

function doFunction()
{
  echo(params[0]);
} 


Take a guess what that would echo?

the temp.chatText = "stuff"; ?

[DustyPorViva]

It's really just passing information from one thing to another. Like passing a note in class. Like with a triggeraction, the destination script has no way of knowing what, say, your level is, unless you send it through the triggeraction. Say you have a gani for hammer, and you have different levels of hammers, level 1, level 2, gold hammer, and different images for each hammer. You can make ONE gani show different images for each level of the hammer, instead of a gani for each level. But, it must be told what level the hammer is, so you pass it through a parameter.

[DustyPorViva]

Well, he's passing a variable, and it's information as a parameter. That means when he goes to echo, he's echoing parameter 0(the first parameter), which is the variable temp.chatText. But, it is echoing the variables information, so it will echo just stuff.

[PrinceOfKenshin]

Originally Posted by DustyPorViva

Well, he's passing a variable, and it's information as a parameter. That means when he goes to echo, he's echoing parameter 0(the first parameter), which is the variable temp.chatText. But, it is echoing the variables information, so it will echo just stuff.

gotcha thats what i mean = ) thanks i will post if i don't get anything else..

[Switch]

Q: Parameters are (?)

[Chompy]

Originally Posted by Switch

Q: Parameters are (?)

Do you even read posts before you post a post by yourself?

PS: Post #70 or #73

[killerogue]

Originally Posted by PrinceOfKenshin

the temp.chatText = "stuff"; ?

Do you even know what a string is? >_> I suggest you try that before you're trying to pass params in functions.

Originally Posted by Switch

Q: Parameters are (?)

I'm sorry, if you can't think to read for yourself then I can't help you as I just posted an explanation on the matter. And Dusty posted 2.

[PrinceOfKenshin]

Originally Posted by killerogue

Do you even know what a string is? >_> I suggest you try that before you're trying to pass params in functions.

yes i do x.x

[killerogue]

Well, your question wasn't very clear so I didn't understand you. Sorry if I insulted you.

[PrinceOfKenshin]

I am still debating if i should master Gs1, because crono posted somewhere, i think on this thread. That learning Gs1 makes it easier to learn Gs2

[Chompy]

Originally Posted by PrinceOfKenshin

I am still debating if i should master Gs1, because crono posted somewhere, i think on this thread. That learning Gs1 makes it easier to learn Gs2

Depends, but learning C++ or something object-based will make it easier for you learning gs2, since gs2 is object-based

[killerogue]

Originally Posted by PrinceOfKenshin

I am still debating if i should master Gs1, because crono posted somewhere, i think on this thread. That learning Gs1 makes it easier to learn Gs2

No, please don't. I don't see how that would benefit you at all...really. Gs1 and GS2 are two, nearly, completely different coding languages.

[DustyPorViva]

I think, to be honest, GS1 may be 'simpler' to understand in concept, but in the end, you'll only be hurting yourself. One way or another, you're going to be learning the basics of scripting and format, so you should just start with GS2. For simple scripting, it's not all that different from GS1, so I wouldn't see the big advantage of starting over GS2.
GS1:

PHP Code:

if (playerenters) {
  playerx=32;
  playery=32;
} 


GS2:

PHP Code:

function onPlayerenters() {
  player.x=32;
  player.y=32;
} 


[PrinceOfKenshin]

Gotcha..I'm just starting a new big project and i realized how much scripting i am gonna have to do (meaning more than normal)

On that note i was wondering if i can make music only play so that not everyone in that level hears it