PasswordProtect - Protect your server with a password

Version v1.3.1




This CraftBukkit plugin aims to offer a simple server password which is the same for all users.


Without logging in the user is jailed in a pre defined cuboid and ported back once he leaves the jail area.
You can define jail areas for each world and configure which actions like block breaking, chatting or flying should be disabled.
There is an additional ability to allow certain commands or to auto-kick or auto-ban a user after X failed attempts.

This plugin is a rebirth of PasswordProtect
Additionally I migrated some features of mPasswordProtector into PasswordProtect (auto kick and ban).




  • Cancel different interaction events like
    • Pickup items
    • Drop items
    • Break blocks
    • Hit mobs or players
    • Chat
    • Triggering of mobs
    • Interaction with items
    • Using a portal
    • Drops on death
    • Flying
  • Auto kick and auto ban (even the IP) after configurable amount of tries
  • Blindness and slowness for the player if wanted
  • Jail area - the player is teleported back if he leaves the area - can be turned off with disableJailArea
  • Per world jail area!
  • Safe hashing of password, choose between SHA, SHA-256, SHA-512, MD5 & more
  • Custom commands are allowed to execute (like /rules)
  • Bypass command via permission
  • Broadcast a message on kick/ban
  • Teleport the player back to the previous location (location on logout)
  • Localization to edit the messages
  • Permissions & Commands for an easy administration

Third party features, all of them can be disabled
Please take a look at the detailed information about Metrics below!

  • Metrics for usage statistics




# For help please refer to
# Which hash should be used? Example: SHA-256 or SHA-512
hash: SHA-512
# Are ops forced, to enter the password, too?
opsRequirePassword: true
# Should the jail area be disabled?
disableJailArea: false
# Should the password be stored in clean (plain) text?
cleanPassword: false
password: ''
passwordClean: ''
# What events should be prevented?
  Movement: true
  Interaction: true
  InteractionMobs: true
  ItemPickup: true
  ItemDrop: true
  Portal: true
  BlockPlace: true
  BlockBreak: true
  # Players won't be triggered by mobs anymore
  Triggering: true
  Attacks: true
  Damage: true
  Chat: true
# After how many attempts should a player be kicked or banned
  kick: 3
  ban: 5
  banIP: true
# Broadcast messages when a player is kicked or banned?
  kick: true
  ban: true
# Make the players slow and add darkness effects?
darkness: true
slowness: true
# These commands are available, even without logging in
- help
- rules
- motd
# Teleport back to the location they left?
teleportBack: true
# Show the message that a password is required
loginMessage: true



Commands & Permissions

Only the bukkit permissions are supported! I highly recommend that you use a plugin for permissions like bPermissions
If the config value permission is set to false, all people can use the commands!
If no permission system is found, all commands are for OPs only! Of course the console can use the commands, too!

Node: passwordprotect.nopassword
Description: Bypass the login password

Node: passwordprotect.getpassword
Description: Allows you to get the password

/setpassword <password>
Node: passwordprotect.setpassword
Description: Allows you to set the password

/setjaillocation <radius>
Aliases: /setjail, /setjailarea, /setpasswordjail
Node: passwordprotect.setjailarea
Description: Allows you to set the jail area

/login <password>
Node: No permission node
Description: Used to login.

Of course you can use passwordprotect.*
But passwordprotect.nopassword is excluded!



Downloads/Source Code/Dev Builds

Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk. (Latest dev builds/bleeding edge builds) - - Dev builds from Jenkins (Source code hosted on GitHub) - - Source Code



Future Plans (a.k.a. ToDo):

  • Nothing - I'm open for suggestions!




Known Bugs

  • If the server is /reload -ed, all active players can play without the password. "Fixed" in 1.1




Version 1.3.1

Version 1.3

  • Ability to disable jail area (toggle disableJailArea to true)
  • Updated Metrics for 1.9 compliance
  • Compiled against Bukkit 1.9

Long changelog




@DisabledHamster for his original plugin! :)
@muHum for mPasswordProtector




Feel free to use this banner!! :)



Statistics (from MCStats)




I'm very happy about any donation.
Support me & buy me some beer, this makes me happy and keeps me interested in this plugin.
Donation chain: -> I receive some money -> Buy coffee -> Work longer -> Faster Updates -> Your benefit!

There is a button on top of this page (right to the different tabs)

I'm accepting bitcoins, too! :)




This plugin is released under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0) license!



Information about the data usage collection Metrics

Disabling Metrics
The file ../plugins/Plugin Metrics/config.yml contains an option to opt-out

The following data is read from the server in some way or another

  • File Contents of plugins/Plugin Metrics/config.yml (created if not existent)
  • Players currently online (not max player count)
  • Server version string (the same version string you see in /version)
  • Plugin version of the metrics-supported plugin
  • Mineshafter status - it does not properly propagate Metrics requests however it is a very simple check and does not read the filesystem

The following data is sent to and can be seen under

  • Metrics revision of the implementing class
  • Server's GUID
  • Players currently online (not max player count)
  • Server version string (the same version string you see in /version)
  • Plugin version of the metrics-supported plugin


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

About This Project



Recent Files