Playtime Menu

menu/PlaytimeMenu.yml controls the main reward progression menu.

Header

title: "<dark_gray>FioPlaytime</dark_gray> <black>%page%/%maxPage%</black>"
rows: 6

• title: inventory title.
• rows: inventory height.
• %page% and %maxPage%: pagination placeholders rendered by the menu manager.

Static items

Static buttons live under items.

items:
  playtime:
    material: PLAYER_HEAD
    player: true
    refresh: true
    name: "<green>Your Playtime</green>"
    slot: 4
    actions:
      any:
        - '[NONE]'

Common keys:

Key	Description
material	Bukkit material name.
player	Uses the viewer's player head when supported.
refresh	Re-renders the item while the menu is open.
hide_tooltip	Hides item tooltip where supported.
slot	Single slot number.
slots	Multiple slots or ranges such as 45-53.
name	Display name.
lore	Lore lines.
actions	Click actions.

Reward content slots

playtime:
  content-slot:
    - '9-10'
    - '19'
    - '28'

Generated reward entries are placed in these slots and paginated when there are more tiers than visible slots.

Reward status styles

playtime:
  status:
    locked: {}
    unlocked: {}
    onprogress: {}
    unclaimed: {}

Status	Meaning
locked	Tier is not available yet.
unlocked	Tier was already claimed.
onprogress	Tier is being progressed toward.
unclaimed	Tier requirement is complete and can be claimed.

The default unclaimed action claims the reward:

actions:
  any:
    - '[FIOPLAYTIME] CLAIM %tier_raw%'

Supported menu actions

Action	Description
[CLOSE]	Close the open inventory.
[NONE]	Do nothing.
[MESSAGE] [message]	Send a message to the player.
[SOUND] [sound] [volume] [pitch]	Play a sound.
[PLAYER] [command]	Run a command as the player.
[CONSOLE] [command]	Run a command as console.
[FIOPLAYTIME] CLAIM [tier]	Claim one reward tier.
[FIOPLAYTIME] NEXT_PAGE+[amount]	Move forward through paginated content.
[FIOPLAYTIME] PREVIOUS_PAGE-[amount]	Move backward through paginated content.
[FIOPLAYTIME] Materials	Open the material selector menu.
[FIOPLAYTIME] Leaderboards	Open the leaderboard menu.
[FIOPLAYTIME] Profile [player]	Open a player's profile menu.
[FIOPLAYTIME] BACK	Return to the previous menu.

Page note

If an unclaimed tier has only [NONE], the source automatically replaces it with [FIOPLAYTIME] CLAIM [tier].