tab-complete-blocker.yml

Block tab completion list for a specific command.

With this module, you can block any commands that are shown to players when they try to view all your server commands, you can control these commands using a rich group system!

---

Restrict Shown Commands

This is the most important submodule inside the file. Here you can control the list of all commands shown to players when they type "/" and then press tab. In this way, you can protect your server commands from players that are trying to exploit them.

To enable this module, set "enabled" to true.

restrict-shown-commands:
  # If true, enables the command list restriction.
  enabled: false

Mode

Here you can modify the mode, you can choose "whitelist" or "blacklist".

Whitelist

If set to whitelist, only the listed commands are shown to each group.

Blacklist

If set to blacklist, members of the groups are not going to see the listed commands.

See all permission

Here, you can set a permission for players to be considered part of all the groups. Useful when you have a lot of groups.

# Here you can set a custom permission for any player
# that is part of EVERY group listed.
see-all-permission: "sentry.tab-complete.all"

Adding groups

Players can be part of multiple groups at once, players are members of groups when they meet the permission requirement.

Here is some examples of how you can create and modify groups.

Groups are composed of just two options, permission and commands.

# Here you can create and modify groups.
groups:
  default:
    permission: "" # If empty, every player will be part of this group.
    commands:
      - "home"
      - "sethome"
      - "spawn"

  vip:
    permission: "sentry.group.vip"
    commands:
      - "vip"
      - "vipchat"

Here is an example of the groups format:

groups:
  groupnamehere:
    permission: "" # A permission that players must have to be part of the group
    commands:
    - "command1"
    - "command2"
    - "command3"

---

Hide Subcommands Tab Completion

Even though this submodule has a long name, it is very simple and self-explanatory.

With this submodule you can list some commands from which you want to remove tab completions, for example, in vanilla Minecraft you can see the list of all server plugins using /about, this submodule hides all the results of tab completion in the listed commands.

hide-subcommands-tabcompletion:
  # Enabled by default
  enabled: true
  
  # Here you can list the commands you want to hide all the tab completion results
  # Sentry already adds and hides by default all the commands that are
  # exploitable and dangerous for your server.
  commands:
    - "ver"
    - "listanyothercommandhere"

---

Default file & values

Default file & values

#     _____            __
#    / ___/___  ____  / /________  __
#    \__ \/ _ \/ __ \/ __/ ___/ / / /
#   ___/ /  __/ / / / /_/ /  / /_/ /
#  /____/\___/_/ /_/\__/_/   \__, /
#                           /____/
#
# DOCUMENTATION: https://squareplugins.gitbook.io/sentry
# SUPPORT: https://discord.gg/7cFjDnSpEs - CHECK THE DOCUMENTATION BEFORE ASKING FOR HELP!
#
# LIKE THIS PLUGIN? CONSIDER DONATING! https://patreon.com/drawned

# Enable this module? true / false
module-enabled: true

# If true, players with the permission sentry.bypass.tab-complete-blocker will not be tab restricted by Sentry
permission-bypass: true

# Restrict Shown Commands
# Requires at least MC 1.13
# Here you can set up custom groups and permissions, so you can control which commands are shown to them when they press /
# Keep in mind that restricting shown commands is not blocking players from using it, check the module command-blocker if you need that feature.
restrict-shown-commands:
  # If true, enables the command list restriction.
  enabled: false

  # Here you can set a custom permission for any player that is part of EVERY group listed.
  see-all-permission: "sentry.tab-complete.all"

  # Changes the mode to whitelist or blacklist. If you set it to blacklist, it will remove these commands to the specified groups.
  # If you set it to whitelist, only the listed commands are shown to each group.
  mode: "whitelist" # whitelist or blacklist

  # Here you can create and modify groups.
  groups:
    default:
      permission: "" # If empty, every player will be part of this group.
      commands:
        - "home"
        - "sethome"
        - "spawn"

    vip:
      permission: "sentry.group.vip"
      commands:
        - "vip"
        - "vipchat"

    mod:
      permission: "sentry.group.mod"
      commands:
        - "ban"
        - "banip"
        - "help"
        - "about"

    mycustomgroup:
      permission: "sentry.group.mycustomgroup"
      commands:
        - "mycustomcommand"

    admin:
      permission: "sentry.group.admin"
      commands:
        - "staffchat"
        - "version"
        - "help"
        - "version"
        - "?"
        - "sentry"
        - "about"

# If true, will hide all the tab-completions results for the listed commands
# For example, in the command "/about", the server automatically tabcompletes it with all the Plugins listed on the server, Sentry blocks it.
hide-subcommands-tabcompletion:
  enabled: true
  commands:
    - "ver"
    - "version"
    - "about"
    - "help"
    - "?"