paginated chest gui menu

# Paginated chest GUI — solves the recurring "how do I show 50+ items in a
# chest GUI" pain point. Items per page = 45 (top 5 rows), bottom row is nav.

options:
    page_size: 45
    nav_back: 48      # bottom row, 4th slot
    nav_close: 49     # bottom row, 5th slot
    nav_next: 50      # bottom row, 6th slot

function openPaginatedMenu(p: player, page: number):
    set {_gui} to chest inventory with 6 rows named "&aBrowse — Page %{_page}%"
    set {_total} to size of {browse.items::*}
    set {_start} to ({_page} - 1) * {@page_size} + 1
    set {_end} to {_page} * {@page_size}
    if {_end} > {_total}:
        set {_end} to {_total}
    set {_slot} to 0
    loop {_start} to {_end}:
        set slot {_slot} of {_gui} to {browse.items::%loop-value%}
        add 1 to {_slot}
    # Nav row
    if {_page} > 1:
        set slot {@nav_back} of {_gui} to arrow named "&7← Previous page"
    set slot {@nav_close} of {_gui} to barrier named "&cClose"
    if ({_page} * {@page_size}) < {_total}:
        set slot {@nav_next} of {_gui} to arrow named "&7Next page →"
    set {browse.page.%uuid of {_p}%} to {_page}
    set {browse.gui.%uuid of {_p}%} to {_gui}
    open {_gui} to {_p}

on inventory click:
    if event-inventory is {browse.gui.%uuid of player%}:
        cancel event
        if index of event-slot is {@nav_back}:
            openPaginatedMenu(player, {browse.page.%uuid of player%} - 1)
        else if index of event-slot is {@nav_next}:
            openPaginatedMenu(player, {browse.page.%uuid of player%} + 1)
        else if index of event-slot is {@nav_close}:
            close player's inventory

# Example: fill the list and open
command /browse:
    trigger:
        # Demo data — replace with your real list
        loop 60 times:
            set {browse.items::%loop-number%} to diamond named "&bDiamond #%loop-number%"
        openPaginatedMenu(player, 1)