Git Product home page Git Product logo

cratesenhanced's Introduction

Crates Enhanced

Description:

Crates Enhanced is a new Crates PaperMC plugin that supports custom items, fully configurable crate types and multiple crates for each type.

Here is how the plugin works:
A crate's possible rewards and the key to unlock it are defined by its type. An unlimited amount of types can be created through ingame commands and an unlimited amount of crates can be assigned to a single type. The chance to get a specific reward is determined by its weight. The rewards with more weight are more likely to be earned.

A crate doesn't have to be a chest or an enderchest block, it may very well be a grass block, allowing you to use custom crate block textures via resource packs.

How To Use:

First of all prepare yourself an example key item, can be a custom item or a plain old diamond.
Now use /crates type add <crate-type> to create your crate type.
Now we need to add some rewards to this crate type. Get yourself some rewards that you think would be neat. And add them using /crates edit <crate-type>.
Prepare yourself a nice crate area, you should also put a block on where you want the crate to be, plugin does not place any blocks. Then run /crates create <crate-name> <x> <y> <z> <world> <crate-type>.
All done! Now you can right click to open the crate and get a random reward.

Features:

  • Custom item support
  • Multiple item support
  • Money reward with Vault support
  • Command reward support
  • Multiple crate and crate type support
  • Translation support
  • Freedom to choose your own key for the crates
  • Seperate permission node for each crate type
  • Easy on performance - Lightweight
  • Easy to use GUI to edit crate types
  • Free and open source

Commands:

  • /crates - Displays help.
  • /crates help [page] - Displays help.
  • /crates list crates|types - Displays a list of all crates and types.
  • /crates list rewards - Displays a list of rewards for the crate type in a GUI.
  • /crates create - Creates a crate.
  • /crates delete - Deletes a crate.
  • /crates type add|delete - Adds or deletes a crate type. The held item will be the key for the created crate type.
  • /crates edit - Opens a GUI to let you edit the rewards and the key of the crate type.
  • /crates give key|reward [amount] [silent] - Gives an amount of keys or random rewards of the crate type to the player. When silent, no success message will be printed, hence more suitable for other plugins' use.

Permissions:

  • crates.* - Master permission node for the whole plugin.

  • crates.use.* - Master permission node for using all crate types.

  • crates.view.* - Master permission node for viewing all crate types' rewards.

  • crates.admin - Admin permission node for all editing, creating and deleting.

  • crates.create - Permission node responsible for creating new crates.

  • crates.delete - Permission node responsible for deleting crates.

  • crates.edit - Permission node responsible for editing crate types.

  • crates.give - Permission node responsible for giving keys.

  • crates.list - Permission node responsible for listing crates, crate types and rewards.

Support:

To report any bugs, or to make a feature request please use github issues.

Planned Features:

  • More animation variations
  • More data saving variations
  • Translation support - implemented in v2.1
  • Command rewards - implemented in v2.0
  • Multiple items at a time rewards - implemented in v2.0

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.