# RewardSystem

## RewardSystem

![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg) ![Kotlin](https://img.shields.io/badge/kotlin-100%-blue)

## What is this plugin?

RewardSystem is a popular versatile Minecraft plugin designed to enhance server gameplay by providing customizable rewards when players defeat mobs. The plugin monitors player damage contributions to each mob and distributes rewards based on various configurable criteria.

## Wiki

For detailed informations, please refer to the our [Gitbook Wiki](https://senyigityunusemres-organization.gitbook.io/rewardsystem/readme/updates).

## Features

**Dynamic Reward System**: Customize rewards based on mob types, player participation, and damage dealt

**Mathematical Expression**: Create complex probability-based rewards using mathematical expressions with player variables

**Multiple Reward Tiers**: Configure different reward tiers based on player participation and damage

**Special Last Hit Rewards**: Provide unique rewards to players who deliver the final blow

**World & Region Filtering**: Restrict rewards to specific worlds or regions using WorldGuard integration

**Custom Messages**: Configure detailed reward messages with color codes and formatting

**Minimum Damage Requirements**: Set minimum damage thresholds for reward eligibility

**Mob Name Filtering**: Trigger different rewards based on custom mob names

**PlaceholderAPI Support**: Utilize player placeholders in reward calculations and messages

**Debug Mode**: Comprehensive logging options for troubleshooting

## Buying and License

RewardSystem is popular and reliable source. This resource has **+45 paid customers**.

**Marketplace**: Available on select Minecraft plugin marketplaces:

* [BuiltByBit](https://builtbybit.com/resources/reward-system-works-with-custom-mobs.24629/?ref=discover)
* [Polymart](https://polymart.org/resource/rewardsystem.4635)

## Installation

1\. Download the latest release from GitHub or your preferred marketplace

2\. Place the JAR file in your server's plugins directory

3\. Restart your server

4\. Edit the configuration files in the plugins/RewardSystem directory to customize your reward system

## Configuration

The plugin uses a YAML-based configuration system that is highly customizable. Here's a basic example: [Example Config File](https://github.com/YunussEmree/RewardSystem/blob/kotlin/app/src/main/resources/config.yml)

## Permissions

rewardsystem.admin.resetcooldown - Permission to use reset cooldown command

rewardsystem.reload - Permission to reload the plugin

## Commands

/rewardsystem reload - Reloads the plugin configuration

/rewardsystem cooldown reset - Reset cooldown for a player for a specific mob

## Support

For support, feature requests, or bug reports, please open an issue on GitHub.

## License

This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/YunussEmree/RewardSystem/blob/kotlin/LICENSE/README.md) file for details.

## Contributors

[Yunus Emre Şenyiğit](https://github.com/YunussEmree) [MetuMortis](https://github.com/LiberaTeMetuMortis)
