This plugin automatically applies bans based on the /r/ultrahardcore Universal Ban-List. Designed to be simple and easy to use whilst providing a wealth of features and configuration options, as well as security and efficiency. Works out-of-the-box on first install. The default settings should be good for the majority of users.


  • Simple easy-to-use commands
  • Works out-of-the-box, configuration is optional
  • Highly efficient and effective
  • Automatically downloads and applies the /r/ultrahardcore Universal Ban-List on server startup
  • Commands and configuration to set up exemptions to the ban-list
  • Configurable regular updates of the ban-list
  • By default, reads the ban-list directly from the /r/UHC Ban List Google Spreadsheet
  • Configurable ban-list URL for switching to an alternative provider
  • Configurable security settings to prevent DoS attacks from the connection of the ban-list server
  • Manually force a UBL update using a command
  • Manually reload configuration settings using a command without needing to restart
  • Displays UBL information to banned players on join attempt
  • Compatible with server bans and ban plugins - Anyone you ban manually will stay banned

Commands and Permissions

Command Permission Description
/ubl exempt [player] autoubl.commands.exemption (default op) Adds a player to the exempt list so that they can join the server even if they are on the UBL
/ubl unexempt [player] autoubl.commands.exemption (default op) Removes a player to the exempt list so that they cannot join the server if they are on the UBL
/ubl update autoubl.commands.update (default op) Update the banlist from the banlist-url immediately
/ubl reload autoubl.commands.reload (default op) Reload AutoUBL settings from the config.yml and update the banlist

Detailed command help is available in-game by typing /ubl. Typing any command without its parameters (if it has any), will display detailed help for that command


The config.yml can be located in your plugins folder under AutoUBL after first run. It should be edited using a simple text editor only and is in YAML format. If you are unsure how to do this, please read your CraftBukkit documentation, it is exactly the same as modifying the bukkit.yml.

  • banlist-url: The URL to check for the banlist
  • max-bandwidth: The maximum bandwidth to allocate to loading the banlist in kB/sec (faster values load the banlist quicker, lower values reduce the impact of denial of service attacks from the banlist server)
  • timeout: The time in seconds before the connection to the ban-list server times out (longer time deals with larger ban-lists better, shorter time reduces the duration of denial of service attacks from the ban-list server
  • retries: How many times to attempt to reconnect to the server if it fails to connect before falling back on the local UBL backup
  • auto-check-interval: How often (in minutes) to check the UBL and update it (0 for startup only)
  • exempt: a list of players exempt from the UBL on this server

You can reload changes to the config.yml while the server is running using: /ubl reload

Security Considerations

If you use a custom ban-list URL, ensure that the server you are connected to is a trusted source. Although there are security measures against attacks originating from the connection to the ban-list server, they will still be able to apply and lift bans as they choose.


Sources are available on GitHub:


  • None yet


  • None reported yet


If you'd like to contribute towards the continued development, support and maintenance of this project, please consider joining me on Patreon, and making a one-time or recurring pledge.


This plugin uses Java 7

If you get the followed error on starting up the server with this plugin installed "Unsupported major.minor version 51.0". This means you are using an out of date version of Java. If you don't know how to upgrade, please contact your server hosting provider and ask them for help in upgrading to Java 7, or contact Oracle customer support. Mac OS X users require JDK 7 instead of JRE 7.

Support Channel

If you need help you can leave a comment below and I will get back to you as soon as I can. You can also join my IRC chatroom using the following link, but please read the tutorial first.

Please read the documentation before asking for support


  • To post a comment, please or register a new account.
Posts Quoted:
Clear All Quotes

About This Project



Recent Files