Item Store

The companion to Tiered Donate Ranks. Where the rank store sells permissions, this one sells items - things players can use directly. Same money/takeMoney pattern as a regular shop, but priced higher because it’s intended to be paid for with donor currency rather than gameplay-earned coins.

intermediate

Features: money-ruletakeMoneyitemAdd-with-enchantmentsdonor-currency

Requires: Vault

Open: /ame_store Copy

menu.conf

# Donate Item Store - buy in-game items with donor tokens
# Docs: https://abstractmenus.github.io/docs/en/examples/donate/item-store
# Open: /ame_store
# Requires: Vault (or PlayerPoints addon for donor tokens)

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

title: "&6Donate Item Store"
size: 3

activators {
  command: "ame_store"
}

items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "18-26" }

  # Header
  {
    slot: 4
    material: NETHER_STAR
    name: "&6&lDonate Items"
    lore: ["&7Special items purchasable with", "&7donor currency."]
  }

  # Mythic sword
  {
    slot: 11
    material: NETHERITE_SWORD
    name: "&dMythic Sword"
    lore: [
      "&7A unique enchanted sword."
      ""
      "&7Sharpness V"
      "&7Unbreaking III"
      "&7Mending"
      ""
      "&ePrice: &a1000 tokens"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      rules { money: 1000 }
      actions {
        takeMoney: 1000
        itemAdd {
          material: NETHERITE_SWORD
          name: "&dMythic Sword"
          enchantments {
            sharpness: 5
            unbreaking: 3
            mending: 1
          }
        }
        sound: ${successSound}
        message: "&dYou received the Mythic Sword!"
      }
      denyActions: ${denyNoMoney}
    }
  }

  # Permanent fly token
  {
    slot: 13
    material: ELYTRA
    name: "&bElytra"
    lore: [
      "&7Vanilla elytra for survival flight."
      ""
      "&ePrice: &a500 tokens"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      rules { money: 500 }
      actions {
        takeMoney: 500
        itemAdd { material: ELYTRA }
        sound: ${successSound}
        message: "&aElytra added to inventory."
      }
      denyActions: ${denyNoMoney}
    }
  }

  # Heads pack
  {
    slot: 15
    material: PLAYER_HEAD
    name: "&6Cosmetic Heads Pack (5x)"
    lore: [
      "&7Five custom-textured player heads"
      "&7for decoration."
      ""
      "&ePrice: &a100 tokens"
    ]
    click {
      rules { money: 100 }
      actions {
        takeMoney: 100
        itemAdd: [
          { material: PLAYER_HEAD, count: 5 }
        ]
        sound: ${successSound}
        message: "&aHeads pack delivered."
      }
      denyActions: ${denyNoMoney}
    }
  }

  ${buttonClose} { slot: 22 }
]

_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

• Custom-named, pre-enchanted items via itemAdd { name: ..., enchantments { ... } }
• The flags: HIDE_ATTRIBUTES flag for tools/swords (otherwise vanilla shows damage range below name)
• Pricing items in the donor currency band

Picking an economy provider

By default, takeMoney: 1000 uses whatever provider is configured at config.conf providers.economy. For a donor-token system you typically want this to route through a separate provider (like the PlayerPoints addon) instead of the regular Vault economy.

Two options:

1. Server-wide donor currency: edit config.conf to make donor tokens the default economy. All takeMoney calls use it. Simplest if your whole server runs on tokens.

2. Per-action provider override: keep Vault as default, but specify the donor provider on each action in this menu:

takeMoney: { amount: 1000, provider: "playerpoints" }

This lets the regular shop continue using Vault while the donor store charges tokens.

Custom item shapes

The Mythic Sword item demonstrates building a non-vanilla item via itemAdd:

itemAdd {
  material: NETHERITE_SWORD
  name: "&dMythic Sword"
  enchantments {
    sharpness: 5
    unbreaking: 3
    mending: 1
  }
}

Any field that works on a menu display item works here too - lore, attribute modifiers, custom NBT, durability, model. See the item format docs for the full list.

Try it

1. Drop the bundle into plugins/AbstractMenus/menus/example/.
2. /am reload.
3. /eco give <you> 2000.
4. Type /ame_store in-game.