Skip to content

timbru31/PasswordProtect

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

PasswordProtect

Build Status Build the plugin

BukkitDev SpigotMC

License

Info

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

THIS IS NOT A PLUGIN FOR A USER SPECIFIC PASSWORD

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.

Features

  • 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
  • Jail area - the player is teleported back if he leaves the area - can be turned off with disableJailArea
  • Per world jail area!
  • Hashing (one way!) of password, choose between SHA, SHA-256, SHA-512, MD5 & more
  • Custom commands are allowed to execute (like /rules)
  • Teleport the player back to the previous location (location on logout)

Third party features, all of them can be disabled

Standard config

# For help please refer to https://dev.bukkit.org/projects/passwordprotect
# 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: ""
autoUpdater: true
# What events should be prevented?
prevent:
  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
  deathDrops: true
  flying: true
# After how many attempts should a player be kicked or banned
wrongAttempts:
  kick: 3
  ban: 5
  banIP: true
# Broadcast messages when a player is kicked or banned?
broadcast:
  kick: true
  ban: true
# Make the players slow and add darkness effects?
darkness: true
slowness: true
# These commands are available, even without logging in
allowedCommands:
  - help
  - rules
  - motd
# Teleport back to the location they left?
teleportBack: true
# Show the message that a password is required
loginMessage: true

Commands & Permissions

(Fallback to OPs, if no permissions system is found)

Please note that /setjaillocation has the following aliases

  • /setjail
  • /setjailarea
  • /setpasswordjail

General commands

Command Permission node Description
/login - allows you to login
/password passwordprotect.getpassword Gets the password if not stored encrypted
/setpassword passwordprotect.setpassword Sets the password
/setjailloctation passwordprotect.setjailarea Sets the jail location with the given radius

Special permissions

  • passwordprotect.* - Grants access to ALL other permissions (EXECPT: passwordprotect.nopassword)
  • passwordprotect.nopassword - Bypass the login password

Credits

Support

For support visit the dev.bukkit.org page: https://dev.bukkit.org/projects/passwordprotect

Pull Requests

Feel free to submit any PRs here. :) Please follow the Sun Coding Guidelines, thanks!

Usage statistics

Usage statistics

Data usage collection of bStats

Disabling bStats

The file ./plugins/bStats/config.yml contains an option to opt-out

The following data is read and sent to https://bstats.org and can be seen under https://bstats.org/plugin/bukkit/PasswordProtect

  • Your server's randomly generated UUID
  • The amount of players on your server
  • The online mode of your server
  • The bukkit version of your server
  • The java version of your system (e.g. Java 8)
  • The name of your OS (e.g. Windows)
  • The version of your OS
  • The architecture of your OS (e.g. amd64)
  • The system cores of your OS (e.g. 8)
  • bStats-supported plugins
  • Plugin version of bStats-supported plugins

Donation

PayPal

BitCoin
1NnrRgdy7CfiYN63vKHiypSi3MSctCP55C


Built by (c) Tim Brust and contributors. Released under the MIT license.