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 View all reward infos, indexes and probabilities of an existing crate

create Creates a new crate (You must hold an item that we'll be the crate)

delete Deletes an existing crate

add [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 Removes a reward by index from an existing crate (Indexes are listed in list subcommand)

give all: [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"]}}

Rare Crate

Then we hold our future crate item and use the command /pcrate create 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 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

x8 EnderPearls added with 75% drop rate chance to Rare Crate

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

Rare Crate infos

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 x1 Uncommon Crate added with 20% drop rate chance to Rare Crate

Once we've finished setting up our crate we can give it to ourselves with the command:

/pcrate give all: [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 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

Delete a crate

Simply just use the command /pcrate delete

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 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