Percy's Scripting Guide

Hey, there! I'm Percy, and I'm about to teach you scripting. Let's move on since I'm bad at introducing myself.
I'm pretty sure you already know the meaning of scripting, right? Well, then, soon-to-be-scripters. Let's start learning scripting!



Let me explain line by line.
#dynamic 0x(free space offset)
With #dynamic, you simply state a start offset, say 0x800000, and XSE will automatically insert it in the first suitable instance of free space past that offset. (Said by Spherical Ice) And, in order to have an offset, open FSF, and open your ROM with it. Click Search and you'll gonna have an offset that is safe to use, whatsoever.

#org @pointer
This part is the pointer. It can be anything:
@iamcool etc.
Just remember not to duplicate any pointers, and don't include spaces, too!

lock
Easy, it locks the player, so it can't move and such.

msgbox @hello 0x6
If you want a message box to appear use the msgbox command. The @hello part is where we'll gonna store our text. The 0x6 part decides what message box it will show. There are 5 kinds of message box:



Now, back to explaining:

release
It releases the player from the lock command so that you can move again.

end
It ends the script. You must include this in every script you make.

#org @hello
Pointer to your text.

= Hello to you!
Ta-da! This is the text. In your XSE, press CTRL + T. It opens up the Text adjuster so you don't need to add the \n, \l, or \p. If \n is used, the message box scrolls up, same as the \l, but you may only use \l if you have used \n. \p is for new textbox. Now make your own basic scri


This is the second part of scripting I learned, and when you learn it, you're gonna have fun with it. Anyway, let's start.
There! If you don't understand some of the old commands we've done last lesson, just scroll up, and you'll see.
Let's start explainin'

msgbox @1 0x5
Remember what 0x5 are for? Yes, for Yes/No message boxes. The message box is accompanied with one command ...

compare LASTRESULT 0x1
Get's the lastresult and the 0x1 beside it means yes. (said by tajaros)

if 0x1 goto @2
If you pressed yes, it will goto @2
If you pressed no, it will ignore this part, and continue to @3.
There!
Start making Yes/No scripts!

[a id]compilescript[/a id]

If you have some trouble please post it here!


PS: I'm gonna post lesson 3 soon enough! ;)

Percy said:

#dynamic 0x(free space offset)
This part asks for what free space we'll use. This is the part where our script is contained. And, in order to have an offset, open FSF, and open your ROM with it. Click Search and you'll gonna have an offset that is safe to use, whatsoever.

Click to expand...

That isn't how the #dynamic operative works, you're thinking of #org 0x8(offset). With #dynamic, you simply state a start offset, say 0x800000, and XSE will automatically insert it in the first suitable instance of free space past that offset.

Spherical Ice said:

That isn't how the #dynamic operative works, you're thinking of #org 0x8(offset). With #dynamic, you simply state a start offset, say 0x800000, and XSE will automatically insert it in the first suitable instance of free space past that offset.

Click to expand...

Haha, sorry. And, thanks, I'll edit the first post.

When you were explaining the #org @pointer you said that anything can be the pointer and you put #iamcool. I understand that you probably meant @iamcool but that would probably confuse somebody new to scripting.

Lesson 3 is posted, everyone!

Could you add how to edit inserted scripts in the fastest way? for example if i compile a scipt and then found out i forgot something, how to edit it the fastest way?

tzujm33 said:

Could you add how to edit inserted scripts in the fastest way? for example if i compile a scipt and then found out i forgot something, how to edit it the fastest way?

Click to expand...

Well, then edit the compiled script, and then hit the compile button, that should do it.

Percy said:

Well, then edit the compiled script, and then hit the compile button, that should do it.

Click to expand...

Yea but that could overwrite something. If you add a dynamic offset to the script hunk you are editing then doing the same to anything that points to the script so that all of your pointers are fixed. Something along the lines of this:

To this:

I added my own custom tutorial on how to put scripts into ROM. Here: http://www.pokecommunity.com/showthread.php?t=343282#compilescript