https://github.com/whynotmax/simplelootbox
Simple lootbox plugin with a variety of features. Recode of the most minehut servers' lootboxes.
https://github.com/whynotmax/simplelootbox
Last synced: about 1 year ago
JSON representation
Simple lootbox plugin with a variety of features. Recode of the most minehut servers' lootboxes.
- Host: GitHub
- URL: https://github.com/whynotmax/simplelootbox
- Owner: whynotmax
- Created: 2025-02-03T11:48:30.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-02-05T18:24:45.000Z (over 1 year ago)
- Last Synced: 2025-02-05T19:37:29.868Z (over 1 year ago)
- Language: Java
- Size: 148 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# SimpleLootbox - A plugin every minehut server needs!
SimpleLootbox is a plugin that allows you to create custom lootboxes with custom rewards. This plugin is perfect for any
server that wants to add a little extra fun for their players. You can create as many lootboxes as you want and
customize them to your liking. You can also create custom rewards for each lootbox, so you can give your players the
chance to win some awesome prizes!
## Features
- Create custom lootboxes with custom rewards
- Customize the chance of getting each reward
- Customize rarities for each reward
- Live preview of lootboxes in-game
- Live drops (see "What are live drops?" below)
## Commands
- `/lootbox create ` - Create a new lootbox
- `/lootbox delete ` - Delete a lootbox
- `/lootbox list` - List all lootboxes
- `/lootbox give ` - Give a player a lootbox
- `/lootbox give all ` - Give all online players a lootbox
- `/lootbox edit ` - Edit a lootbox
- `/lootbox preview ` - Places a block display of the lootbox at the player's location (*)
(*) Needs additional testing before release
## What are live drops?
Live drops are a feature that allows you to see what other players are getting from their lootboxes in real-time. This
feature is perfect for streamers or YouTubers who want to show off the lootboxes on their server. You can enable or
disable live drops in the `config.yml` file.
## Permissions
- `simplelootbox.admin` - Allows access to all commands
## Support
If you need help with the plugin or have any questions, feel free to join
the [Discord server](https://discord.mzcy.dev/) of [whynotmax](https://github.com/whynotmax)! We're always happy to
help. Also, feel free to open an issue on the [GitHub repository](https://github.com/whynotmax/SimpleLootbox) if you
encounter any bugs or have any feature requests.
## Installation
To install the plugin, simply download the latest version from
the [releases page](https://github.com/whynotmax/SimpleLootbox/releases) and upload it to your server's `plugins`
folder. Make sure to restart your server after installing the plugin.
## Building from source
If you want to build the plugin from source, you can do so by cloning the repository and running the following command:
```shell
./gradlew clean shadowJar
```
The plugin JAR file will be located in the `plugin/build/libs` folder.
## Developer API
SimpleLootbox has a developer API that allows you to create custom lootboxes and rewards programmatically. You can find
the API documentation [here](https://github.com/whynotmax/SimpleLootbox/wiki/Developer%E2%80%90API).
## Contributing
If you want to contribute to the plugin, feel free to open a pull request on
the [GitHub repository](https://github.com/whynotmax/SimpleLootbox). We're always looking for new ideas and
improvements! Make sure to read the [CONTRIBUTING.md](.github/CONTRIBUTING.md) file before contributing.
## License
This project is licensed under the MIT License - see the [LICENSE](.github/LICENSE.md) file for details.