\n# What can I do with EasyCommandBlocker?<\/p>\n
This plugin allows you to completely block commands in a fast and easy way. You can even hide these commands from tab completion in the chat, or define a list of permitted commands to show.<\/p>\n
There are countless of command blocker plugins, why another? I made this plugin simply because I couldn’t find one that manages to work properly in recent Minecraft versions, most of these plugins are outdated or paid.<\/p>\n
> EasyCommandBlocker has been tested on:<\/p>\n
“`
\n– Paper 1.16.5 with ViaVersion, ViaBackwards, ViaRewind (Command tab completion is hidden for 1.8-1.21 versions)
\n– Purpur 1.18.2 with ViaVersion, ViaBackwards, ViaRewind (Command tab completion is hidden for 1.8-1.21 versions)
\n– Spigot 1.8.8 with ViaVersion (Command tab completion is hidden for 1.8-1.21 versions)
\n– Paper 1.16.5
\n– Paper 1.21.4+
\n– Waterfall
\n– Velocity
\n– Flamecord
\n“`<\/p>\n
## FEATURES
\n\u2705 List of commands to block
\n\u2705 List of commands to allow
\n\u2705 Block tab completion of all commands
\n\u2705 Block colon commands
\n\u2705 Show only certain commands on tab completion (1.13+)
\n\u2705 Multiple actions when using blocked command
\n– Send message
\n– Send title message
\n– Play sound
\n– Give potion effect
\n– Execute console command<\/p>\n
\u2705 Certain actions to group of commands.
\n\u2705 Works with ViaVersion, ViaBackwards and ViaRewind.
\n\u2705 Works on Waterfall and Velocity (blocks bungee commands and hide tab completion)
\n\u2705 Works with 1.8+<\/p>\n
## HOW TO START
\n### SPIGOT\/PAPER SERVERS:
\nDownload the plugin and place it on your plugins folder. The plugin will only block spigot commands.<\/p>\n
### WATERFALL AND VELOCITY SERVERS:
\nDownload the plugin and place it on your plugins folder. The plugin will only block proxy commands.<\/p>\n
> You can use the plugin in both the proxy and your game servers.<\/p>\n
<\/p>\n
### CONFIG.YML<\/p>\n “`yaml # A list of commands to show on tab completion. The command must # You can add the “extends” option to inherit commands from another commands: # Actions to be executed when a user tries to use a blocked command. # Whether the plugin should send notifications on join to OP # Option only in backend server # Option only in backend server. # If you set this option to true, the list below will serve as a whitelist instead, # List of commands to block. # Block all commands that contain “:”. # Here you can define group of commands that will execute certain actions. <\/p>\n ### ACTIONS Sends a message to the player.<\/p>\n “`yaml Executes a command from the console.<\/p>\n “`yaml Plays a sound to the player. Use this format: “playsound: sound;volume;pitch”. “`yaml Sends a title and subtitle message to the player. Use this format: “title: fadeIn;stay;fadeOut;title;subtitle” “`yaml Gives a potion effect to the player. Use this format: “give_potion_effect: effect;duration_in_ticks;level” “`yaml <\/p>\n ### IMPORTANT INFORMATION <\/p>\n ### API “`java \/\/Detected command from the config \/\/The complete command used by the player } <\/p>\n ## COMMANDS AND PERMISSION ### PERMISSIONS: Prevent the use of unwanted commands and hide them from tab completion (the infamous \/Spoiler<\/summary>\n
\n# Here you can create different groups to show only certain commands
\n# in tab completion. You must give the easycommandblocker.tab.
\n# permission to players for using this option.
\n# The default group will apply to ALL users that don’t have a group permission set.
\n# Don’t remove the default group.
\ntab:
\n # Name of the group.
\n default:
\n # The priority works to define which group a player must use first if they
\n # have more than one group permission. A higher priority means the
\n # group will be selected first.
\n priority: 0<\/p>\n
\n # include the “\/”.
\n commands: []
\n vip:
\n priority: 1<\/p>\n
\n # group. Doing so allows you to not repeat commands.
\n extends: default<\/p>\n
\n – “\/home”<\/p>\n
\n# See the next section to understand how to use actions.
\nblocked_command_default_actions:
\n – ‘message: &8[&b&lECB&8] &cYou don”t have permissions to use that command.’
\n – ‘playsound: BLOCK_NOTE_BLOCK_PLING;10;0.1’
\n – ‘title: 20;40;20;&cWhat are you doing?;&7Don”t use that command!’<\/p>\n
\n# players if an update is found
\nupdate_notify: true<\/p>\n
\n# Set it to true if you are using ECB in both the proxy and the backend.
\nis_network: false<\/p>\n
\n# Set it to true if you are using a 1.12- server or want to add compatibility
\n# with 1.12- versions.
\n# Requires ProtocolLib.
\n# For this option to apply you must restart your server.
\nlegacy_support: false<\/p>\n
\n# meaning the listed commands will be allowed and all others will be blocked.
\nuse_commands_as_whitelist: false<\/p>\n
\ncommands:
\n – “\/?”
\n – “\/bukkit:?”
\n – “\/bukkit:ver”
\n – “\/bukkit:version”
\n – “\/bukkit:pl”
\n – “\/bukkit:plugins”
\n – “\/bukkit:help”
\n – “\/bukkit:about”
\n – “\/ver”
\n – “\/version”
\n – “\/plugins”
\n – “\/pl”
\n – “\/minecraft:me”
\n – “\/about”
\n – “\/icanhasbukkit”<\/p>\n
\nblock_colon_commands: false<\/p>\n
\n# The example1 section defines that commands like \/ver or \/version will kick
\n# the player from the server, instead of using the default actions. You MUST use
\n# the same commands defined in the previous list.
\n# If you don’t want custom command actions, you can delete this whole section.
\ncustom_commands_actions:
\n example1:
\n commands:
\n – “\/ver”
\n – “\/version”
\n – “\/about”
\n actions:
\n – “console_command: kick %player% You can’t see the version of the server!”
\n“`<\/p>\n<\/details>\n
\nYou can use these actions on the `blocked_command_default_actions` option. Waterfall and Velocity servers support all actions as well!<\/p>\nMessage<\/summary>\n
\nmessage: &8[&b&lECB&8] &cYou don’t have permissions to use that command.
\n“`<\/p>\n<\/details>\nConsole Command<\/summary>\n
\nconsole_command: kick %player%
\n“`<\/p>\n<\/details>\nPlay Sound<\/summary>\n
\nYou can find a list of sounds here:
\nCLICK<\/p>\n
\nplaysound: BLOCK_NOTE_BLOCK_PLING;10;0.1
\n“`<\/p>\n<\/details>\nTitle<\/summary>\n
\nfadeIn, stay and fadeOut must be in ticks, 20ticks = 1second
\nIf you want just a title, or just subtitle write “none”<\/p>\n
\ntitle: 20;40;20;&6This is a title;none
\ntitle: 20;40;20;&cWhat are you doing?;&7Don’t use that command!
\n“`<\/p>\n<\/details>\nGive Potion Effect<\/summary>\n
\nYou can find a list of potion effects here:
\nhttps:\/\/hub.spigotmc.org\/javadocs\/spigot\/org\/bukkit\/potion\/PotionEffectType.html<\/p>\n
\ngive_potion_effect: BLINDNESS;180;1
\n“`<\/p>\n<\/details>\n
\n– On the tab option you can only display commands that are registered and players have the correct permissions to use. This is a Minecraft limitation, it’s not possible to add custom commands to that list.
\n– Remember to \/deop yourself first when testing the plugin since OP players will bypass all options.
\n– The plugin doesn’t work on BungeeCord, only on Waterfall and Velocity.<\/p>\n
\nThe plugin has a small API that includes an Event:<\/p>\nSpoiler<\/summary>\n
\n@EventHandler
\npublic void onBlockedCommand(CommandBlockedEvent event){
\n Player player = event.getPlayer();<\/p>\n
\n String command = event.getCommand();<\/p>\n
\n String fullCommand = event.getFullCommand();<\/p>\n
\n“`<\/p>\n<\/details>\n
\n### COMMANDS
\n(alias: \/ecb)
\n– **\/easycommandblocker reload** (Reloads the config)<\/p>\n
\n– **easycommandblocker.admin** (Allows the access to \/ecb reload)
\n– **easycommandblocker.tab.
\n– **easycommandblocker.bypass.tab** (Allows to completely bypass tab completion filters)
\n– **easycommandblocker.bypass.commands** (Allows to completely bypass blocked commands)<\/p>\n","protected":false},"excerpt":{"rendered":"