PunishmentGUI - LiteBansGUI, AdvancedBan & More (1.8-1.21.x+
1.1.13A spigot PunishmentGUI plugin, completely configurable, unlimited items and menus!
1.1.13latestLatest Version SupportMay 27, 2026 Updated to support the latest spigot and java versions1.1.121.21.6 SupportJun 29, 2025 Updated to support 1.21.5 and 1.21.6 Updated Skulls plugin support Updated Head Database support Fixed an issue where on newer minecraft versions the GUI title was limited1.1.111.21.4 SupportDec 31, 2024 Changes: Updated APIs Updated Skulls support Added native support for 1.21.41.1.10API Updates + 1.21+ Native SupportNov 24, 2024 Long time no see... Changes: Updated all APIs to support all new versions of Spigot Updated Skulls to work with the updated APIs Fixed issue with glow showing the enchants on some versions Updated spigot version check to detect when using 1.21-1.21.3.1.1.9Dependency & API UpdatesMar 25, 2024 These changes update some of the optional dependencies and versions of APIs we use along with adding new ways to use heads in menus with base64 and other aspects. https://punishmentgui.bghddevelopment.com/skulls-in-menus · Update spigot skull system by @RyanMoodGAMING in #14 · Added an executor placeholder ({executor}) by @SolarBAM404 in #13 · Updated ConfigItem by @BGHDDevelopment · Updated XSeries compile by @BGHDDevelopment · Version push by @BGHDDevelopment1.1.8Glow Error FixDec 27, 2023 Fixed an error caused by Glow on startup1.1.7Fill Item UpdateMay 20, 2023 Hey all! We have changed the way fill-items work to match the other item system in the plugin. This will allow fill items to support custom data. You will need to modify your fill section of the config to match this item format: Code (Text): fill-menu: enabled: true item: name: " " material: "STAINED_GLASS_PANE" amount: 1 durability: 0 lore: []1.1.6Autocomplete Fix/SupportOct 16, 2022 Changes: You can now autocomplete names for players when typing /punish1.1.5Fixes + Custom Model Support [CONFIG CHANGES REQUIRED]Aug 24, 2022 Needed Config Change! All items will now need an amount specified. You will need to update your existing configs. Add Code (Text): amount: 1 to existing items. Example Item: Code (Text): ClientModOffensesItem: name: "&a&lClient Mod Offenses" material: "IRON_SWORD" amount: 1 durability: 0 slot: 14 message: enabled: false text: "&eHello &b{player}!" command: enabled: false #Put command without / execute: - "" action: "" lore: - "" - '&7X-Ray, Forcefield, Speed, Fly, Inventory Hacks, etc' - "" Changes: · Fixed HEX colors not working - Refrac · Added support for custom models in the GUI - Refrac/Noodles · Added the amount requirement to the config to allow for users to specify how many of an item should be listed. · Default config updated with amount: 1 · Small other changes Learn about custom menu data: https://punishmentgui.bghddevelopment.com/custom-menu-ite…1.1.41.19 SupportJun 17, 2022 Items & glow updated for 1.19 Added a default config for 1.13+ users on the wiki: https://punishmentgui.bghddevelopment.com/default-config-…1.1.3Command Framework Recode + New MessagesApr 28, 2022 Changes: Pushed version to 1.1.3 New messages that were not translatable were added to the language.yml file. Removed commands.yml Recoded backend command framework Recoded backend listener framework Recoded existing commands to new framework Fixed issue with console messages not always matching Fixed issue with HEX colors not being applied. Use like <#hex> Fixed issue with version check and glow Cleared old code. Updated to latest HeadDatabase API version. Updated native version to 1.18 (This does not remove legacy version support)1.1.2Version FixesApr 10, 2022 Changes: Fixed issues with items between versions caused by a glitch with GitHub.1.1.1Small Changes & FixesApr 9, 2022 Changes: Fixed glow on 1.17/1.18 Recoded the update checker. It now uses only Cloudflare and does not need to check our backend systems. Everything is automatic!1.1.0Item Name Version Support + Glow FixDec 29, 2021 Item names are now based upon the active server version. NOTE: This means that existing items may appear as redstone blocks due to this change. Please change the item to one from your base spigot version. Glow is fixed on 1.16+ servers.1.0.9Alternative Skull Plugin SupportDec 6, 2021 You can find the changelog on the GitHub download page, but in short, Skulls is now supported as a free alternative to HeadDatabase.1.0.8Placeholder Update & Open SourceOct 25, 2021 The {player} placeholder can now be used within the GUI items. The plugin is now open source: https://github.com/BGHDDevelopment/PunishmentGUIRecode1.0.7PunishmentGUI 1.0.7 - Menu Title Placeholders & Head Database SupportAug 18, 2021 {player} and {target} placeholders can now be used in menu titles. HeadDatabase is now supported for skulls. Wiki: https://punishmentgui.bghddevelopment.com/skulls-in-menus1.0.6Multiple Commands Per ItemApr 10, 2021 This update includes config changes. Read the changelog! Changelog + Config Changes: https://punishmentgui.bghddevelopment.com/update-changelo…1.0.5FixesFeb 19, 2021 Fixed issues with the reload and punish commands being run by console returning errors. It will now check for console sender on commands.1.0.4Skull SupportJan 8, 2021 1.0.3Item Glow, Menu Update, New Download PageDec 9, 2020 1.0.2FixesJul 30, 2020 Fixed issues with permissions not applying1.0.1Reload commandJul 24, 2020 The plugin can be reloaded now with /punishreload if you have the perm: punish.admin1.0.0Full Recode! | Unlimited GUI's & Items, Cleaner Configs, Easy SetupJul 22, 2020 Well after a long wait I am finally ready to release PunishmentGUI V1.0.0! This recode brings the ability to make unlimited menus, items and configure them fully in one easy config file! You must delete the old config folders, this update replaces all the old systems! Questions? https://bghddevelopment.com/discord Want to support us? https://patreon.com/bghddevelopment Please Note: By default, the config is designed for LiteBans commands but you may change the commands to work with ANY punishment plugin that uses commands.0.0.7Download ChangedMar 23, 2020 We have updated the download page for the plugin! When you click download you will now have the option to continue to download directly from GitHub or support us through redirecting to adfly then to GitHub. This also allows us to release updates on GitHub rather than directly from Spigot to improve backend organization and encourage more collaboration. If you have any questions or issues with this new download system reach out to me ASAP on discord. https://bghddevelopment.com/discord0.0.60.0.6 - Release Build (Item ID's, Filler Items, Config Reload Fix)Feb 6, 2020 Thank you to Thinkverse for your contributions on GitHub! THIS UPDATE INCLUDES NEW THINGS YOU MUST ADD TO YOUR CONFIG TO AVOID ERRORS, PLEASE CHECK THE CHANGELOG AND ADD THE NEW SETTINGS! Changelog + Config Changes - https://wiki.bghddevelopment.com/bo...tebansgui-advancedb…0.0.5Fixed 0.0.5Jan 8, 2020 Fixed 1 issue on 0.0.5 (This version # will not change) Thanks to the user who created the pull request on GitHub.0.0.4Fixes & New Config ItemNov 21, 2019 Changelog + Needed config changes: https://wiki.bghddevelopment.com/bo...tebansgui-advancedb…0.0.3Config Link FixesNov 20, 2019 Changes: https://wiki.bghddevelopment.com/bo...tebansgui-advancedb… Cross-Server/Network setup guide: https://wiki.bghddevelopment.com/bo...ancedbangui/page/bu… Feedback/Ideas: https://feedback.bghddevelopment.com0.0.2Update Checker ChangesOct 26, 2019 Remade a few messages, fixed a possible bug Have ideas? https://feedback.bghddevelopment.com0.0.1PunishmentGUI! - Major ChangesSep 28, 2019 Welcome to the new and improved PunishmentGUI plugin! LiteBansGUI and AdvancedBanGUI have combined and are now one plugin! More exciting than that PunishmentGUI now supports any punishment plugin which has commands! We have a brand new wiki page! https://wiki.bghddevelopment.com/books/punishmentgui---li… You can find all the information you need on this page! For the full changelog on this update please visit: https://wiki.bghddevelopment.com/bo...tebansgui-advancedb… Commands Changed: /litebansgui is now /punishmentgui /litebansguireload is now /punishmentguireload [punish.reload] Update join notification permission has been changed to [punishmentgui.update]3.1ChangesJun 15, 2019 Fixed some messages not sending Improved overall plugin (Thanks to GitHub contributor: Guuuudd) Moved plugin over to maven while coding. Fixed a few things3.0Reload config, fixes, other changesJun 12, 2019 3.0 is a fully tested stable update! Tested on versions 1.8,1.9,1.10,1.11,1.12,1.13,1.14,1.14.2 For support please join our support discord https://bghddevelopment.com/discord Changes: Added /litebansguireload - Reloads config file to make changes take effect when in game. This allows you to see your changes live. (Permission: punish.reload) Added a dev debug message. Only I will receive this if I join a server using LiteBansGUI. This can allow me to check the version of the plugin and to find issues. Feel free to view what this does here: https://github.com/BGHDDevelopment/...oodles/gui/main/upd… Fixed a few messages in the console. The lines now cover the full loading message. Fixed an error that would fire if clicking on the outside of the GUI. Video: 2.9Offline Player SupportJun 11, 2019 You can now ban players that are offline through the GUI (This was highly requested)2.8May 18, 2019 2.7HOTFIXMay 12, 2019 PLEASE UPDATE TO THIS VERSION Changes: Fixed a major issue/error2.6More fixesMay 11, 2019 Fixed another issue with adding 1.14 support1.51.14 UpdateMay 11, 2019 WARNING: 1.14 SUPPORT IS IN ALPHA. THERE COULD BE ISSUES! PLEASE REPORT ALL ISSUES TO OUR DISCORD: https://bghddevelopment.com/discord You should be able to run the plugin on any 1.8-1.14 spigot jars. Changes: Added 1.14 support Removed unused code Fixed a few things1.4Code CleanupMay 9, 2019 Removed some unused code.1.3Start messages + fixesApr 10, 2019 Changes: Updated start messages Fixed a few things Added /litebansgui command1.2Added configurable commands [HIGHLY REQUESTED]Apr 9, 2019 HIGHLY REQUESTED UPDATE! Changes: Added configurable commands. New config: guicommands.yml Code (Text): #Welcome to the commands.yml file, feel free to change the commands around for each item. Reasons can be changed in the banreason.yml file. #For support please contact us on discord: https://bghddevelopment.com/discord #Placeholders: #%target% - Player you are punishing #%t% - Time #%reason% - Punish reason #Perm Mute PermMuteCommand: "/mute %target% %reason% -s" #IPMute IPMuteCommand: "/ipmute %target% %reason% -s" #Perm Ban PermBanCommand: "/ban %target% %reason% -s" #IPBan IPBanCommand: "/ipban %target% %reason% -s" #Serv 1 Mute Severity1MuteCommand: "/mute %target% %t% %reason% -s" #Serv 2 Mute Severity2MuteCommand: "/mute %target% %t% %reason% -s" #Serv 3 Mute Severity3MuteCommand: "/mute %target% %t% %reason% -s" #Serv 1 General Ban Severity1GeneralBanCommand: "/ban %target% %t% %reason% -s" #Serv 1 Client Ban Severity1ClientBanCommand: "/ban %target% %t% %reason% -s" #Serv 2 Client Ban Severity2ClientBanCommand: "/ban %target% %t% %reason% -s" #Serv 3 Client Ban Severity3ClientBanCommand: "/ban %target% %t% %reason% -s" #Warm WarnCommand: "/warn %target% %reason% -s" Video: To keep default settings leave the config as it is when generated. It will load and work the same as normal. If you want to change commands you are free to do so. Questions: https://bghddevelopment.com/discord1.1Removed need for custom permissionsFeb 24, 2019 Changes: All players using the GUI must have the Litebans permission for that punishment This update removes the custom permissions that were duplicates to Litebans.1.0Stable Release - 1.0Jan 2, 2019 Sorry for no updates. Been very busy with other plugins! For updates and new plugin announcements join the discord! https://discord.gg/VB8kB8P THIS UPDATE IS A STABLE RELEASE: This means it has been tested on most mincraft versions and they work without issues. Please note when using in 1.9+ you must change some of the items in the guiitems.yml or you will get block errors. Just change the block to the 1.9 block and it will work fine. Other changes: Fixed config spacing Updated the litebans version I was using so new versions should work with no issues. 0.16HotfixOct 18, 2018 Fixed a error on startup0.15Fix with configOct 17, 2018 You need to reset your configs if posible or add: Code (Text): #IPMute: IPMuteItem: "TNT" IPMuteLocation: 7 IPMuteName: "&a&lIP Mute" IPMuteLore: - '&fMute Duration: &eIP MUTE' - ' ' - ' ' #IPBan: IPBanItem: "TNT" IPBanLocation: 8 IPBanName: "&a&lIP BAN" IPBanLore: - '&fBan Duration: &eIP BAN' - ' ' - ' ' To the guiitems.yml and Code (Text): #IPBAN: IPBanMessage: "&7Banned %player% for 1 month for Fly Hack/Forcefield/Speed Hack/Reach Hack/Other Hack - Also for second offenders!" IPBanReason: "IPBAN - Network Ban" #IPMUTE: IPMuteMessage: "&7Banned %player% for 1 month for Fly Hack/Forcefield/Speed Hack/Reach Hack/Other Hack - Also for second offenders!" IPMuteReason: "IPMUTE - Network Ban" To ban reason.yml0.14IPBan + IPMute addedOct 14, 2018 Added IPMute and IPBan to the GUI Permissions: punish.ipban punish.ipmute 0.13bStatsSep 22, 2018 https://bstats.org/plugin/bukkit/LiteBansGUI BStats Added0.12Removed 1 ThingSep 15, 2018 Changes: Removed the DEV item that was my copyright. This is due to too many people complaining. But please do not claim my plugin as your own.0.11Bug FixAug 8, 2018 Fixed a issue with Gen1Ban not working.0.10Cleaned Up Unused CodeAug 7, 2018 This update removes code that was not needed. In doing so lowered plugin size.0.9Bungeecord SupportAug 7, 2018 Hello! This update adds support for when LiteBans is on bungeecord. This has been highly requested. Please note the player runs the command so make sure to make it so that the player also has LiteBan perms for the command there running via the GUI.0.8Player now issues command.Jul 25, 2018 The console no longer issues ban commands. The player who clicks the item in the inventory will now issue the ban. Please give the players who have access to /punish permissions to use litebans commands. 0.7Glass FixJul 25, 2018 Fixed an issue were glass would not fill empty spaces. Source is updated as well at the github page.0.6Item FixJul 19, 2018 Please use this list when changing items in the guiitems.yml http://docs.codelanx.com/Bukkit/1.8/org/bukkit/Material.html Fixed a issue that would get errors if using not all items.0.5GUI Item FixApr 7, 2018 Fixed a issue with the items not appearing in the GUI unless you clicked once. The items will now appear when you open the GUI. Plugin is now open source here: https://github.com/BGHDDevelopment/LiteBansGUI0.4Fixes + PermissionsApr 5, 2018 Fixed a double ban issue. Added permissions for each option: Permissions: punish.use punish.permmute punish.permban punish.warning punish.severity1generalban punish.severity1clientban punish.severity2clientban punish.severity3clientban punish.severity1mute punish.severity2mute punish.severity3mute There is no permission denied message, the player just cant click the item if they don't have the permission.0.3Small FixesFeb 27, 2018 Fixed a few GUI issues Fixed a issue with messages Fixed a color code issue ================================ Need Support? Found Bugs? Join the support discord server: https://discord.gg/QbbXPNG ================================ 0.2More Config Options + Update CheckerJan 19, 2018 Please reset your guiitems.yml file! Added: Update Checker Code Fixes Added the config options to pick the locations of items in the gui The config now: Code (Text): #In this file you can change all lore, names and items for the GUI. #Please use this list for the item names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Mater… #Note: This list is for 1.12 the plugin is based in 1.8! Only use blocks that you are running on your server! #======================================================= #Sections: #ClientModOffenses: ClientModOffensesItem: "IRON_SWORD" ClientModOffensesLocation: 14 ClientModOffensesName: "&a&lClient Mod Offenses" ClientModOffensesLore: - '&7X-ray, Forcefield, Speed, Fly, Inventory Hacks, etc' #GeneralOffenses: GeneralOffensesItem: "HOPPER" GeneralOffensesLocation: 12 GeneralOffensesName: "&a&lGeneral Offenses" GeneralOffensesLore: - '&7Command/Map/Class/Skill exploits, etc' #ChatOffenses: ChatOffensesItem: "BOOK_AND_QUILL" ChatOffensesLocation: 10 ChatOffensesName: "&a&lChat Offenses" ChatOffensesLore: - '&7Verbal Abuse, Spam, Harassment, Trolling, etc' #Other Punishments: #Warning: WarningItem: "ANVIL" WarningLocation: 43 WarningName: "&a&lWarning" WarningLore: - ' ' - '&7Example Warning Input:' - '&fSpam - Repeatedly writing MEOW' - '&fHack Accusation - Accused Tomp13 of hacking' - '&fTrolling - was trying to make bob angry in chat ' - ' ' #ChatPunishments: #PermMute: PermanentMuteItem: "PAPER" PermanentMuteLocation: 25 PermanentMuteName: "&a&lPermanent Mute" PermanentMuteLore: - '&fMute Duration: &ePermanent' - ' ' - '&7Severe Advertising' - '&fJOIN MINECADE! THIS SERVER IS TRASH' - ' ' - '&7Other Severe Offense' - '&fDDOS Threats/Death Threats ETC' - ' ' #Severity1Mute: Severity1MuteItem: "INK_SACK" Severity1MuteLocation: 19 Severity1MuteName: "&a&lSeverity 1" Severity1MuteLore: - '&fMute Duration: &e1 Hour' - ' ' - '&7Light Spam' - '&fSending the same message 2-5 times' - ' ' - '&7Light Advertising' - '&fanyone want to play on minecade?' - ' ' - '&7Light Abuse/Harassment' - '&fyou are so bad at this game' - ' ' - '&7Hackusations' - '&fyoure such a hacker!' - ' ' #Severity2Mute: Severity2MuteItem: "INK_SACK" Severity2MuteLocation: 28 Severity2MuteName: "&a&lSeverity 2" Severity2MuteLore: - '&fMute Duration: &e1 Week' - ' ' - '&7Medium Spam' - '&fSending the same message 6-20 times' - ' ' - '&7Medium Advertising' - '&fjoin trash.server.net' - ' ' - '&7Medium Abuse/Harassment' - '&fyoure terrible, learn to play' - '&ftrash off you stupid newb' - ' ' - '&7Avoiding Chat Filter' - '&f|_|<S YOU' - ' ' #Severity3Mute: Severity3MuteItem: "INK_SACK" Severity3MuteLocation: 37 Severity3MuteName: "&a&lSeverity 3" Severity3MuteLore: - '&fMute Duration: &e1 Month' - ' ' - '&7Severe Spam' - '&fSending the same message 20+ times' - '&fSpam Bot' - ' ' - '&7Severe Abuse/Harassment' - '&fGO DIE' - ' ' #ClientPunishments: #PermBan: PermanentBanItem: "REDSTONE_BLOCK" PermanentBanLocation: 34 PermanentBanName: "&a&lPermanent Ban" PermanentBanLore: - '&fBan Duration: &ePermanent' - ' ' - '&7Severe Threats' - '&fKILL THEM ALL WERE GOING TO HACK THE SERVER' - ' ' #Severity1GeneralBan: Severity1GeneralBanItem: "INK_SACK" Severity1GeneralBanLocation: 21 Severity1GeneralBanName: "&a&lSeverity 1" Severity1GeneralBanLore: - '&fBan Duration: &e1 Hour' - ' ' - '&7Team Killing' - '&fIntentionally killing your team' - ' ' - '&7Trolling (Gameplay)' - '&fUsing abilities to trap players in spawn' - ' ' - '&7Map/Bug Exploiting' - '&fAbusing an exploit to gain an advantage' - ' ' #Severity1ClientBan: Severity1ClientBanItem: "INK_SACK" Severity1ClientBanLocation: 23 Severity1ClientBanName: "&a&lSeverity 1" Severity1ClientBanLore: - '&fBan Duration: &e1 Day' - ' ' - '&7Examples' - '&fDamage Indicators' - '&fPlayer Radar' - ' ' #Severity2ClientBan: Severity2ClientBanItem: "INK_SACK" Severity2ClientBanLocation: 32 Severity2ClientBanName: "&a&lSeverity 2" Severity2ClientBanLore: - '&fBan Duration: &e1 Week' - ' ' - '&7Examples' - '&fForcefield' - '&fSpeed Hack' - '&fReach Hack' - '&fOther Hack' - '&cFirst Offense Only!' - ' ' #Severity3ClientBan: Severity3ClientBanItem: "INK_SACK" Severity3ClientBanLocation: 41 Severity3ClientBanName: "&a&lSeverity 3" Severity3ClientBanLore: - '&fBan Duration: &e1 Month' - ' ' - '&7Examples' - '&fForcefield' - '&fSpeed Hack' - '&fReach Hack' - '&fFly Hack' - '&fOther Hack' - '&cAlso for second offenders!' - ' ' 0.1Jan 15, 2018
Similar projects
Config →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
26.2MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.9MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
4.7MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta