Global Stats Board

A read-only menu showing live data via PlaceholderAPI. The top row displays per-player stats (kills, deaths, hours played), the bottom row shows server-wide info (online count, time, TPS, current world). Values refresh every second thanks to updateInterval: 20 (20 ticks = 1 second).

What it teaches

• The updateInterval field for live menu refresh
• PlaceholderAPI integration: %statistic_*%, %server_*%, %player_*%
• Mixing per-player and server-wide data in one menu
• Custom skull textures via the texture: field on PLAYER_HEAD

intermediate

Features: updateIntervalplaceholdersstatistic-expansionserver-expansionPLAYER_HEAD-texture

Requires: PlaceholderAPI

Open: /ame_stats Copy

menu.conf

# Global Stats Board - live display of player and server stats
# Docs: https://abstractmenus.github.io/docs/en/examples/state-and-vars/global-stats-board
# Open: /ame_stats
# Requires: PlaceholderAPI + statistic expansion

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

title: "&6&l%player_name%'s Stats"
size: 4
updateInterval: 20

activators {
  command: "ame_stats"
}

items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "27-35" }

  # ========== Player section (row 1) ==========
  {
    slot: 10
    texture: "ebfe9b7af68dc1264a6fc969f3d7b08e50e61e6ee91cea83daabd18820f0ef"
    name: "&6Player Kills"
    lore: ["", "&e%statistic_player_kills%"]
  }
  {
    slot: 12
    texture: "1ae3855f952cd4a03c148a946e3f812a5955ad35cbcb52627ea4acd47d3081"
    name: "&6Deaths"
    lore: ["", "&c%statistic_deaths%"]
  }
  {
    slot: 14
    texture: "f67b27fb7e29ec98e1cd4a8f8466856d9ef3f2e9fbd9aed6311f8abe54b6ab2"
    name: "&6Mob Kills"
    lore: ["", "&e%statistic_mob_kills%"]
  }
  {
    slot: 16
    texture: "f32c6171532a2a87f0eeb28edd010833f33f0ae6841a524e1b5200a35d385050"
    name: "&6Hours Played"
    lore: ["", "&e%statistic_hours_played%h"]
  }

  # ========== Server section (row 2) ==========
  {
    slot: 19
    material: BEACON
    name: "&aOnline Now"
    lore: ["", "&e%server_online%&7 / &e%server_max_players%"]
  }
  {
    slot: 21
    material: CLOCK
    name: "&aServer Time"
    lore: ["", "&e%server_time_HH:mm:ss%"]
  }
  {
    slot: 23
    material: ENDER_CHEST
    name: "&aTPS"
    lore: ["", "&e%server_tps_1%&7, &e%server_tps_5%&7, &e%server_tps_15%"]
  }
  {
    slot: 25
    material: COMPASS
    name: "&aWorld"
    lore: ["", "&e%player_world%"]
  }

  ${buttonClose} { slot: 31 }
]

_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 updateInterval works

updateInterval: 20 tells the menu to re-evaluate placeholders every 20 server ticks (1 second). On each tick, every item’s name: and lore: get re-rendered with current placeholder values. Players see counts increment in real time without closing/reopening.

For static menus this field is unnecessary - they only render once on open. For dashboards with constantly-changing values (stats, online count), it’s essential.

Set this too low (e.g. 1 = every tick = 50ms) and you’ll see CPU spikes from placeholder evaluation. 20 (1s) or 40 (2s) is the sweet spot for human-readable refresh.

Placeholder requirements

This menu uses PlaceholderAPI placeholders from several expansions:

• %statistic_*% - PlaceholderAPI’s Statistic expansion. Install with /papi ecloud download Statistic.
• %server_*% - PlaceholderAPI’s built-in server placeholders. No extra expansion needed.
• %player_*% - PlaceholderAPI’s built-in player placeholders. No extra expansion needed.

If a placeholder isn’t resolved, it’ll render as the literal %xxx% string in the menu - that’s a sign the expansion isn’t installed.

Adding more stats

Pick a placeholder from the PlaceholderAPI cloud and drop it into a new item’s lore. The menu will pick up the live value on next refresh.

For per-player vars from this plugin (not PAPI), use the %varp_:name:default% form - see the Counter & Toggle example.

Try it

After installing the example pack:

1. Install PlaceholderAPI and the Statistic expansion (/papi ecloud download Statistic).
2. Drop the bundle into plugins/AbstractMenus/menus/example/.
3. /am reload.
4. Type /ame_stats in-game. Watch the values refresh once per second.