Promotions & Bonus

Promotions

The promotion system automatically creates rotating discounts on products. Promotions are generated at regular intervals and apply percentage-based discounts to eligible products.

How It Works

1. At each reset interval, the plugin selects random products from those with possibleDiscount: true
2. Each selected product receives a random discount between the configured minimum and maximum percentage
3. Discounted prices are applied in the shop until the next promotion refresh
4. Promotions persist across server restarts (stored in the database)

Configuration

promotion:
  enabled: true
  rechargeMultiplier: 1
  productsPerPromotion: 1
  minimumPromotionPercent: 5
  maximumPromotionPercent: 50
  promotionResetDuration: "1d"

Option	Default	Description
enabled	true	Enable or disable the promotion system
rechargeMultiplier	1	Multiplier for the /wa recharge command
productsPerPromotion	1	Number of products on promotion simultaneously
minimumPromotionPercent	5	Lowest possible discount (%)
maximumPromotionPercent	50	Highest possible discount (%)
promotionResetDuration	"1d"	Time between automatic promotion refreshes

Duration Format

Format	Duration
1d	1 day
12h	12 hours
30m	30 minutes
60s	60 seconds

Admin Commands

• /wa promotion — view all active promotions
• /wa promotion refresh — immediately regenerate all promotions

Recharge Multiplier

The rechargeMultiplier option modifies the amount deposited by the /wa recharge command. This is useful for running special deposit events:

rechargeMultiplier: 1.5

With the example above, /wa recharge Player 100 deposits 150$ into the player’s wallet.

Daily Bonus

The bonus system gives players a random amount of currency on a cooldown timer.

How It Works

1. Player runs /bonus or clicks the bonus button in the shop GUI
2. The plugin checks if the cooldown period has elapsed since the last claim
3. If eligible, a random amount between minimumBonusAmount and maximumBonusAmount is deposited
4. The cooldown timer resets
5. If the cooldown has not elapsed, the player sees the remaining time

Configuration

bonus:
  enabled: true
  minimumBonusAmount: 0.05
  maximumBonusAmount: 0.15
  bonusResetDuration: "1d"

Option	Default	Description
enabled	true	Enable or disable the daily bonus
minimumBonusAmount	0.05	Minimum bonus payout
maximumBonusAmount	0.15	Maximum bonus payout
bonusResetDuration	"1d"	Cooldown between claims

Bonus States

State	Description
SUCCESSFULLY_REDEEM	Bonus claimed successfully
MORE_TIME_NEEDED	Cooldown has not elapsed
DISABLE	Bonus system is disabled
FAIL	Unexpected error