Main Hub

A hub menu is just a list of buttons that each open another menu. Useful as a server’s main /menu command or as a way to organize a large collection of sub-features. This example links to the other menus in the pack so you can use it as a launcher while exploring.

What it teaches

• The openMenu action - the only thing the buttons do
• A simple 3-row layout with borders, header item, and tile row
• A reusable pattern for any “select a category” UI

beginner

Features: openMenumenu-launcher

Open: /ame_hub Copy

menu.conf

# Main Hub - launcher for the example pack
# Docs: https://abstractmenus.github.io/docs/en/examples/hub-and-nav/main-hub
# Open: /ame_hub
# Requires: -

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

title: "&6Example Pack - Main Hub"
size: 3

activators {
  command: "ame_hub"
}

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

  # Header
  {
    slot: 4
    material: NETHER_STAR
    name: "&6&lAbstractMenus Example Pack"
    lore: ["&7Click any tile to open that example."]
  }

  # Shops
  {
    slot: 10
    material: CAKE
    name: "&aCake Shop"
    lore: ["&7A minimal money + itemAdd shop.", "", "&8Opens /ame_cake_shop"]
    click {
      openMenu: "ame_cake_shop"
    }
  }

  {
    slot: 11
    material: BREAD
    name: "&aMulti-Category Shop"
    lore: ["&7Hub + sub-shops navigation.", "", "&8Opens /ame_shop"]
    click {
      openMenu: "ame_shop"
    }
  }

  # State
  {
    slot: 12
    material: BOOK
    name: "&aCounter & Toggle"
    lore: ["&7Per-player vars in action.", "", "&8Opens /ame_counter"]
    click {
      openMenu: "ame_counter"
    }
  }

  # Info
  {
    slot: 13
    material: WRITTEN_BOOK
    name: "&aServer Rules"
    lore: ["&7Read-only example menu.", "", "&8Opens /ame_rules"]
    click {
      openMenu: "ame_rules"
    }
  }

  # Kits
  {
    slot: 14
    material: CHEST
    name: "&aBasic Kit"
    lore: ["&7One-click reward bundle.", "", "&8Opens /ame_kit"]
    click {
      openMenu: "ame_kit"
    }
  }

  ${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.

How it works

Every tile is the same shape: an item with material:, name:, lore:, and a click { openMenu: "ame_<name>" }. There are no rules, no actions other than navigation, no money checks. The hub’s job is just to dispatch.

The header item at slot 4 is purely decorative - same as in Cake Shop. No click handler.

Customizing

To add a new tile:

1. Pick a free slot (10-16 in this layout work well).
2. Copy any tile block.
3. Change material:, name:, lore:, and the openMenu: target.

The hub has no dependency on which menus actually exist. If a tile points at a non-existent menu, clicking it just shows a “menu not found” warning - useful for staging future menus before they’re built.

Try it

After installing the example pack:

1. Drop the bundle into plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Type /ame_hub in-game.