Configuration

Main Configuration (config.yml)

General Settings

license: "CODE"
serverName: "survival"
defaultBalance: 0
confirmUi: true

Option	Type	Default	Description
`license`	String	`"CODE"`	Plugin license key
`serverName`	String	`"survival"`	Server identifier used for multi-server sync and notifications
`defaultBalance`	Double	`0`	Initial wallet balance for new players
`confirmUi`	Boolean	`true`	Show a confirmation dialog before completing a purchase

Database

database:
  databaseType: H2
  hostname: "localhost"
  base: "mineLogin"
  port: 3306
  username: "root"
  password: "securepass"
  mongoConnectionString: "mongodb://localhost:27017"

Option	Type	Default	Description
`databaseType`	Enum	`H2`	Database backend: `H2`, `MYSQL`, or `MONGODB`
`hostname`	String	`"localhost"`	MySQL server hostname
`base`	String	`"mineLogin"`	Database name
`port`	Integer	`3306`	MySQL server port
`username`	String	`"root"`	Database username
`password`	String	`"securepass"`	Database password
`mongoConnectionString`	String	`"mongodb://localhost:27017"`	MongoDB connection URI

Tip: For single-server setups, the default H2 database requires no additional configuration.

Redis

redis:
  enabled: true
  hostname: "localhost:25123"
  username: "root"
  password: "securepass"

Option	Type	Default	Description
`enabled`	Boolean	`true`	Enable Redis-based multi-server synchronization
`hostname`	String	`"localhost:25123"`	Redis server address with port
`username`	String	`"root"`	Redis username (set to `null` if no authentication)
`password`	String	`"securepass"`	Redis password

Products

products:
  defaultCategory: "ranks"
  availableProducts:
    - name: "vip"
      price: 10.0
      category: "ranks"
      isQuantity: false
      possibleDiscount: true
      commands:
        - "give {player} minecraft:diamond"
      purchaseDisplay: "<#FFFFFF>VIP"

Option	Type	Description
`defaultCategory`	String	Category shown when the shop opens
`availableProducts`	List	List of products available for purchase

Product Fields

Field	Type	Description
`name`	String	Unique product identifier
`price`	Double	Product price
`category`	String	Category grouping for the shop GUI
`isQuantity`	Boolean	Whether this product can be purchased in bulk
`possibleDiscount`	Boolean	Whether this product can appear in promotions
`commands`	List	Commands executed on purchase. Supports `{player}` and `{quantity}` placeholders
`purchaseDisplay`	String	Display name shown in purchase notifications (MiniMessage format)

Promotions

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

Option	Type	Default	Description
`enabled`	Boolean	`true`	Enable the promotion system
`rechargeMultiplier`	Double	`1`	Multiplier applied when using `/wa recharge` (e.g. `1.5` = 50% bonus)
`productsPerPromotion`	Integer	`1`	Number of products on promotion at the same time
`minimumPromotionPercent`	Integer	`5`	Minimum discount percentage
`maximumPromotionPercent`	Integer	`50`	Maximum discount percentage
`promotionResetDuration`	String	`"1d"`	Duration between promotion refreshes. Format: `1d`, `12h`, `30m`, `60s`

Bonus

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

Option	Type	Default	Description
`enabled`	Boolean	`true`	Enable the daily bonus system
`minimumBonusAmount`	Double	`0.05`	Minimum bonus payout
`maximumBonusAmount`	Double	`0.15`	Maximum bonus payout
`bonusResetDuration`	String	`"1d"`	Cooldown between bonus claims. Format: `1d`, `12h`, `30m`, `60s`

Notifications

notification:
  enabled: true
  purchaseType: ALL_SERVERS
  rechargeType: ALL_SERVERS
  rechargeTitleEnabled: true

Option	Type	Default	Description
`enabled`	Boolean	`true`	Enable broadcast notifications
`purchaseType`	Enum	`ALL_SERVERS`	Purchase notification scope: `ALL_SERVERS` or `SINGLE`
`rechargeType`	Enum	`ALL_SERVERS`	Recharge notification scope: `ALL_SERVERS` or `SINGLE`
`rechargeTitleEnabled`	Boolean	`true`	Display title and subtitle on screen for all players when a wallet recharge occurs

Messages (messages.yml)

All messages support MiniMessage formatting syntax (e.g. <#FF0000> for hex colors).

Available Placeholders

Placeholder	Context	Description
`{player}`	Admin commands	Target player name
`{balance}`	Balance messages	Wallet balance
`{amount}`	Transaction messages	Transaction amount
`{permissions}`	Permission error	Required permission node
`{schematic}`	Usage error	Correct command syntax
`{time}`	Bonus/History	Time remaining or timestamp
`{productName}`	Purchase	Product display name
`{product}`	Notifications	Product name in broadcast

Recharge Title & Subtitle

When rechargeTitleEnabled is set to true, an additional title and subtitle are displayed on screen for all online players during a wallet recharge. These messages are configured separately from the chat notification:

post-recharge-notification-title: "<#00FF00>Wallet Recharge"
post-recharge-notification-subtitle: "<#70FF70>{player} <#00FF00>recharged <#70FF70>{amount}"

Message	Placeholders	Description
`post-recharge-notification-title`	`{player}`, `{amount}`	Title text displayed on screen
`post-recharge-notification-subtitle`	`{player}`, `{amount}`	Subtitle text displayed below the title

The title is shown with a 500ms fade-in, 3 second display, and 500ms fade-out. In multi-server setups with Redis, the title is broadcast according to the rechargeType setting.