dim3 Forum

In a game Im gonna make, the one of the charactors has an
abillity:

Whenever you press a certant button while in the air,
the entire charactor shoots forward like a bullet, not effected by gravity
untel a cerant point or hits somthing.

How would I do the "shoot like a bullet" part?

Freeze the player input, set the max velocity really high, use the obj.motionVector.alterSpeed() function, wait, reset the speed, etc, allow player input again. You shouldn't have to worry about gravity. At those speeds it won't have much effect. Or you can set it to 0 if you like. Try it out.

Please, I got these things directly from the docs in 2 minutes. Read the docs.

Ok thanks.
I DO read the docs, though. Or at least I try.
But in them, I do not know where to start.
Is there some place I should start on them?
I do not get a thing I read in the docs.

The docs are basically just a list of functions and how to use them. Do as follows:

1.) Decide what you want to script.
2.) break it up into actions you want done during the process.
3.) Look in the docs for these actions, which you'll now call api.

Example:

I want to script a movement while the player is in air.

How will I break it up? Ok, here's how. First, I'll retrieve the key press in the player.js. Then, I'll check if the player is in the air. If he or she is, Stop the player from being able to press keys and shoot the player forward.

What functions/events will I need to keep in mind? From what I can see after looking at the docs, I'll need obj.status.air to check if I am in air, DIM3_MESSAGE_FROM_KEY_DOWN to retrieve the button press, obj.status.freezeInput() to freeze the player input, and obj.motionVector.alterSpeed() to change the speed. I might have to change the max player speed too, so I'll want obj.forwardSpeed.air too.

Player input? What is that?

The keys you press.

I did that once. It's not hard at all. Gotta see if I can dig up the script somewhere.

Instead, why don't you let him do it.

OK. I found the script.
Here's what I did:
1. Set up a button to one of the player messages (I used player_1).
2. In the playerMessage function, in the switch(id) part, I added "case 1:" to get messages from the player_1 button.
3. Now it checks if the player is in air using which will return 0 if the object is not on ground.
4. Now it changed the forward speed, acceleration and deceleration, sets the vertical speed to 0 (to prevent falling down) and
5. starts a chain which starts another function that resets the above values to their default after a certain time.
6. If you want it to do that when you hit something, just get the DIM3_EVENT_COLLIDE event and reset the values that way.

You will want to set a variable to prevent the player from pressing the button over and over again.
Do something like:
and set airAttack to true when the button is pressed and to false when you land again or hit something.

Hope this helps you.

Yes it does. Thank you Bink and Teh1ghool.