M0 - OnlinePlayersGUI [1.8 - 1.21.8] [CONDITIONAL GUIS] icon

M0 - OnlinePlayersGUI [1.8 - 1.21.8] [CONDITIONAL GUIS] -----

Online players in a GUI.



[​IMG]
[​IMG]

example.png

[​IMG]


Thank you for 5800 downloads!

Version 5.1.0+ requires Java 17
Version 3.4.0 - 4.1.0 requires Java 16
The only version that supports Java 8 is 5.0.0-j8-beta


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

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 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 (ex. "%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 with this permission.

_________________________________________________


# CONFIGURATION

Configuration is pretty simple and easy to understand.
For more detailed explanation, visit Github wiki page:
Configuration · M0diis/M0-OnlinePlayersGUI Wiki (github.com)


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

Code (YAML):

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.'

# Whether to hide buttons if there are not enough players
# to fill up more than one page
buttons-always-visible
: false
# Hook to EssentialsX which will hide players
# in the GUI if they are vanished
hooks
:
  essentialsx-hook
: false
  premium-vanish-hook
: false
# Conditional display
# It will check whether the placeholder applies (is true) for the
# player and if not, it will exclude the player from the GUI
# https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders
condition
:
  required
: false
  # Condition Operators:
  ## Text operators:
  # =, ==, eq, equal_to, equals — equals
  # !=, neq, ne, not_equal — not equals
  # ~=, ~~, contains, contains_string — contains
  # !~=, !~~, !contains, not_contains, not_contains_string — does not contain
  # starts, starts_with — starts with
  # ends, ends_with — ends with
  # matches, regex — matches regex
  # !matches, !regex, not_matches, not_regex — does not match regex
  #
  ## Digit operators:
  # >, gt, greater_than — greater than
  # <, lt, less_than — less than
  # >=, gte, greater_than_or_equal — greater than or equal
  # <=, lte, less_than_or_equal — less than or equal
  # =, ==, eq, equal_to, equals — equals
  # !=, neq, ne, not_equal — not equals
  # (All text operators above also work for digits, comparing as strings.)
  # Ex.: %player_health% == 20
  placeholder
: "%checkitem_mat:DIRT%" # Requires CheckItem PAPI extension
  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 configuration
# Every section supports placeholders
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 ]' # This will close the GUI.
    middle-click
:
     - ' [CLOSE ]'

# GUI Slots:
# --------------------------
# 0  1  2  3  4  5  6  7  8
# 9  10 11 12 13 14 15 16 17
# 18 19 20 21 22 23 24 25 26
# 27 28 29 22 31 32 33 34 35
# 36 37 38 39 40 41 42 43 44
# 45 46 47 48 49 50 51 52 53
# --------------------------

# Size should be in increments of 9 and not
# lower than 9 or higher than 54
# 9 slots is one row
gui
:
  size
: 27
  title
: '&2Online Players'
  update-on
:
    join
: true
    leave
: true

# Custom Items
# These items will be displayed in the same row as
# the previous and next buttons are
# Available command actions:
# [MESSAGE] - Sends a message to the player: [MESSAGE] Hello, %player_name%!
# [CHAT] - Sends a chat message to the player: [CHAT] Hello, %player_name%!
# [TITLE] - Sends a title to the player: [TITLE] Hello, %player_name%!, 20, 60, 20
# [ACTIONBAR] - Sends an action bar message to the player: [ACTIONBAR] Hello, %player_name%!
# [SOUND] - Plays a sound to the player: [SOUND] ENTITY_EXPERIENCE_ORB_PICKUP, 1, 1
# [PLAYER] - Executes a command as the player: [PLAYER] /command %player_name%
# [CONSOLE] - Executes a command as the console: [CONSOLE] /command %player_name%
# [BROADCAST] - Broadcasts a message to the server: [BROADCAST] Hello, %player_name%!
# [PARTICLE] - Spawns a particle at the player's location: [PARTICLE] FLAME, 1, 0, 0, 0
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
 
Custom CONDITIONAL-GUIs are explained in the Github wiki.

You can use placeholders that return "true" or "false" for conditional GUIs, for ex. %checkitem_mat:STONE:%.

You can use operators (>, >=, <, <=, = or ==, !=) to compare values and check if it matches the condition for conditional GUIs.

Ex. you can use "%vault_eco_balance% > 1000" to check if player has more than 1000 balance, etc.

You can use placeholders on both sides.

_________________________________________________

# MY OTHER PLUGINS

CoreCord - CoreProtect integration for Discord.
ExtraEnchants - Simple additional enchantments for your server.
AntiAnvilRename - Prevent players from renaming certain items using anvils.
SimpleBombs - Customizable bombs for prison and other servers.
VenturaCalendar - In-game calendar with customizable events and much more.
SRVCron - Server scheduler with events, jobs and bunch of other features.

Resources from M0dii - all plugins.

_________________________________________________

Please leave a positive review if the plugin works as intended, if you have an issue contact me on discord provided or open an issue on github.

Buy me some coffee:

[​IMG]
Resource Information
Author:
----------
Total Downloads: 6,290
First Release: Dec 17, 2020
Last Update: Aug 4, 2025
Category: ---------------
All-Time Rating:
7 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings