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!

Make sure to take a look at the always up to date ToDo!

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! :)
Address: 1NnrRgdy7CfiYN63vKHiypSi3MSctCP55C


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

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of xGh0sTkiLLeRx xGh0sTkiLLeRx Mar 04, 2016 at 21:00 UTC - 0 likes

    A new update is awaiting approval with support for 1.9 and the option to disable the jail area.

    Server | Twitter | Github

    Donations are very appreciated!

  • Avatar of madtomic madtomic Dec 18, 2014 at 18:24 UTC - 0 likes

    Great plugin. Thank you for your hard work. We'll have to wait for Sponge first.

  • Avatar of jyrgas jyrgas Oct 23, 2014 at 04:29 UTC - 0 likes

    Works fine, BUT, can you please fix so we can select a spawn point after they have write the correct password, on my server i need the players to spawn at one special place, now the are spawning random in the spawn area

  • Avatar of xGh0sTkiLLeRx xGh0sTkiLLeRx Sep 15, 2014 at 14:16 UTC - 0 likes

    Is there anyone who would like to see this plugin ported to Sponge?

  • Avatar of xGh0sTkiLLeRx xGh0sTkiLLeRx Sep 07, 2014 at 18:37 UTC - 0 likes

    @PapiDimmi: Go

    No, after 1 week or something like that 1.2 was finally approved ;)
    I'll edit my post.

  • Avatar of PapiDimmi PapiDimmi Sep 07, 2014 at 16:56 UTC - 0 likes

    @xGh0sTkiLLeRx: Go

    Is the update still waiting approval 1 and a half month, or are you just playing with us?


  • Avatar of xGh0sTkiLLeRx xGh0sTkiLLeRx Aug 11, 2014 at 16:43 UTC - 0 likes

    @madtomic: Go

    Try it - I can't remember if this build supports UUIDs.

  • Avatar of madtomic madtomic Aug 10, 2014 at 14:45 UTC - 0 likes

    Can I use this with cb1.7.2-r0.3?

  • Avatar of xGh0sTkiLLeRx xGh0sTkiLLeRx Aug 04, 2014 at 18:45 UTC - 0 likes

    Update awaits approval
    approved ;)

    Last edited Sep 07, 2014 by xGh0sTkiLLeRx
  • Avatar of xGh0sTkiLLeRx xGh0sTkiLLeRx Jul 28, 2014 at 22:24 UTC - 1 like

    A little bird whispered that an update is coming.

    • UUID support
    • Updated to BanList
    • CleanUp
    • new README
    • Updated to CB 1.7.10