HeadDB's GUI is the main player-facing interface. It provides browsing, search, favorites, player heads, More Heads, More Categories, settings, and staff administration tools.
/hdb
/hdb open
/headdb
Required permissions:
headdb.open
headdb.gui.main
The main menu can show Browse All Heads, category buttons, Search, Favorites, Player Heads, More Heads, More Categories, Settings, and staff controls. Players only see actions they have permission to use.
| Action | Behavior |
|---|---|
| Left-click head | Obtains the head if permission and economy checks pass. |
| Right-click head | Toggles favorite when permitted. |
| Q/drop on head | Opens edit actions in Admin Mode for permitted staff. |
| Previous/Next | Changes page. |
| Back | Returns to the previous menu. |
Search supports text query, category filters, tag filters, collection filters, sort option, and sort direction.
Permissions:
headdb.gui.search
headdb.gui.filter
Favorites are per-player saved heads. Right-click a head in result menus to favorite or unfavorite it, then open Favorites from the main menu.
The Player Heads menu displays player-profile heads when enabled.
Permission:
headdb.gui.player-heads
More Heads are local custom heads created by staff. They are stored locally and can be browsed through the GUI when enabled.
Permission:
headdb.gui.custom-heads
More Categories are server-local custom categories for shop groups, event sets, staff picks, donor cosmetics, or server-themed collections.
Permissions:
headdb.gui.more-categories
headdb.gui.more-categories.admin
The settings menu can include language selection, reset language, and Admin Mode toggle.
Permissions:
headdb.gui.settings
headdb.gui.settings.language
headdb.gui.admin-mode
Admin Mode exposes additional information and editing actions for staff. It can show edit hints, local visibility controls, hidden heads, button configuration, and More Categories administration.
Required permission:
headdb.gui.admin-mode
The head edit GUI modifies local metadata overrides for public heads. It does not change the public database.
Common edit actions:
| Action | Description |
|---|---|
| Name | Override displayed name locally. |
| Lore | Override or reset local lore. |
| Category | Override category assignment locally. |
| Tags | Add or remove local tag overrides. |
| Collections | Add or remove local collection overrides. |
| Visibility | Hide or show the head locally. |
| Reset | Remove local overrides. |
GUI filler, navigation, and configuration items are not intended to be taken. If players can move GUI items unexpectedly, check server version, conflicting inventory plugins, and console errors from inventory events.