M0-OnlinePlayersGUI

A simple player list GUI plugin to see online players in an inventory with a bunch of features and customizability.

Developer Builds

Developer Builds

---

Dependencies

Make sure you have required plugins installed for the plugin to work properly.

• PlaceholderAPI (optional)
• EssentialsX (optional)
• SuperVanish (optional)
• PremiumVanish (optional)

For player placeholders to work you need the PAPI Player expansion:

/papi ecloud download Player

---

Features

• Fully configurable player list display
• MiniMessage support
• Toggleable and changeable GUI buttons
• Light-weight & lag-free
• Fully customizable custom item display
• PlaceholderAPI support for commands, names, lore
• Simple and easy to use
• Ability to easily reload the plugin config with existing commands as well as Plugman support
• Commands can be executed by player himself as well as console
• EssentialsX vanish support
• SuperVanish support
• PremiumVanish support
• Conditional display
• Unlimited conditional GUIs
• Conditional operator checking for values (e.g. %vault_eco_balance% > 1000)

---

Commands

• /onlinegui - Open the GUI
• /onlinegui reload - Reload the config
• /onlinegui toggleself - Toggle own visibility in the base GUI

---

Permissions

• m0onlinegui.command.onlinegui - Permission to open the GUI
• m0onlinegui.command.reload - Permission to reload the config
• m0onlinegui.command.toggleself - Permission to toggle self visibility in the GUI
• m0onlinegui.conditional.conditional_name - Permission to open a conditional GUI with specified name
• m0onlinegui.hidden - Hide players from the GUI

---

Configuration

Configuration is pretty simple and easy to understand.

For a more detailed explanation, visit the GitHub Wiki:

https://github.com/M0diis/M0-OnlinePlayersGUI/wiki/Configuration

If you ever lose your config or break something you can always refer to it here.

messages:
  reload: '&2Configuration has been reloaded.'
  no-permission: '&2You do not have permission to this command.'
  no-permission-conditional: '&2You do not have permission to view this GUI'
  toggle-visibility: '&2You have toggled your visibility in Online GUI.'

buttons-always-visible: false

hooks:
  essentialsx-hook: false
  premium-vanish-hook: false

condition:
  required: false
  placeholder: "%checkitem_mat:DIRT%"
  permission:
    required: false
    node: "permission.to.include.player"

player-display-material: 'PLAYER_HEAD'

previous-button:
  material: ENCHANTED_BOOK
  name: '&cPrevious Page'
  slot: 21
  lore:
    - '&7Click to open previous page.'

next-button:
  material: ENCHANTED_BOOK
  name: '&aNext Page'
  slot: 23
  lore:
    - '&7Click to open next page.'

player-display:
  name: '&6%player_name%'
  lore:
    - '&2Right click to &ateleport&2 to the player.'
    - '&2Left click to &asay hi&2.'
  commands:
    left-click:
      - '[PLAYER] tp %player_name%'
    right-click:
      - '[PLAYER] msg %player_name% Hello, my name is %sender_name%.'
      - '[CONSOLE] msg %player_name% Hello!'
      - '[CLOSE]'
    middle-click:
      - '[CLOSE]'

gui:
  size: 27
  title: '&2Online Players'
  update-on:
    join: true
    leave: true

custom-items:
  '1':
    material: RED_STAINED_GLASS_PANE
    slots:
      start: 0
      end: 8
    name: '&r'
    lore: []
    commands:
      left-click:
        - '[CLOSE]'
      right-click:
        - '[CLOSE]'
      middle-click:
        - '[CLOSE]'
  '2':
    material: RED_STAINED_GLASS_PANE
    slots:
      - 9
      - 17
      - 18
      - 19
      - 20
      - 22
      - 24
      - 25
      - 26
    name: '&r'
    lore: []

debug: false

Conditional GUIs

Custom conditional GUIs are explained in the GitHub Wiki.

You can use placeholders that return true or false for conditional GUIs, for example:

%checkitem_mat:STONE%

You can also use operators to compare values:

>, >=, <, <=, =, ==, !=

Example:

%vault_eco_balance% > 1000

This checks whether the player has more than 1000 balance.

You can use placeholders on both sides of the comparison.

---