Admin Panel

Admin Panel GUI Customization

HidePlayer features a built-in Graphical User Interface (GUI) that allows server staff to easily view all currently hidden players.

You can access this menu in-game using /hp panel or /hp admin (requires hideplayer.admin permission).

The GUI is fully customizable to match your server's theme. All modifications are done in the config.yml under the admin-panel section.

---

Layout and Pagination

The GUI is designed to automatically handle pagination if there are more hidden players than the available slots can display.

• Inventory Size: You can customize the total size of the inventory using the size parameter. This must be a multiple of 9 (e.g., 9, 18, 27, 36, 45, 54). The maximum size is 54 (a double chest).
• The Last Row: The bottom row of the inventory (the last 9 slots) is always reserved for the Next Page and Previous Page navigation buttons.
• Player Distribution: Hidden players will automatically fill all the available slots above the navigation row. For example, in a 54 slot inventory, 45 slots will be used for players per page.

---

Configuration Breakdown

Here is a breakdown of how you can customize each element of the GUI:

1. Title

You can use standard Minecraft color codes (&) and the {page} placeholder, which the plugin will automatically replace with the current page number.

admin-panel:
  title: "&cAdmin Panel - Page {page}"

2. Player Heads

Every hidden player is represented by their Player Head in the GUI. You can extensively customize the display name and the lore (description) of these heads using special placeholders.

Available Placeholders for Player Heads:

• {original_name}: The true name of the player.
• {nick}: The fake nickname they are currently using.
• {skin}: The fake skin name they are currently using.
• {uuid}: The actual permanent UUID of the player.

Example Configuration:

  player-head:
    name: "&a{original_name}" 
    lore:
      - "&7Fake Nick: &f{nick}"
      - "&7Fake Skin: &e{skin}"
      - ""
      - "&8UUID: {uuid}"
      - "&c(Currently Hidden!)"

3. Pagination Controls (Next/Previous Buttons)

If taking up multiple pages, navigation arrows will appear at the bottom. The plugin requires you to use valid Spigot Materials.

• The Previous Page button always spawns on slot size - 6.
• The Next Page button always spawns on slot size - 4.

Example Configuration:

  next-page-item:
    material: "SPECTRAL_ARROW" # Must be a valid Spigot Material!
    name: "&aNext Page &8>>"
    lore:
      - "&7Click to go to the next page!"
      
  prev-page-item:
    material: "ARROW"
    name: "&8<< &cPrevious Page"
    lore:
      - "&7Click to go to the previous page!"

---

Remember: After making changes to the config.yml, save the file and use /hp reload in-game to instantly update the appearance of the GUI without restarting the server!