Tiered Donate Ranks

The standard donate store layout: rank tiles in increasing order, each one shows “Owned” if the player already has the permission, or the price + perks list if they don’t. Built on the dual-item display pattern with one variant per rank state.

intermediate

Features: dual-item-displaypermission-rulecommand-aliasestier-pricing

Requires: LuckPerms

Open: /ame_donate Copy

menu.conf

# Tiered Ranks Donate Store - 4 ranks with HAS_RANK / NO_RANK dual items
# Docs: https://abstractmenus.github.io/docs/en/examples/donate/tiered-ranks
# Open: /ame_donate
# Requires: LuckPerms

include required(file("./plugins/AbstractMenus/menus/example/_shared/templates.conf"))

title: "&6Donate Store - Ranks"
size: 5

activators {
  command: ["ame_donate", "ame_support"]
}

items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "36-44" }

  # Header
  {
    slot: 4
    material: NETHER_STAR
    name: "&6&lSupport MyTestServer"
    lore: ["&7Pick a rank to learn more.", "&7Buying ranks supports the server."]
  }

  # ========== Knight ==========
  # HAS_RANK variant: player already has knight permission, can't buy again.
  {
    slot: 19
    material: IRON_SWORD
    name: "&7Knight &8(&aOwned&8)"
    lore: [
      "&7Tier 1 supporter rank."
      ""
      "&aYou already own this rank."
      "&7Consider upgrading below."
    ]
    flags: HIDE_ATTRIBUTES
    rules { permission: "myserver.rank.knight" }
  }
  # NO_RANK variant: doesn't have it yet, show price.
  {
    slot: 19
    material: IRON_SWORD
    name: "&7Knight"
    lore: [
      "&7Tier 1 supporter rank."
      ""
      "&7Includes:"
      "&7- &fcolored chat name"
      "&7- &f3 home points"
      ""
      "&ePrice: &a$5"
      ""
      "&aLeft-click to learn more"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      actions {
        # In production, this would open a confirm/purchase URL menu.
        # For the example, just inform.
        message: "&aOpen the donate page at https://example.org to purchase Knight."
        sound: ${clickSound}
      }
    }
  }

  # ========== Paladin ==========
  {
    slot: 21
    material: GOLDEN_SWORD
    name: "&6Paladin &8(&aOwned&8)"
    lore: ["&7Tier 2 supporter rank.", "", "&aYou already own this rank."]
    flags: HIDE_ATTRIBUTES
    rules { permission: "myserver.rank.paladin" }
  }
  {
    slot: 21
    material: GOLDEN_SWORD
    name: "&6Paladin"
    lore: [
      "&7Tier 2 supporter rank."
      ""
      "&7Includes:"
      "&7- &feverything from Knight"
      "&7- &f5 home points"
      "&7- &f/fly in build worlds"
      ""
      "&ePrice: &a$15"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      actions {
        message: "&aOpen the donate page at https://example.org to purchase Paladin."
        sound: ${clickSound}
      }
    }
  }

  # ========== Lord ==========
  {
    slot: 23
    material: DIAMOND_SWORD
    name: "&bLord &8(&aOwned&8)"
    lore: ["&7Tier 3 supporter rank.", "", "&aYou already own this rank."]
    flags: HIDE_ATTRIBUTES
    rules { permission: "myserver.rank.lord" }
  }
  {
    slot: 23
    material: DIAMOND_SWORD
    name: "&bLord"
    lore: [
      "&7Tier 3 supporter rank."
      ""
      "&7Includes:"
      "&7- &feverything from Paladin"
      "&7- &fcustom join messages"
      "&7- &f10 home points"
      ""
      "&ePrice: &a$30"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      actions {
        message: "&aOpen the donate page at https://example.org to purchase Lord."
        sound: ${clickSound}
      }
    }
  }

  # ========== Monarch ==========
  {
    slot: 25
    material: NETHERITE_SWORD
    name: "&dMonarch &8(&aOwned&8)"
    lore: ["&7Tier 4 supporter rank.", "", "&aYou already own this rank."]
    flags: HIDE_ATTRIBUTES
    rules { permission: "myserver.rank.monarch" }
  }
  {
    slot: 25
    material: NETHERITE_SWORD
    name: "&dMonarch"
    lore: [
      "&7Tier 4 supporter rank, the highest tier."
      ""
      "&7Includes:"
      "&7- &feverything from Lord"
      "&7- &fparticle effect on join"
      "&7- &fpriority queue when full"
      ""
      "&ePrice: &a$60"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      actions {
        message: "&aOpen the donate page at https://example.org to purchase Monarch."
        sound: ${clickSound}
      }
    }
  }

  ${buttonClose} { slot: 40 }
]

_shared/templates.conf

# AbstractMenus example pack - shared templates
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/en/examples

# Sound presets (Paper 1.21+ registry keys)
clickSound:    "ui.button.click"
openSound:     "block.chest.open"
closeSound:    "block.chest.close"
successSound:  "entity.experience_orb.pickup"
failSound:     "block.note_block.bass"
deniedSound:   "block.anvil.land"

# Deny action snippets (use as: denyActions: ${denyNoMoney})
denyNoMoney {
  sound:   ${deniedSound}
  message: "&cYou don't have enough money."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cYou don't have permission."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cYou're on cooldown. Try again later."
}

# Border items (use as: ${borderBlack} { slot: "0-8" })
borderBlack {
  material: BLACK_STAINED_GLASS_PANE
  name: " "
}
borderGray {
  material: GRAY_STAINED_GLASS_PANE
  name: " "
}
borderBlue {
  material: BLUE_STAINED_GLASS_PANE
  name: " "
}

# Navigation buttons (use as: ${buttonClose} { slot: 22 })
buttonClose {
  material: BARRIER
  name: "&cClose"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eBack"
  lore: ["&7Return to previous menu"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eNext page"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&ePrevious page"
  click {
    pagePrev: 1
  }
}

# Rule shortcut snippets (use as: rules: ${rulesAdmin})
rulesAdmin   { permission: "abstractmenus.admin" }
rulesVip     { permission: "abstractmenus.vip" }
rulesDonator { permission: "abstractmenus.donator" }

# Common decorative header (use as: ${commonHeader} { slot: 4 })
commonHeader {
  material: NETHER_STAR
  name: "&6&lExample Menu"
  lore: ["&7Welcome to the AbstractMenus example pack"]
}

↓ menu.conf ↓ Bundle (.zip)

Bundle includes _shared/templates.conf and INSTALL.txt.

What it teaches

• Scaling the dual-item pattern across many tiers
• Command aliases via command: [..., ...] (so both /ame_donate and /ame_support open it)
• Per-rank perk listing in lore
• Where to wire the actual purchase flow (this example just sends a chat message)

How the dual variants stack

Each rank slot has two items declared. The HAS_RANK variant has rules { permission: "myserver.rank.knight" } and shows “Owned” + “Consider upgrading below.” The NO_RANK variant has no rules and shows the perks + price.

Same rendering rule as Rank-Gated Shop: walk items in declaration order; the first item at each slot whose rules pass renders. HAS_RANK is declared first, so when the player has the permission, that variant wins.

Wiring the purchase flow

Real donate stores integrate with a payment processor. Common patterns:

• External URL: send &aVisit https://example.org/donate to purchase in the click action. Player buys on the website, gets the rank via API.
• In-game currency: gate with money rule and takeMoney action like a regular shop, then grant rank with addGroup: "knight".
• Player Points / token system: same as money but via a different provider. Pin the provider explicitly: takeMoney: { amount: 5, provider: "playerpoints" }.

This example uses the URL pattern because it’s the most generic. Swap the click block to fit your store.

Adding a fifth tier

Copy any pair (HAS_RANK + NO_RANK) for a tier, change the slot to a free position (slots 27 or 29 in row 4 fit well), update the permission name, perks, and price.

Try it

1. Drop the bundle into plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Type /ame_donate or /ame_support in-game.
4. Grant yourself a permission (e.g., lp user <you> permission set myserver.rank.knight true) to see the HAS_RANK variant render.