Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for Loving11ish

A simple GUI that shows admins information about all the players on the server.

Report PlayerGUIAdvanced?

Description:

A simple GUI that shows admins information about all the players on the server. This can be very useful for admins and mods to quickly see at a glance certain attributes of any online player.

The plugin also offers several handy moderation features to help run your server, including a fully customisable visual ban and kick manager system and the ability to grant admins the use of /op or /deop independently using permission nodes.

With V3.4 onwards, the plugin now also adds API support for both 'SuperVanish' and 'PremiumVanish'. If you have either of these plugins installed, then it enables additional stats about the player to be shown and also sends the admin or mod into vanish when they teleport to the targeted player as well as setting them into spectator mode. If you do not have either of these plugins installed, then PlayerGUI will detect this and it will just run normally with the enhanced vanish features disabled.

As of V5.0 the plugin has now had a complete rewrite, this has allowed the plugin to now support servers with more that 54 online players! The reworked plugin uses a new menu manager system that now allows to tab complete commands. This rewrite also now allows the plugin to function more reliably and with the ability to more easily add features in the future!

As of V6.7.1 the plugin now also adds support for showing whether the player is vanished using EssentialsX. To make use of this, simply install EssentialsX alongside PlayerGUIAdvanced and the Ess Vanished: statistic will be automatically displayed in the PlayerListGUI.

As of version 6.6.0 I am dropping support for anyone still using the old PlayerGUI. I simply cannot maintain it any longer, sorry

Want to try out the very latest dev builds? [Click here] Use the above dev build at your own risk! Please follow any and ALL instructions provided with EACH dev build released!

Want to discuss my plugin: Visit our discord channel https://discord.gg/crapticraft


Dependancies:

  • None!

Soft Dependancies:

  • SuperVanish
  • PremiumVanish
  • EssentialsX

[---------------------------------------------------------------------------------------------------------------------------------------------------------------------

[YouTube](https://youtu.be/C1gil0xudQA)

Video graciously created by RAMShard

[------------------------------------------------------------------------------------------------------------------------------------------------------------------------]

Commands:

  • '/players' - Opens the main Player List GUI.
  • '/actions ' - Opens the Actions GUI.
  • '/punish - Opens the Punish GUI.
  • '/p show' - Sets the player out of vanish if either of the soft dependencies are installed.
  • '/p vanish' - Sets the player into vanish if either of the soft dependencies are installed.
  • '/p help' - Shows the in-chat help menu.
  • '/p reload' - Reloads the plugin config file.

Permission:

  ```
  permissions:
  playergui.*:
    description: "Gives access to all PlayerGUIAdvanced features."
    children:

      playergui.use:
        default: op
        description: "Allows the player to use the PlayerGUIAdvanced commands."
      playergui.mod:
        default: op
        description: "Allows the player to use the moderation features."
      playergui.ban:
        default: op
        description: "Allows the player to use the ban manager."
      playergui.op:
        default: op
        description: "Allows the player to use the op feature."
      playergui.deop:
        default: op
        description: "Allows the player to use the deop feature."
      playergui.exempt:
        default: op
        description: "Allows the player to be exempt from all PlayerGUIAdvanced punishments."
      playergui.vanish:
        default: op
        description: "Allows the player to use the vanish feature."
      playergui.show:
        default: op
        description: "Allows the player to use the show feature."
      playergui.help:
        default: op
        description: "Allows the player to use the help feature."
      playergui.reload:
        default: op
        description: "Allows the player to reload the plugin config file."
      playergui.update:
        default: op
        description: "Allows the player to receive update notifications."
  ```

Default Configs:

config.yml

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#                                   ----[PlayerGUIAdvanced]----                                     #
#                                    ----[By Loving11ish]----                                       #
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#                                  ----[Plugin Config File]----                                     #
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#PlayerGUIAdvanced config for 6.8.0

simple-mode:
 #Do you wish to use the simple mode?
  #This will disable the GUI's and only allow the use of /players command.
  #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'false'
  enabled: false

  commands:
   #Do you wish to use the simple mode commands?
    #These commands will be used instead of opening the Action GUI's.
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'true'
    enabled: true
    #Run command/s as console?
    #If false, the command will be run as the player who executed the command.
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'false'
    console-sender: false
    #Please enter the command/s below.
    #You do not need to include the '/' at the start of the command.
    #OPTIONS: 'anyList', PLACEHOLDERS: ['%target%']
    #DEFAULT:['tell %target% You are being watched!', 'kick %target% Get moderated on fool!']
    commands-list:
     - 'tell %target% You are being watched!'
      - 'kick %target% Get moderated on fool!'

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
general:
  developer-debug-mode:
   #Do you want to see a lot of debug messages in console when most actions are performed?
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'false'
    enabled: false

  gui-fillers:
   #Do you want to use the GUI fillers?
    #These are the items that fill the GUI's to make them look better.
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'true'
    enabled: true
    #What material do you want to use for the GUI fillers?
    #OPTIONS: 'material', PLACEHOLDERS: none, DEFAULT:'BLACK_STAINED_GLASS_PANE'
    material: 'BLACK_STAINED_GLASS_PANE'
    #What is the name of the GUI fillers?
    #OPTIONS: 'anyString', PLACEHOLDERS: none, DEFAULT:' '
    name: " "
    #What lore do you want to use for the GUI fillers?
    #OPTIONS: 'anyList', PLACEHOLDERS: none, DEFAULT:[]
    lore: []

  gui-menu-controls:
    previous-page:
     #What material do you want to use for the previous page button?
      #OPTIONS: 'material', PLACEHOLDERS: none, DEFAULT:'STONE_BUTTON'
      material: 'STONE_BUTTON'
      #What is the name of the previous page button?
      #OPTIONS: 'anyString', PLACEHOLDERS: none, DEFAULT:'&aPrevious Page'
      name: "&aPrevious Page"

    close-menu:
     #What material do you want to use for the close menu button?
      #OPTIONS: 'material', PLACEHOLDERS: none, DEFAULT:'BARRIER'
      material: 'BARRIER'
      #What is the name of the close menu button?
      #OPTIONS: 'anyString', PLACEHOLDERS: none, DEFAULT:'&cClose'
      name: "&4Close"

    next-page:
     #What material do you want to use for the next page button?
      #OPTIONS: 'material', PLACEHOLDERS: none, DEFAULT:'STONE_BUTTON'
      material: 'STONE_BUTTON'
      #What is the name of the next page button?
      #OPTIONS: 'anyString', PLACEHOLDERS: none, DEFAULT:'&aNext Page'
      name: "&aNext Page"

messages.yml

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#                                   ----[PlayerGUIAdvanced]----                                     #
#                                    ----[By Loving11ish]----                                       #
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#                                ----[Plugin Messages Config]----                                   #
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#PlayerGUIAdvanced messages for 6.8.0

prefix: "&e[&bPGUIA&e]"

simplemode-enabled-message: "&cSimplemode has been enabled by an administrator!"

player-list-menu-last-page: "&7You are on the last page."
player-list-menu-first-page: "&7You are on the first page."

player-not-found: "&cThe player &e%target% &ccould not be found!"

#If an error occurs, ensure that the '%target%' is present
actions-command-no-player-provided: "&cPlease provide a player to moderate. /actions <player>"
punish-command-no-player-provided: "&cPlease provide a player to punish. /punish <player>"

#Show-command-VanishAPI-not-detected:
vanishAPI-not-found-1: "&4This command is only active if either SuperVanish or PremiumVanish are installed!"
vanishAPI-not-found-2: "&4SuperVanish: &dhttps://www.spigotmc.org/resources/supervanish-be-invisible.1331/"
vanishAPI-not-found-3: "&4PremiumVanish: &dhttps://www.spigotmc.org/resources/premiumvanish-stay-hidden-bungee-support.14404/"

show-command-player-not-vanished: "&eYou are not vanished and are already visible to other players!"
show-command-player-visible: "&eYou are now visible to other players"

vanish-command-player-already-vanished: "&eYou are already vanished and are invisible to other players!"
vanish-command-player-invisible: "&eYou are now invisible to other players"

player-only-command: "&4That command can only be executed by a player."

plugin-reload-begin: "&aBeginning plugin reload..."
plugin-reload-broadcast: "&aThe plugin is being reloaded, please do not use any commands until complete!"
plugin-reload-successful: "&aThe plugin reload is complete!"

targeted-player-op-successful: "&ePlayer %target% has been successfully made an op!"
targeted-player-deop-successful: "&ePlayer %target% has been successfully removed from op!"

successfully-kicked-player-chat: "&cYou kicked &d%target%"

no-permission: "&4You do not have the permission to do that!"

target-ban-exempt: "&cThat player is exempt from punishment!"

disabled-GUI-Feature: "&cThis feature has been disabled by an admin!"

#Plugin-update-available:
update:
  1: "&4*-------------------------------------------*"
  2: "&cA new version is available!"
  3: "&4*-------------------------------------------*"

#Plugin-no-new-update:
no-update:
  1: "&a*-------------------------------------------*"
  2: "&aPlugin is up to date!"
  3: "&a*-------------------------------------------*"
update-check-failure: "Unable to check for updates! - &c"

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#Incorrect-command-syntax-console:
console-syntax-error:
 - "&4Please provide an argument!\n"
  - "&fp reload\n"
  - "&fp help"

#Plugin-help-chat-menu
help-menu:
 - "&f\n"
  - "&7----- &e[&bPlayerGUIAdvanced&e] &7-----&r\n"
  - "&6PGUIA command usage:\n"
  - "&3/actions <player> &7- &dThis command opens up the Actions GUI.\n"
  - "&3/punish <player> &7- &dThis command opens up the Punish GUI.\n"
  - "&3/players &7- &dThis command opens up the Player List GUI.\n"
  - "&3/p reload &7- &dThis command reloads the plugin config file.\n"
  - "&3/p vanish &7- &dThis command sets you into vanish.\n"
  - "&3/p show &7- &dThis command sets you out of vanish.\n"
  - "&3/p help &7- &dThis command shows this help menu.\n"
  - "&f\n"
  - "&7----- &e[&bPermissions&e] &7-----&r\n"
  - "&6PGUIA permissions:\n"
  - "&7- &3playergui.use\n"
  - "&7- &3playergui.mod\n"
  - "&7- &3playergui.ban\n"
  - "&7- &3playergui.op\n"
  - "&7- &3playergui.deop\n"
  - "&7- &3playergui.exempt\n"
  - "&7- &3playergui.vanish\n"
  - "&7- &3playergui.show\n"
  - "&7- &3playergui.help\n"
  - "&7- &3playergui.reload\n"
  - "&7- &3playergui.update\n"
  - "&f\n"
  - "&7----- &e[&bPlayerGUIAdvanced&e] &7-----&r\n"
  - "&f"

playersgui.yml

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#                                   ----[PlayerGUIAdvanced]----                                     #
#                                    ----[By Loving11ish]----                                       #
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#                                  ----[PlayerListGUI Config]----                                   #
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#PlayerGUIAdvanced PlayerListGUI for 6.8.0

player-list:
 #Player list GUI name
  #OPTIONS: 'anyString', PLACEHOLDERS: none, DEFAULT:'&bPlayer List'
  menu-title: "&bPlayer List"

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
  items:
    1:
      material: 'PLAYER_HEAD'
      name: "&e%target%"
      lore:
        - "&fPlayer Health: &d%health%"
        - "&fPlayer Food: &d%food%"
        - "&fPlayer XP: &d%xp%"
        - "&fGamemode: &d%game-mode%"
        - "&fVanished: &d%vanished%"
        - "&fEss Vanished: &d%ess-vanished%"
        - "&fHas Fly: &d%fly-State%"
        - "&fWorld: &d%world%"
        - "&fIs OP: &d%op-state%"
        - "&7=============================="
        - "&fUUID: &9%uuid%"
        - "&7=============================="
        - "&a&oClick me"

actionsgui.yml

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#                                   ----[PlayerGUIAdvanced]----                                     #
#                                    ----[By Loving11ish]----                                       #
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#                                   ----[ActionsGUI Config]----                                     #
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#PlayerGUIAdvanced ActionsGUI for 6.8.0

actions-gui:
 #Actions GUI name
  #The Actions GUI has a total of 18 inventory slots.
  #If an error occurs, ensure that the '%target%' is present within the title name.
  #OPTIONS: 'anyString', PLACEHOLDERS: '%target%', Default: '&bActions: %target%'
  menu-title: "&bActions: %target%"

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
  #Ban manager GUI items
  items:
    1:
      slot: 1
      action: 'KICK'
      material: 'WOODEN_AXE'
      name: "&c&lKick Player"
      lore:
       - "&aThis performs the /kick command"
        - "&aand is issued by you, not the console."
        - "&dYOU REQUIRE KICK PERMISSIONS FOR THIS TO WORK!"
    2:
      slot: 2
      action: 'MUTE'
      material: 'FEATHER'
      name: "&c&lMute Player"
      lore:
       - "&aThis performs the /mute command"
        - "&aand is issued by you, not the console."
        - "&dYOU REQUIRE MUTE PERMISSIONS FOR THIS TO WORK!"
    3:
      slot: 5
      action: 'TELEPORT'
      material: 'PLAYER_HEAD'
      name: "&e%target%"
      lore:
       - "&6Teleport To This Player"
        - "&aThis will also set you into Spectator mode"
        - "&abefore teleportation"
    4:
      slot: 8
      action: 'INVENTORY'
      material: 'CHEST'
      name: "&c&lView Inventory"
      lore:
       - "&aThis opens the targeted players inventory"
    5:
      slot: 9
      action: 'OP'
      material: 'LIME_CONCRETE'
      name: "&c&lOp Player!"
      lore:
       - "&aThis grants this player"
        - "&aoperator status"
    6:
      slot: 10
      action: 'BAN'
      material: 'BEDROCK'
      name: "&c&lBan Player"
      lore:
       - "&aThis opens the Ban Manager GUI"
        - "&aand allows you to choose the ban length"
    7:
      slot: 11
      action: 'UNMUTE'
      material: 'DRAGON_BREATH'
      name: "&e&lUnmute Player"
      lore:
       - "&aThis performs the /unmute command"
        - "&aand is issued by you, not the console."
        - "&dYOU REQUIRE UNMUTE PERMISSIONS FOR THIS TO WORK!"
    8:
      slot: 17
      action: 'ENDER_CHEST'
      material: 'ENDER_CHEST'
      name: "&c&lView Enderchest"
      lore:
       - "This opens the targeted players enderchest"
    9:
      slot: 18
      action: 'DEOP'
      material: 'RED_CONCRETE'
      name: "&c&lDeop Player"
      lore:
       - "&aThis revokes this player's"
        - "&aoperator status"

  back-button:
    slot: 14
    material: 'BARRIER'
    name: "&4&oClick to go back"
    lore:
     - "&7This takes you back to the"
      - "&7Player List GUI"

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
  features:
   #Do you wish to use the GUI based /op feature?
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'true'
    enable-op: true
    #Do you wish to use the GUI based /deop feature?
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'true'
    enable-deop: true
    #Do you wish to use the GUI based player inventory view feature?
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'true'
    enable-inventory: true
    #Do you wish to use the GUI based player Enderchest view feature?
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'true'
    enable-enderchest: true
    #Do you wish to use the GUI based /mute feature?
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'true'
    enable-mute: true
    #Do you wish to use the GUI based /unmute feature?
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'true'
    enable-unmute: true
    #Do you wish to use the GUI based /kick feature?
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'true'
    enable-kick: true

    #Commands:
    #OPTIONS: 'anyString', PLACEHOLDERS: ['%target%']
    mute-command: 'mute %target% You have been muted by an operator'
    unmute-command: 'unmute %target%'
    kick-command: 'kick %target% You were kicked by an operator'

bangui.yml

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#                                   ----[PlayerGUIAdvanced]----                                     #
#                                    ----[By Loving11ish]----                                       #
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#                                    ----[BanGUI Config]----                                        #
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
#PlayerGUIAdvanced BanGUI for 6.8.0

#Do you wish to use the GUI based ban manager?
ban-manager:
   #Do you wish to use the ban manager GUI?
    #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'true'
    enabled: true
    #Ban manager GUI name:
    #If an error occurs, ensure that the '%target%' is present within the title name.
    #OPTIONS: 'anyString', PLACEHOLDERS: ['%target%'], DEFAULT:'&bBan: %target%'
    menu-title: "&bBan: %target%"

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
    #Ban manager GUI items:
    #If an error occurs, try adding the '%target%' variable within the command.
    #Example:
    #  1:
    #    slot: 9
    #    material: 'STICK'
    #    name: "&e1 Hour Ban"
    #    lore:
    #      - "&aThis performs the /warn <message> command"
    #      - "&aThe message is as below:"
    #      - "&dYou have been warned by a member of staff. Any further issues may result in a ban!"
    #    commands:
    #      - 'warn %target% You have been warned by a member of staff. Any further issues may result in a ban!'

    ##SLOT 5 IS RESERVED FOR THE PLAYERS NAME ITEM!##
    ##SLOT 50 IS RESERVED FOR THE CLOSE ITEM!##
    items:
        1:
            slot: 11
            material: 'WRITABLE_BOOK'
            name: "&e&lWarn Player"
            lore: []
            commands: []
        2:
            slot: 13
            material: 'BOOK'
            name: "&e&lMute Player"
            lore: []
            commands: []
        3:
            slot: 15
            material: 'WOODEN_AXE'
            name: "&e&lTempban Player"
            lore: []
            commands: []
        4:
            slot: 17
            material: 'FLINT_AND_STEEL'
            name: "&c&lPerm Ban Player"
            lore: []
            commands: []
        5:
            slot: 20
            material: 'STICK'
            name: "&eWarning"
            lore:
               - "&aThis performs the /warn <message> command"
                - "&aThe message is as below:"
                - "&dYou have been warned by a member of staff. Any further issues may result in a ban!"
            commands:
               - 'warn %target% You have been warned by a member of staff. Any further issues may result in a ban!'
        6:
            slot: 22
            material: 'FEATHER'
            name: "&e1 Hour Mute"
            lore:
               - "&aThis performs the /tempmute <message> command"
                - "&aThe messgae is as below:"
                - "&dYou have been temporarily muted for repeated chat violation!"
            commands:
               - 'tempmute %target% 1hour You have been temporarily muted for repeated chat violations!'
        7:
            slot: 24
            material: 'GRASS_BLOCK'
            name: "&e1 Hour Ban"
            lore:
               - "&aThis performs the /tempban <message> command"
                - "&aThe message is as below:"
                - "&dYou have been temporarily banned from this server for repeated rule violations!"
            commands:
               - 'tempban %target% 1hour You have been temporarily banned from this server for repeated rule violations!'
        8:
            slot: 26
            material: 'BEDROCK'
            name: "&cPerm Ban"
            lore:
               - "&aThis performs the /ban <messgae> command"
                - "&aThe message is as follows"
                - "&dYou have been permanantly banned from this server :/"
            commands:
               - 'ban %target% You have been permanantly banned from this server :/'
        9:
            slot: 31
            material: 'PAPER'
            name: "&e1 Day Mute"
            lore:
               - "&aThis performs the /tempmute <message> command"
                - "&aThe messgae is as below:"
                - "&dYou have been muted for 1 day for severe chat violations!"
            commands:
               - 'tempmute %target% 1day You have been muted for 1 day for severe chat violations!'
        10:
            slot: 33
            material: 'SMOOTH_STONE'
            name: "&e1 Day Ban"
            lore:
               - "&aThis performs the /tempban <message> command"
                - "&aThe message is as follows:"
                - "&dYou have been temporarily banned from this server for severe rule violations!"
            commands:
               - 'tempban %target% 1day You have been temporarily banned from this server for severe rule violations!'
        11:
            slot: 35
            material: 'ANVIL'
            name: "&cIP-Ban"
            lore:
               - "&aThis performs the /ipban <message> command"
                - "&aThe message is as follows:"
                - "&dYour ip has been permanantly banned from this server :/"
            commands:
               - 'ipban %target% Your ip has been permanantly banned from this server :/'
        12:
            slot: 40
            material: 'COBWEB'
            name: "&e7 Day Mute"
            lore:
               - "&aThis performs the /tempmute <message> command"
                - "&aThe message is as below:"
                - "&dYou have been muted for 7 days for extreme chat violations!"
            commands:
               - 'tempmute %target% 7day You have been muted for 7 days for extreme chat violations!'
        13:
            slot: 42
            material: 'OBSIDIAN'
            name: "&e7 Day Ban"
            lore:
               - "&aThis performs the /tempban <message> command"
                - "&aThe Message is as follows:"
                - "&dYou have been temporarily banned from this server for extreme rule violations!"
            commands:
               - 'tempban %target% 7day You have been temporarily banned from this server for extreme rule violations!'

    close-button:
        material: 'BARRIER'
        name: "&4&oClick to close"
        lore: []
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
    banned-player-message:
       #Do you wish to have the banned player say a final message?
        #OPTIONS: 'true'/'false', PLACEHOLDERS: none, DEFAULT:'true'
        enabled: true
        #Banned player message:
        #OPTIONS: 'anyList', PLACEHOLDERS: none, DEFAULT:'&cOh dear, I got banned! :-('
        message:
           - "&dI'm naughty.\n"
            - "&cOh dear, I got banned! :-("

To Do:

  • Add a lang.yml for the ability to customise the plugins messages. - COMPLETE V5.2
  • Add the ability for the plugin to read HEX colour codes in messages. - COMPLETE V5.2
  • Reintroduce console commands that follow the new tabbed syntax. - COMPLETE V5.1
  • Recode the plugin to allow for a paginated menu system. - COMPLETE V5.0
  • Add a banned player message sent by the target as they are banned. - COMPLETE V4.1
  • Add a dedicated Punish GUI with /punish command for quick banning online players. - COMPLETE V3.9
  • Add permission node to make a player exempt to banning. - COMPLETE V3.8
  • Add the ability to change the ENUM material for each ban item. - COMPLETE V3.8
  • Add API compatibility with 'PremiumVanish' plugin. - COMPLETE V3.4
  • Add integration for EssentialsX to show if a player is Essentials vanished. - COMPLETE V6.7.1

This plugin was inspired by a plugin created by the owners of the Performium Server, this plugin is in NO way associated with the Performium server, its staff or owners.

DO NOT POST ISSUES OR ERRORS IN THE REVIEWS SECTION! ANY POSTED IN THERE WILL BE IGNORED! PLEASE POST IN THE DISCUSSION THREAD OR JOIN OUR DISCORD AND CREATE A SUPPORT TICKET!

Information

CategoryAdmin Tools
Published onOctober 27, 2023
LicenseMIT
Downloads144
Stars2
Watchers0
Supports Folia

Pinned Versions

Members