Server Links

Minecraft chat lets players click URLs in chat or written books. The simplest way to expose external links from a menu is to open a single-page book per link - the book renders the URL as clickable text right in the player’s UI.

intermediate

Features: openBookexternal-linkscloseMenu-with-action

Open: /ame_links Copy

menu.conf

# Server Links - external links via openBook
# Docs: https://abstractmenus.github.io/docs/en/examples/info-pages/server-links
# Open: /ame_links
# Requires: -

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

title: "&6Useful Links"
size: 3

activators {
  command: "ame_links"
}

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

  # Header
  {
    slot: 4
    material: WRITTEN_BOOK
    name: "&6&lMyTestServer Resources"
    lore: ["&7Click any tile for the link.", "&7Books open clickable URLs."]
  }

  # Discord - opens a written book with the invite URL.
  {
    slot: 11
    material: PURPLE_DYE
    name: "&5Discord"
    lore: ["&7Join our Discord server.", "", "&aClick to open the link"]
    click {
      actions {
        openBook {
          author: "MyTestServer"
          title: "&5Discord"
          pages: [
            "Click the link below to open our Discord invite:\n\nhttps://discord.gg/example"
          ]
        }
        sound: ${clickSound}
        closeMenu: true
      }
    }
  }

  # Website
  {
    slot: 13
    material: COMPASS
    name: "&aWebsite"
    lore: ["&7Visit our website.", "", "&aClick to open the link"]
    click {
      actions {
        openBook {
          author: "MyTestServer"
          title: "&aWebsite"
          pages: [
            "Click the link below to visit our site:\n\nhttps://example.org"
          ]
        }
        sound: ${clickSound}
        closeMenu: true
      }
    }
  }

  # GitHub / source
  {
    slot: 15
    material: WRITABLE_BOOK
    name: "&8GitHub"
    lore: ["&7Source code and issue tracker.", "", "&aClick to open the link"]
    click {
      actions {
        openBook {
          author: "MyTestServer"
          title: "&8GitHub"
          pages: [
            "Click the link below to open our GitHub:\n\nhttps://github.com/example"
          ]
        }
        sound: ${clickSound}
        closeMenu: true
      }
    }
  }

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

Why books and not chat messages

A chat message with a URL is fine but easy to scroll past. A written book opens in the player’s view, looks more deliberate, and the URL is rendered as a big clickable button. For a “links” menu, books are the better UX.

openBook format

openBook {
  author: "MyTestServer"
  title: "&5Discord"
  pages: [
    "Click the link below to open our invite:\n\nhttps://discord.gg/example"
  ]
}

pages is a list of strings; each string is one page. Newlines inside a string break to new lines on that page. Plain URLs become clickable automatically when Minecraft renders the book.

For a multi-page resource catalog, list more strings:

pages: [
  "Page 1: Discord invite\nhttps://discord.gg/...",
  "Page 2: Website\nhttps://example.org",
  "Page 3: GitHub\nhttps://github.com/..."
]

Closing the menu

Each click block calls closeMenu: true after opening the book. Otherwise the menu would stay open behind the book - confusing.

Try it

1. Drop the bundle into plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Type /ame_links in-game.
4. Click any tile. A book opens with a clickable URL inside.