Scripting Tutorial
I'm going to try making an easy-to-understand-tutorial.

All of this will be done on POKESCRIPT, the program created by Irish
Witch.
Note: This tutorial was transfered from pc, and may have a few text errors. But, the information is correct.


Now then, let's begin.

Starting Off

The first thing needed to know about scripting is how to write text.
It can't simply be written as "blah blah blah",
It needs to be written in a special format.

Let's just say for all intentional purposes, we want to say this text.

Now, we need to write it using slashes (\) and a certain character to
indicate where that is in the talking. Observe.

You can see the "\n" and the "\p". \n represents something like
"continues on next half of box".
For example, it would look like:

\p represents "new box"

I am a pokemon trainer from Pallet
Town.



There is also "\l" which is kind of the same as \p, but you will notice
the difference when you actually make a script.

Now then, we seem to be done with that. Moving on.


Simple Script

For this tutorial, when I say simple script, I mean something not too
compicated, but still includes a little bit complication. (For
beginners)

Okay, when I say simple script, I always think of the professor Oak's
aid script.
It works like this:
-when you talk to the aid, he will say hello, and give you an item
(potion)

Now then, on to your first script.
To begin, we must open notepad, and type the following:

That small bit of code represents the beginning of a script.
ALWAYS PUT THAT!

After that, place an offset.

It really does not matter what you write there, but I usually say
something like that.

Okay, so we want the aid to talk to you, so we have it say a message.
But before that, we need to put the following:

The lock means that the character will not move around while they're
talking to you.
Faceplayer is self-explanitary. (Face the player)

So, on to the message.

(again, the offset does not matter.)

We shall have the aid say:

[PLAYER] shows the name of the player.
HOWEVER
Only use [PLAYER] in a program called advance text.
When making an actual script, we use the offset "\v\h01" That will make
the name show up.
So, this is what it will look like:

Okay, the "$aidtalk 1 = " is to represent that that offset is this
text.
The boxset 6 means that it is a normal text box.
(If you wanted a yes\no script, use boxset5)

Now, for the potion.
We will use the giveitem command to give it.
The offset for the item potion is

.
before using an offset for an item, song, pokemon, character, or warp,
use 0x.

So, we use

The 1 just tells that we're getting 1 potion.

But there is one more thing we need. To prevent this event from being
repeated, we must use flags. Flags basicly tell whether or
not this has happened.
A flag is written in the form of: < 0xFLAG > Where it says FLAG, we
must replace it with a number. The numbers between 200-299, and 800-899
are okay to use.
EG. 0x200

But we can't simple write "flag 0x200", we need to say what about it we
want. Setflag, Clearflag, and Checkflag are the only things we can do.
(so far as I know) Setflag means that the player has done the event.

And, this is our complete script:

The reason we put the aidtalk at the bottom is becuase it compiles
better, and there usually aren't any glitches. Do that with all of your
scripts. EVERYTHING WITH AN OFFSET $ GOES AT THE BOTTOM.

And that, is a simple script!
Now you can write it to your rom using pokescript.
(See Irish Witch's tutorial for explanation)

Now then, you have made your first simple script!

Now, let's get a little more complex.
We'll use this same script, just edit it.

Now, let's say we want the aid to be activated by instead of being
talked to, when the player steps in a certain spot. The way we will do this
is by adding "Applymovement" to our script. So, instead of putting
"Faceplayer" we will put "Applymovement".

Like this:

Now, the fist thing you may notice is that we no longer have the Lock
command. The reason being is that is we lock the person, well, really he
can't move if we lock him.

Next, you'll notice that we put an 0x01 after applymovement. That
indicates that the person with the people number 1 in advance map will move.

Then we have our offset. It's just a randomly defined thing, as usual.

And last, we have our Pause 0x30. That represents that the script will
wait for the aid to take three steps before continuing. Use 0x10 to
represent one step, 0x20 for two, and 0x30 for three.

As usual, we have Release. Like any script, end it with release. If I
haven't already said it, END EVERY SCRIPT WITH
release
end

But just "Applymovement" won't do everything. We need to fill it in.

Here is a list of all the movements in fire red.




S

These are the offsets for basic movement:

So, for this script, we'll have the aid move three steps right over to
the player.
And since we'll be using items, we'll need a list of them.

As we see, potion is 0xD

It will look like this:

At this point, you may be a little confused. We put the 1 for the same
reason that we do in a text script.

The simicolon ( is the same thing as and equals. (=) We just use
simicolons in movement scripts.

The #binary is just how we begin a list of movements. EG. 0x13 0x13
0x13

And last, the 0xFE. That's how we end a list of movements. 0x13 0x13
0x13 0xfe
IT MUST BE AT THE END OF EVERY LIST OF MOVEMENTS.

You may aso be wondering why we changed the $done sequence to just a
release end.
The reason for that is because now, we're not talking to the aid. We're
stepping on a certain point on the map that will activate the script.
And we don't want for it to be that we step in the spot and all of the
sudden, the text "Hello" shows up on the screen! So, we just replace it
with release, and end. That will make it so nothing happens when we
step there.

Now it's done! The event with the number 1 will move. Just set this
script in advance map, and for the var values, put 03 in the fist one, 50
in the third one, and 40 in the fourth one. That will make your script
run correctly.


Follow me Script
Those simple commands are nice and all, but a game gets boring when you
use all simple scripts. So, let's get a little more difficult.

Let's take for example, one of the fist scripts in gold & silver. The
one where if you try to leave, the lady, Mary I think, will walk over to
you and stop you and make you come with her back to her original
location until you see the professor. And when this script happens, the
follow me song plays.

The way that this is done, would look kinda like this.

So, there's our music script. Applymovement 0xFF will move the player.
We have $mw2 for the player's move because we want the player to follow
mary, so we give it the same movement. The #raw 0x33 after playsound
is there just to prevent the game from freezing. And just for your
knowledge, 'fadesound' makes the song fade to the map's original song. If
you don't put fadesound, the song will continue playing even when the
script ends.

For everyone reading the tutorial, if you want an actual follow me
script, you can use this.

You can compile that into your game, and it will work.
Just take out the 'right's and 'left's

.......well..... what now?........ I guess a really complex script....
But, what else is there to cover?.....
Have I mentioned giving pokemon?.....
No, I don't think I have.

Very well, Giving Pokemon
First, we need our list of pokemon.

Okay, whew! There's our list.
So, if we want the player to recieve a pokemon from a certain pokemon,
we need to do it like this.
givepokemon 0x[pokemon] 0x[level] 0x[held item]
of course you need to fill in what I put in []
HOWEVER, IF YOU PUT 0x BEFORE YOUR NUMBER, YOUR RESULT MAY BE SOMETHING
OTHER THAN YOU EXPECTED.
I RECOMMEND JUST PUTTING THE PLAIN NUMBER OF THE POKEMON.
givepokemon 394 50 8B
That will give me a level 50 gardevoir that's holding an oran berry.




Sample:

And that's how you do a givepokemon script. Note: Generally, you will
want to put the command 'givepokemon' towards the end of the script to
ensure success.
Also: When you get the pokemon, there will not be a small message
saying "You obtained a Squirtle" or anything like that. If

you want that, you should make a message saying that.
And for now, I suppose that's it.
I already have a tutorial on trainer battles, so maybe I don't need it
here.

Well, I guess.

Trainer Battles

That script would be a perfect trainerbattle script. The '1' after
trainerbattle I just always put there. 0x001 is for the
PET ID of the trainer. $before is what the trainer says before the
fight, and $after is what they say when they lose. If you
want the script to continue after the battle, do this:

You can pretty much do anything you want with the after sequence. Of
course, it does NOT NEED to be "further". It could be
anything you want.

So for now, that's my whole tutorial. If there's something I missed,
let me know, and I'll cover it.
Hope this helps!

Warping

To warp the player to another location, simply put the command:

However, the script will usually end after a warp is done.

Egg Script
To give the player an egg of a specific pokemon, the command is

Replace the pk1&2 with the pokemon's hex number.



******************NOTICE******************

This tutuorial was made by Foullump, i DID NOT make this, i just posted it here to help people understand Scripting..

~~Scripting Tutorial ©2007 Foullump~~

Thanks for posting this! Now I can fulfill my dream to become a scripter.

Yes, I do believe this will help many new hackers! Congratulations on the tutorial DP.