12. Bonus Button

[BUTTONS] 12. BONUS BUTTON

Allows you to add the Bonus (specified by the admin amount of conditional units) to the selected variable (for example, balance).

〰️〰️〰️〰️〰️〰️〰️〰️〰️〰️
🔌 Plugins:
➕ 13. Bonus to Ref. Parent
➕ 14. Macros and Expressions for Buttons
➕ 38. Bonus in a Global Variable
➕ 25. Conditions
〰️〰️〰️〰️〰️〰️〰️〰️〰️〰️

☞ To add bonus button go:
🎛 Buttons Editor
⚪️ Select the button
⚪️ Press *️⃣ (Settings)
⚪️ Assign Bonus

▪️ User must press the button in order to receive the bonus.

▪️ The frequency (period) of increment for the user to receive the bonus is specified by the admin while adding a bonus to the button (in hours-integers or decimal numbers).
➠ Example
Period 1.5 is equal 1 hour 30 min.
Period 0.0025 is equal to 1 min.

▪️ The bonus size can be a decimal fraction (0.01).
❗️ Here and in any bot's functions use a period ( . ) to separate the decimal part.

▪️ Admin is the one to create the message for the case of successful user bonus reception.
▪️ Same as a message for the case of the bonus has not been accrued for any reason.

❗️ In the Basic version the function, maximum interval between bonus increment is 24 hours.
❗️ In an Advanced version this time can reach up to a week.

▪️ Each button provided separately for one bot.

▪️ Setting of the bonus and time interval can be done in the
properties (*️⃣) of the button.

▪️ You can use special macros in bonus button messages. Macros showing this button's cool down time:
%cooldownh% - hours
%cooldownm% - minutes
%cooldowns% - seconds

❗️ Macros values are saved after the first click on the button, if you then change the bonus time, you will need to wait until the end of the previous period - the macros will NOT show the new time immediately.

▪️ In bonus button messages you can use expressions. To convert hours+minutes in minutes use:
➠ Example
{%cooldownh%*60 + %cooldownm%}

▪️ A postfix:
_v
is available for the bonus button.
If you add it to the variable name in the macro, the bot will show the amount by which this variable has changed after receiving the bonus.
➠ For example:
%varname_v%

▪️ In bonus messages you can use macros
%bonus%
it will show the amount of bonus user getting. Its use is justified in the cases when the bonus is set through an expression with a random number (It becomes available after activation of the plug-in
➕ Macros and Expressions for Buttons).

❗️ By default, Bonus increment can not be applied to Admins account. In order to check whether new button is operational or not use any other non-admin's account or send command
/bonusforadmin
to your bot to turn on this option.

❗️ NEGATIVE accrual values can be assigned to the button, allowing you to decrement of the funds in the balance of the user account, as well as ZERO value of the bonus time interval, allowing user to press the button as many times as he wants.

To add feature go to your bot:
☞ 🔐Admin | 🧩Extensions | 📂Buttons
〰️〰️〰️〰️〰️〰️〰️〰️〰️〰️
👾 For 1 bot (Individually)