EasyCrates - Choosable rewards 2.3.4

SUPPORT: https://discord.gg/DWWDutaGFT

TEST SERVER: Open a ticket

EasyCrates

Crate blocks where players choose their reward, or spin for a weighted one, with physical and virtual keys.

EasyCrates crates are blocks you place in the world. By default a player with a key right-clicks the crate, picks the reward they want from a menu and confirms, so they always know what they get. Set a crate to spin mode and it rolls a weighted random reward with an animation instead.

Features

• Crate blocks where players choose the reward they want, or spin for a weighted one.
• Physical keys as items and virtual keys stored per player.
• Daily crates on a timer, shown drop chances and bulk opening of 10 or 100 keys.
• Guaranteed rare reward after a dry streak.
• In-game crate editor and reward editing.
• Holograms through DecentHolograms, FancyHolograms or HolographicDisplays.
• Developer API and PlaceholderAPI placeholders.

Requirements

• Paper, Purpur or Folia 1.21 or newer, Java 21 or newer.
• No required plugins.
• Optional: PlaceholderAPI, DecentHolograms, FancyHolograms, HolographicDisplays.
• Internet access on startup. The plugin checks its license online, so the server must be able to reach the license server.

Installation

1. Put the jar in your plugins folder.
2. Start the server once so the config files are created.
3. Adjust the files in the plugin folder to your liking.
4. Restart the server.

Commands

• /crates get <crate>: Gives you the crate block to place.
• /crates givekey <player> <crate> [amount]: Gives virtual keys.
• /crates givephysicalkey <player> <crate> [amount]: Gives key items.
• /crates removekey <player> <crate> [amount]: Takes virtual keys away.
• /crates givekeyall <crate> [amount] [permission]: Gives virtual keys to every online player, or only those with a permission.
• /crates editor: Opens the crate editor.
• /crates preview <crate>: Opens a crate's reward preview.
• /crates open <crate>: Opens a spin crate.
• /crates multiopen <crate> <amount>: Opens several keys at once.
• /crates openreview <player> <crate>: Opens a crate's menu for another player.
• /crates history: Shows recent crate opens.
• /crates import [dry] [delete]: Copies player data from file storage into MySQL.
• /crates import excellentcrates [overwrite]: Imports crates from ExcellentCrates. Needs excellentcrates-import: true.
• /crates reload: Reloads the config and every crate.

Configuration

Every option is explained in the config files inside the plugin folder.