PortableCrates

A PocketMine-MP Crates Plugin that lets players open their crates in place without having them teleport to a warp

Commands:

How to Set up a Crate

Create a crate

First we'll need an Item that is going to be our crate, in my case im going to give myself a chest with custom name and lore using the following command:

/give GrosserZak chest 1 {display:{Name:"§r§6§6lRare §fCrate",Lore:["§r", "§r§fContains §6Rare §fItems"]}}

Then we hold our future crate item and use the command /pcrate create <crateName> to create our crate.
In my case im going to use /pcrate crate rare.
Now we can get rid of this item and start adding our rewards to our crate.

Adding Rewards

To add rewards to our crate we're going to use the /pcrate add command.

For example:
Lets add 8 EnderPearls with 75% drop rate chance. We'll need to hold 8 EnderPearls and type the following command: /pcrate add <crateName> 75 in my case /pcrate add rare 75 NOTE: Im not specifying the amount field because I wanted to add just 8 EnderPearls and that's the amount that Im holding.
And there we go!
We've added 8 EnderPearls with 75% drop rate chance

We can check its index with the command /pcrate info <crateName> in my case /pcrate info rare

Now I'm going to add x1 Uncommon Crate with 20% drop rate chance.
So as before I'm going to hold the uncommon crate and use the command /pcrate add rare 20

Once we've finished setting up our crate we can give it to ourselves with the command:
/pcrate give <crateName> all:<player> [count] in my case /pcrate give rare GrosserZak
Now we can open our crates

Removing Rewards

To remove rewards from a crate we'll need to see the reward index that we want to remove from the crate. We'll need to use the command /pcrate info <crateName> to see all reward indexes.
(Note: The indexes of the rewards are their listing numbers)
Once we've found the reward index we want to remove we'll need to use the command /pcrate remove <crateName> <rewardIndex>

Delete a crate

Simply just use the command /pcrate delete <crateName>

GiveOnWorld Function

This function ables to give crates on the world where the server administrator runs the /pcrate give command.

Note: This function is not available from console!

For example:
The function is enabled:
[Admin] GrossserZak is in world "FactionLands" with 47 players
[User] GrossTest is in world "Hub"
If GrosserZak runs /pcrate give <crateName> all, himself and the 47 players, that are in the world he's in, will receive the crate and GrossTest will get nothing.
Otherwise if the function was disabled all players would receive the crate

Drop Protection

This function allows to lock the dropped rewards in case the player had his inventory full

The dropped rewards will be locked for 1 minute.
What does it mean?
The player who dropped those rewards will be the only one who can pick them up.

NOTE: After 1 minute anybody can pickup the rewards, so be fast!

TODO

• [ ] Add multi language support

Note: Any suggestion is appreciated

Contacts

Telegram: @zGross
Discord: Zak_#0998
For issues, open an issue on the GitHub page