Staff++
latest
latest
  • Staff++
  • General information
    • Quick start
    • Reload Configuration
    • Multi Server Setup
    • General Configuration
    • Other
      • Text parsing
      • Styling the GUIs
        • Gui structure
        • Selectors
      • Configuring command hooks
  • Permissions & Commands
    • Commands
    • Permissions
      • Legacy permissions
  • Features
    • Alerts
      • X-Ray
    • Alt account detection
    • Authentication
    • Banning
      • IP Banning
        • Messages
      • Fixed Ban Reason
      • Templates
    • Blacklist
    • Broadcasting
    • Chat module
    • Chest/Inventory Interaction
    • Command detection
    • Examine players
    • Freezing
      • Command hooks
      • Luckperms integration
      • Chat channels
    • Infractions
    • Investigate
      • Command hooks
    • Join messages
    • Player IPs
    • Kicking
    • Muting
      • Appealing
    • Protection
    • Player information
    • Player notes
    • Reporting
      • Command hooks
      • Messages
      • Finding reports
      • Report types & Reasons
      • Chat channels
    • Staff Chat
    • Staff Mode
      • Multiple modes
      • Staff Modules
      • Custom Staff Modules
        • State dependent modules
      • Command hooks
      • Luckperms integration
    • Staff Locations
    • Teleporting
    • Vanish
      • Luckperms integration
    • Warnings
      • Quick start
      • Severity levels
      • Thresholds
      • Actions (punishments)
      • Appealing
      • Warning workflow
  • Web Platform
    • Register Players
    • Setup Web Platform
    • Architecture
  • Integrations
    • Discord Integration
      • Staff Chat
      • Template Packs
      • Customize Discord Templates
    • Trello Integration
    • PAPI expansion
      • PAPI Examples
  • Migration guides
    • Staff+ migration guide
    • Migrating to >=V1.16.43
    • Upgrading Discord Integration to 1.16.51
  • Developers
    • API guide
Powered by GitBook
On this page
  • Setup
  • Configuration
  • Overwriting the default template

Was this helpful?

  1. Features
  2. Banning

Templates

PreviousFixed Ban ReasonNextBlacklist

Last updated 3 years ago

Was this helpful?

You can use txt files to describe the logout message a player will see when he gets banned. By default this entire functionality is disabled. To enable templates do the following.

Setup

Inside the Staff++ plugin directory create a bans directory if it does not already exists. Inside this bans directory you can create the template files. A template file is a simple text file containing the message that will displayed to the user on ban. Example file:

I named the above file default.txt. The file name without extension will be used as template name.

This will result in the following:

My example is not that pretty but it illustrates the usage.

placeholders

Inside the template the following placeholders can be used

placeholder

description

%target%

The banned player's username

%issuer%

The staff members username

%reason%

The ban reason

%duration%

Human readable duration. Only available with tempbans

Configuration

ban-module:
  enabled: true
  permban-template: default
  tempban-template: default

Inside the config.yml file you can fill in a default template for permanent and temporary ban. Or leave it empty to fall back on the message defined in the lang file.

Overwriting the default template

If staff members have the permission: staff.bans.ban-template-overwrite they can use an extra parameter "-template=" when banning a player. Example: /ban thisplayer -template=other I ban you!

This will overwrite the default configured template and try to find and use a template with the given name. If the template does not exist an error will be shown.

130B
default.txt
bans/default.txt