Passwords
Secure your server with Passords!
Passwords an easy to use and simple plugin to secure your minecraft server from strangers. If you dont want to use a whitlis you can simply give your friends the password and thats it.

Features
-
Custom Passwords for Each Player
Allow players to create unique passwords, ensuring personalized and secure access to their accounts. -
Admin Password Options
Admins can set a master password for full permissions and Op status. -
Seamless Integration
Works effortlessly with any Minecraft server without requiring complex setup.
Sample Config.yml
Below is an example configuration file to get you started:
Click to view config.yml
version: "2.6.3"
debug: false
# Password dose not supports PlaceholderAPI in messages.
# Supported placeholders are: &player& -> Player Name
# Placeholders are only supported in messages
settings:
# check-type: server : One password for the entire server.
# check-type: player : A unique password for each player. (Works only on the first join. To reset, delete player data or use the /setpassword command)
# check-type: none : No password check.
# check-type: pattern : The player must enter a pattern like "o x o"
# "x x x"
# "x x x"
check-type: server
# GUI Name
gui-name: Enter Passwords
# Set password name
set-password-name: Set Password
# Message that will be displayed as the kick reason.
fail-message: The password is incorrect!
# When the UI is closed without a password
close-ui-message: You need to enter a password!
# Enable welcome message.
welcome-message-enabled: true
# Welcome message after login.
welcome-message: Welcome to ExampleServer
# Welcome message second line (Only for title)
welcome-message-second: Passwords
# Display type for the welcome message: message; actionbar; title
welcome-message-display-type: message
# Enable login gamemode.
login-gamemode-enabled: true
# Gamemode every player will have upon login: survival, creative, adventure, spectator
login-gamemode: survival
# Player password length (for the check-type: player)
player-password-length: 4
# Blocked passwords ( only for the check-type: player & server )
blocked-passwords:
- 1111
# Saves the player inventory on logout and restores it on login. ( !!!!! Waring: When the data folder or the player data in the passwords folder is deleted, the player inventory will be lost !!!!! )
save-player-inventory: false
# Saves the player inventory automatically
enable-auto-save: true
# Saves the player inventory every 5 minutes (if save-player-inventory is true)
save-player-inventory-intervall: 10 # in minutes ( min 3 )
# Invulnerable on login (note: this will prevent fall damage when exploited)
invulnerable-on-login: true
server:
# Server password (the password can be any length | for the check-type: server)
password: 1234
# Staff password (the password can be any length | for the check-type: server)
staff-password: 8181
# Staff permissions (will be given to the player after login)
staff-permissions:
- passwords.*
# Remove staff permissions on logout
remove-staff-permissions-on-logout: true
# Password pattern (for the check-type: pattern)
pattern:
- oxo
- xxx
- xxx
# Currently Under development not working !!!!
# Not working on Folia
skript:
# Executest the event for Example
behavior: "Example"
Commands
Click to view commands
/setpassword <Password>→ Set your password./setplayerpassword <Player> <Password>→ Ser a Player's password./logout <Player>→ Logout player./preload-> Reload Plugin Config
For Developers: Maven/Gradle Setup
Click to view Maven/Gradle setup
Maven:
<dependency>
<groupId>cho.info</groupId>
<artifactId>passwords</artifactId>
<version>(Plugin version)</version>
</dependency>
<repositories>
<repository>
<id>local-repo</id>
<url>file:/path/to/my-local-repo</url>
</repository>
</repositories>
Gradle:
implementation files("$projectDir/lib/passwords-(Plugin version).jar")
All Versions
+ Add Version- Support for versions 26.1 and upwards
- reload command ( /preload )
- Adde folia Support
Fixes:
- Fixed a bug where players are able to login without a password
- Fixed a bug where config is not reloading poorly
- Fixed DataManager being new instance every call
News:
- Dropped support for DiscordSRV
Improvements:
- Improved code structure and bugs [@Ziko225](https://github.com/Ziko225)
Compatibility:
- Minecraft: 1.21.5 – 1.21.11
- Requires Java 21 or higher
Links:
- GitHub Repository: https://github.com/HamburgBigJ/Passwords
- Modrinth Page: https://modrinth.com/plugin/passwords
### ✅ **News**
- Dropped support for **Spigot** and its forks
- Dropped support for **PlaceholderAPI**
### ⚙️ **Improvements**
- Improved code structure**
savePlayerInventory method### 📄 **Compatibility**
- ✅ **Minecraft:** 1.21.5 – 1.21.10
- 🔧 **Requires:** Java 21 or higher
### 🔗 **Links**
[GitHub Repository](https://github.com/HamburgBigJ/Passwords)
[Modrinth Page](https://modrinth.com/plugin/passwords)
> 🔐 A powerful password system for Minecraft servers – customizable, GUI-based, and now even more flexible!
### ✅ **New Features**
- ➕ PlaceholderAPI Integration**
none and pattern, enabling advanced password verification logic.- 🗃️ Inventory Saving System**
- 🛡️ Invulnerable Mode Option**
- 🔤 New Command Argument:
PasswordPlayerArgument**
/setplayerpassword, providing improved auto-completion and error checking.### ⚙️ **Improvements**
- Config Structure Updated**
- Improved Debug Logging**
CustomGuiHandler to simplify issue tracking.- Password Length Enforcement**
/setplayerpassword now properly respects the configured maximum password length from the config.### 🐞 **Bug Fixes**
- 🛠 Fixed
null inventoryerror inCustomGuiHandlerthat could crash the GUI. - 🛠 Resolved issues with login not processing correctly under specific conditions.
- 🛠 Corrected broken license display in the GitHub
README.md. - 🛠 Fixed compatibility bug with newer PlaceholderAPI versions.
### 📄 Compatibility
- ✅ **Minecraft**: 1.20 – 1.21.x
- ✅ **Dependencies**: PlaceholderAPI
- 🔧 Requires Java 17 or higher
### 🔗 Links
- 🔗 [[GitHub Repo](https://github.com/HamburgBigJ/Passwords)](https://github.com/HamburgBigJ/Passwords)
- 📦 [[SpigotMC Resource](https://www.spigotmc.org/resources/passwords-custom-password-✅-1-21-1-21.120498/)]
- 📦 [[Modrinth](https://modrinth.com/plugin/passwords)]
Release Date: 2025-05-23
Author: [@HamburgBigJ](https://github.com/HamburgBigJ)
✨ New Features
Added a GitHub issue template for user questions, guiding contributors and specifying unsupported topics.
Introduced static access to plugin components (PasswordsApi) including plugin version and config version.
New config setting version: "2.5" added to maintain compatibility checks.
🛠 Improvements
Refactored Discord Hook Logic:
Improved login event handling for DiscordSRV.
Simplified and streamlined the check if a player is linked.
Code cleanup across multiple files for better readability and maintainability.
Refactored GUI close logic for PasswordPlayerMode and PasswordServerMode to correctly kick non-logged-in players only.
Converted sendTitel() to sendTitle() to correct method naming in Messages.
🐛 Bug Fixes
Fixed issues where player state wasn’t correctly validated on GUI close.
Corrected conditional logic in Discord login flow to prevent unintended behavior.
🔧 Technical Changes
Changed PasswordsApi class structure to use static references rather than instance-bound.
Updated plugin.yml to API version 1.21.5 and corrected plugin version to '1.5' (likely a typo, might need to align with '2.5').
Version bump in build.gradle and config.yml to match release version.
📝 Configuration Updates
Adjusted several inline comments in config.yml for clarity and professionalism.
Corrected wording and formatting in welcome messages, login modes, and Discord login settings.
### ✨ Added
- Staffmode**: New moderation feature allowing staff to access special functionality when enabled.
- Blocked Passwords**: Introduced support for defining disallowed passwords for improved security.
### 🛠️ Fixed
- Inventory Interaction Bug**: Resolved an issue where players could improperly interact with inventories during password input.
🔗 [View on GitHub](https://github.com/HamburgBigJ/Passwords/tree/2.4)
🔐 Passwords Plugin – Update for Minecraft 1.21.5 🎉
Version: v2.3
Tested on: PaperMC 1.21.5
💡 What’s New?
This update brings full support for Minecraft 1.21.5 along with a massive refactor of the codebase. It’s cleaner, faster, and easier to maintain—setting the stage for future updates and improvements.
✅ Key Changes
• ✅ Minecraft 1.21.5 Support
All internal systems have been updated to ensure compatibility with the latest version.
• 🧹 Major Code Cleanup
Over 1,500 lines of outdated or redundant code removed—expect better performance and fewer bugs.
• 🎛 Improved Command System
Player and server commands have been streamlined for smoother interaction.
• 🧍 Player Management Overhaul
Passwords are now handled more efficiently with improved tracking and validation.
• 🖼️ GUI System Refactored
More responsive and customizable GUI for password entry and interactions.
• 🤖 Discord Integration Improved
Better handling of Discord events and cleaner listener logic.
📁 Updating Instructions
1. Backup your current data and config!
2. Replace your existing plugin JAR with the new version.
3. Restart your server.
4. Check config files for any new options.
📣 Need Help?
Feel free to report bugs or ask questions on the GitHub Issues page.
✨ Thanks for using Passwords! More features and quality-of-life updates are coming soon.
— HamburgBigJ
- Overview:**
- Key Changes:**
- Command Fixes:**
- Resolved issues with existing commands to improve reliability.
- Introduced the
/preloadcommand, allowing administrators to reload the plugin without restarting the server. - Added the
/setpassword <Player> <Password>command, enabling administrators to manually assign passwords to players.
These enhancements aim to streamline server management and enhance user experience. For more details, refer to the [commit on GitHub](https://github.com/HamburgBigJ/Passwords/commit/24e794975480d967be125d566925aecfb77b7fb6).
- Changelog for Passwords Plugin Rework**
- Date:** March 16, 2025
- Overview:**
- Key Changes:**
1. **Codebase Overhaul:**
- Refactored the entire codebase to enhance readability, maintainability, and performance.
- Reorganized project structure, including updates to build scripts and workflows.
2. **New Features:**
- Introduced a customizable graphical user interface (GUI) for password management.
- Added support for Discord integration to improve user experience.
- Implemented an API to facilitate external integrations and customizations.
3. **Configuration Enhancements:**
- Updated configuration files to support new features and improve flexibility.
- Enhanced error messaging and validation for better user feedback.
4. **Bug Fixes:**
- Resolved issues related to configuration loading and password validation.
- Fixed various bugs to improve overall stability and performance.
Discord Integration:
Enhanced integration with Discord for a smoother user experience.
General Fixes
Bug fixes and optimizations for a more stable and faster application.
UI improvements for a more intuitive user experience
API Examples:
Explore example implementations of the Passwords plugin on GitHub:
[https://github.com/HamburgBigJ/PasswordsExample](https://github.com/HamburgBigJ/PasswordsExample)
Configuration Updater: Automatically updates configuration files to align with new changes or versions.
General Bug Fixes: Improved stability and fixed various bugs.