Economy & Expiration

Economy

Economy controls paid actions: creating a team, buying member slots, and renewing expiration.

economy:
  enable: true
  economy-type: ITEMS
  cost-for-create-team: 100.0
  cost-for-one-expiration-day: 100.0
  default-members-slots: 10
  maximum-members-slots: 20
  cost-for-one-slot-of-members: 100.0

Economy Types

Type	Requirements	Behavior
ITEMS	—	Uses a configured ItemStack as currency
VAULT	Vault + economy plugin	Withdraws money via Vault

ITEMS mode

Configure economy-item (material, display name, lore). Admins can distribute the item with:

/teamadmin economyItem <amount>

Paid Actions

Action	Cost config	Where
Create team	cost-for-create-team	/team create
Extra member slot	cost-for-one-slot-of-members	Dashboard UPGRADE_MEMBERS
+1 day expiration	cost-for-one-expiration-day	Dashboard EXPIRATION_UPDATE

Member Slots

Option	Default	Description
default-members-slots	10	Slots when a team is created
maximum-members-slots	20	Hard cap for upgrades

Invites and accepts fail when the team is full.

When economy.enable is false, paid GUI actions are hidden/skipped and creation is free (no economy charge).

Expiration

expiration:
  enable: true
  default-expiration-hours: 7
  maximum-expiration-hours: 125

Option	Description
enable	Run expiration checks and allow time-limited teams
default-expiration-hours	Initial validity after creation
maximum-expiration-hours	Maximum total lifespan after renewals

When enabled:

• New teams receive expiresAt = now + default-expiration-hours
• TeamsExpirationCheckTask removes or invalidates expired teams
• Players renew via the dashboard (EXPIRATION_UPDATE) for one day per purchase, up to the maximum

Reminders

reminders:
  remind-on-join: true
  remind-periodically: true
  send-reminders-to-all-members: false
  reminders-period: 60
  minimum-time-to-remind: 1
  minimum-time-unit: DAYS

Option	Description
remind-on-join	Notify on player join when the team is near expiry
remind-periodically	Background reminder task
send-reminders-to-all-members	false = leader only
reminders-period	Minutes between periodic runs
minimum-time-to-remind + minimum-time-unit	Start reminding when remaining time is at or below this threshold

minimum-time-unit accepts: DAYS, HOURS, MINUTES, SECONDS.

Recommended Setups

Free casual teams

economy:
  enable: false
expiration:
  enable: false

Paid PvP seasons

economy:
  enable: true
  economy-type: VAULT
  cost-for-create-team: 5000
  cost-for-one-expiration-day: 500
  cost-for-one-slot-of-members: 1000
expiration:
  enable: true
  default-expiration-hours: 168   # 7 days
  maximum-expiration-hours: 720  # 30 days
reminders:
  remind-on-join: true
  remind-periodically: true
  minimum-time-to-remind: 1
  minimum-time-unit: DAYS