Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/timbru31/passwordprotect
🔐 PasswordProtect plugin for CraftBukkit/Spigot
https://github.com/timbru31/passwordprotect
bukkit bukkit-plugin craftbukkit java minecraft password spigot spigot-plugin spigotmc
Last synced: 3 months ago
JSON representation
🔐 PasswordProtect plugin for CraftBukkit/Spigot
- Host: GitHub
- URL: https://github.com/timbru31/passwordprotect
- Owner: timbru31
- License: mit
- Created: 2011-12-01T22:08:04.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2024-09-27T04:10:41.000Z (3 months ago)
- Last Synced: 2024-09-28T12:02:17.056Z (3 months ago)
- Topics: bukkit, bukkit-plugin, craftbukkit, java, minecraft, password, spigot, spigot-plugin, spigotmc
- Language: Java
- Homepage: https://dev.bukkit.org/projects/passwordprotect
- Size: 347 KB
- Stars: 12
- Watchers: 4
- Forks: 6
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# PasswordProtect
[](https://ci.dustplanet.de/job/PasswordProtect/)
[](https://github.com/timbru31/PasswordProtect/actions?query=workflow%3A%22Build+the+plugin%22)
[](https://dev.bukkit.org/projects/passwordprotect)
[](https://www.spigotmc.org/resources/passwordprotect.80128)
[](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_
- bStats for usage statistics
- Auto Updater (connecting to https://dev.bukkit.org for updating checking)
## Standard config
```yaml
# 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
- DisabledHamster/brianewing for the original plugin!
- muHum for [mPasswordProtector](https://github.com/muHum/mPasswordProtector)
## 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
[](https://bstats.org/plugin/bukkit/PasswordProtect/2038)
## 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
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=T9TEV7Q88B9M2)
1NnrRgdy7CfiYN63vKHiypSi3MSctCP55C
---
Built by (c) Tim Brust and contributors. Released under the MIT license.