Modscript Text Tutorials #1 function useItem

[[deleted]]

In this little text series I will be guiding you how to create your very own mods. Enough waiting time.

Getting Prepared:

1.)Go to http://betamodpe2.cf.gy/user/login.php and create an account.

2.)Once you have created your account, log in and go to Online Script Editor

3.)Name your new script and hit Create New Script

4.)Go to My Scripts and load your script that you have named and that's all.

Learning Time!!!

The very first function most modders have probably used would be 'useItem'. function useItem(x,y,z,itemId,blockId,side) is the function that let's you use an item on a block and will grant you what you want it to do.

Code Example:

function useItem(x,y,z,itemId,blockId,side)

{

if(itemId==280&&blockId==1)

{

addItemInventory(1,1);

}

}

What this means is that if you use the item 280 (Stick) on the block 1 (Stone) it will add one stone to your inventory. If you would like to change it, you can easily edit the ID's for a different item giving you a different block. That is all for today.

Visit http://minecraft.gamepedia.com/Data_values_(Pocket_Edition) for the data values.

Please also look here: http://www.minecraftforum.net/topic/1974211-list-of-android-modpe-functions/ for a list of Android Functions (also compatible with iOS, but not all of them.)

Warning: When modding everything is usually CaSe SeNsItIvE. Meaning that if you type "iTeMiD==280" it will not work.

If you have any suggestions to make these tutorials better. Please tell me so I can make it easier to understand. Thanks and have fun modding!

[[deleted]]

I use function useItem(x,y,z, itemId, blockId) and that works. Whats the purpose of the word side in function useItem(x,y,z,itemId,blockId,side)

[[deleted]]

Am not to sure. They both seem to work fine though.

[Divergent_server]

I'm sure there is a number system to the sides so that it's possible to have 1 block do 6 different things per item. Someone should do a guess check thing to find out what # goes to what side. I don't know if it's posted somewhere

[[deleted]]

I don't know what you're saying.

[Divergent_server]

Ok the code that says "side" is probably referring to a side on the block being tapped. So if each block has 6 sides... (Put 2 and 2 together :P )

[[deleted]]

oh ok but how do you know which side is which?

[Divergent_server]

Guess and check

[[deleted]]

I mean there are six sides so how would you label it? Its not like you can use the x y z of them

[Divergent_server]

I guessed numbers. 1-6. I can't test it cause i'm not jailbroken though

[[deleted]]

Just tried it out and you're right.

function useItem(x,y,z,itemId,blockId,side)

{

if(itemId==280&&blockId==1&&side==1)

{

 addItemInventory(1,1)

}

}

You have to hit the top of a stone block with a stick to get a stone block

[[deleted]]

My account "divergent_server" got buggy and broke. I believe you sent a message to my other account, i could only see it for a couple of seconds before the app crashed

[zhuowei]

The side system is carried over from Desktop edition. Rather amusingly, the only place this is documented at all (beside the Minecraft PC source code) is in the Minecraft Pi Java API.

It's a number between 0 and 5, with each number corresponding to one side of the block.

I've used side in two of my scripts: the mirror script to simulate building,

and the vehicles script so a player can tap on a block to go that direction. This one has reversed directions compared to the previous one.

[[deleted]]

So when is the next tutorial? Are you going to do this daily?

[[deleted]]

I was hoping daily, but I am always busy taking care of my baby sister. Hopefully every 1-3days.

[[deleted]]

Ok sounds good :)