AetherSky Upgrades

Island Upgrades

Players buy upgrades in /is upgrades (or Upgrades in the dashboard). The leader can always buy them; members can too when island.members-can-buy-upgrades: true (default). Every online team member gets an Upgrade Purchased! message.

The four upgrades

Upgrade	Effect of the tier value	Default tiers
BORDER_SIZE	Extra border diameter in blocks, added to the level-based border.	+0, +25, +50, +100, +150
CROP_GROWTH	Chance in % that a growing crop gains one extra growth stage.	0%, 15%, 30%, 50%
MOB_SPAWNS	Chance in % that a natural or spawner mob spawns twice.	0%, 10%, 25%, 40%
TEAM_SIZE	Maximum number of players in the team (Leader + Members).	4, 6, 8, 12

Currency

upgrades:
  currency: XP_LEVELS        # or VAULT
  currency-name-xp: 'XP Levels'
  currency-name-vault: '$'

• XP_LEVELS: the cost is taken from the buyer's XP levels.
• VAULT: the cost is withdrawn through Vault. Needs Vault and an economy plugin. If either is missing, AetherSky logs a warning and falls back to XP levels.

With separate inventories (default), XP levels are also separate: on the island, players pay with their island XP. See Separate Inventories.

Configuring tiers

Each upgrade has a list of tiers. Tier 0 is the free starting value; every next entry is one purchasable level with its value and cost.

upgrades:
  types:
    TEAM_SIZE:
      name: '<gradient:#F7971E:#FFD200>Team Size</gradient>'
      icon: PLAYER_HEAD
      description:
        - '<gray>Maximum players on your island team.'
        - '<gray>Team limit: <white><value>'
      tiers:
        - { value: 4,  cost: 0 }     # level 0 (start)
        - { value: 6,  cost: 20 }    # level 1
        - { value: 8,  cost: 40 }    # level 2
        - { value: 12, cost: 80 }    # level 3 (max)

• Add or remove tiers to change the maximum level.
• <value> in the description is replaced by the current value.
• Run /aethersky reload after editing. Islands keep their purchased level; if you remove tiers, a higher level is capped at the new maximum.

Notes

• BORDER_SIZE can never push the border past border.max-size (and never past the grid spacing).
• CROP_GROWTH works for every crop with growth stages (wheat, carrots, potatoes, beetroots, nether wart, ...).
• MOB_SPAWNS only affects natural and spawner spawns, never spawn eggs, commands or OneBlock mobs.