🎁Rewards System

How rewards work and how to tune them.

The Rewards System defines the prizes that can appear in the DealOrNoDeal game.

Each box in the game contains one reward from the configured reward pool. During the game, players open boxes and eliminate rewards from the board until they accept a banker offer or reach the final box.


How Rewards Work

At the beginning of each game:

  1. The plugin loads all rewards from rewards.yml.

  2. Each reward is randomly assigned to a box.

  3. Players open boxes to eliminate rewards from the board.

  4. The remaining rewards influence the Banker's offers.

The reward pool directly affects the gameplay experience and the value of banker offers.


Rewards Configuration File

All rewards are defined in the following file:

/plugins/DealOrNoDeal/rewards.yml

This file contains the list of all possible rewards used in the game.


Basic Structure

Rewards are defined inside the available_rewards list.

Example:

Each entry represents one reward that can be assigned to a box.


Reward Types

The plugin supports two reward types.

Type
Description

MONEY

Gives a money reward using the configured economy system

ITEM

Gives a Minecraft item as a reward


Money Rewards

Money rewards give the player a specific amount of currency.

Example:

If the player wins this reward, they will receive 10,000 units of the server currency.

The currency is provided by the configured economy system (for example Vault).


Item Rewards

Item rewards allow servers to give physical items instead of money.

Example:

Explanation:

Setting
Description

material

Minecraft material name

amount

Number of items given to the player


A standard DealOrNoDeal game uses 24 boxes.

Because of this, it is recommended to configure 24 rewards.

Each reward will be assigned to one box during the game.

If the number of rewards is incorrect, the game may not start.


Designing a Balanced Reward Board

To create an engaging gameplay experience, it is recommended to include:

  • very small rewards

  • medium rewards

  • high rewards

  • one or two extremely large rewards

Example reward distribution:

A wide range of rewards creates tension and makes the Banker offers more interesting.


Editing Rewards In-Game

The plugin also provides a reward editor GUI that allows administrators to manage rewards directly in-game.

The reward editor can be opened using the command:

When this command is used, a graphical interface (GUI) will open showing the entire reward pool currently loaded by the plugin.

Inside this interface administrators can:

  • view all configured rewards

  • add new rewards

  • remove existing rewards

This system allows server administrators to modify the reward pool without manually editing the rewards.yml file.

Changes made through the GUI will automatically update the reward configuration.


Applying Changes

After modifying the rewards.yml file, reload the plugin configuration:

This will apply the updated reward configuration without restarting the server.

Last updated