Lava-Water Generator

Purpose

The generator upgrade changes the normal cobblestone or stone result of a lava-water formation event into a material selected from the island's purchased weighted tier. It is independent from the OneBlock tier pool. Ten default generator levels are included, while all materials, weights, costs, and requirements are configurable.

Tier structure

generators:
  enabled: true
  tiers:
    tier_2:
      display-name: '&7Level 2 Generator'
      upgrade-cost: 5000.0
      required-island-breaks: 500
      required-island-level: 0.0
      item-costs: {}
      blocks:
        - COBBLESTONE: 75.0
        - COAL_ORE: 15.0
        - IRON_ORE: 8.0
        - COPPER_ORE: 2.0

Preserve the exact keys generated by your installed config/generators.yml; do not copy field naming from an unrelated generator plugin.

Weight normalization

Pools do not need to total 100. AeroOneBlock sums all positive entries and divides each weight by that total. A pool of 50 + 50 + 100 produces 25%, 25%, and 50%. Tiny decimal weights are valid. The menu formats recurring decimal percentages with an overline where possible.

Requirements and menu separation

Generator tiers may define Vault cost, shared island breaks, island level, and item costs directly. Personal breaks, XP, playtime, permission, placeholder, and material-specific conditions are attached through upgrade-requirements.generator.

The generator card is optional. Hiding it with menu-enabled: false preserves menu symmetry while /ob upgrade generator remains callable from an external interface. The older generator-luck upgrade controls OneBlock mob and crate chance instead and is disabled by default.

Validation and scope

• Zero-weight entries are never selected.
• Invalid materials and pools without a positive entry are rejected on load.
• The purchased generator tier belongs to the shared island.
• Only valid block-formation events inside the appropriate managed island area are replaced.