PortableCrates

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

Commands:

Command	Description	Usage	Alias
/portablecrate	Main Command	/portablecrate	/pcrate

SubCommand	Description
help	View all subcommands
list	View all existing crates
info <crateName>	View all reward infos, indexes and probabilities of an existing crate
create <crateName>	Creates a new crate (You must hold an item that we'll be the crate)
delete <crateName>	Deletes an existing crate
add <crateName> <probability> [amount]	Adds a reward to an existing crate with a drop rate chance from 1 to 100. You can also specify the amount of the item you want to give out or you can leave that field empty to get the amount directly from the item you're holding (You must hold the item you want to add as reward)
remove <crateName> <rewardIndex>	Removes a reward by index from an existing crate (Indexes are listed in list subcommand)
give <crateName> all:<player> [amount]	Gives 1 or a defined amount of crates to a defined player or to all online players
toggle	Toggles GiveOnWorld function
reload	Reloads config files

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