Sentinel is a lightweight, powerful and secure authentication plugin for 1.20+ Minecraft servers. Built with simplicity and safety in mind, it ensures that players register and log in before interacting with the world, protecting your server from unauthorized access and potential exploits.

!Banner

Features

• 🔑 /login <password> - Log in to your registered account

  • Permission: sentinel.login
  • Aliases: /l <password>

• 🆕 /register <password> - Create a new account

  • Permission: sentinel.register
  • Aliases: /r <password>

• 🔄 /changepassword <old> <new> - Change your password securely

  • Permission: sentinel.changepassword

• 🗑️ /unregister <player> - Delete a player account (OP only as default)

  • Permission: sentinel.unregister

• 🔧 /sentinel reloadlang - Reload server's language from config (OP only as default)

  • Permission: sentinel.use

Functionalities

• 🚷 Restricted Mode: Players who are not logged in are placed in a restricted state.

• 🕒 Session Support: Customizable auto-login session window (15 minutes by default)

• 🧱 SQLite Storage: All data stored locally in Sentinel/auth.db

• 🛡️ Secure Logging: Password-related commands are filtered from logs to avoid exposure

• 🧩 Multi-Version Support: Fully compatible with Minecraft 1.20+, including 1.21.x

• 🌐 Locale-Based Language: Each player's language is selected automatically based on their client locale. Available translations include:

  • en-US, en-GB, es-ES, pt-BR, pt-PT, de-DE, ru-RU
  • Additional locales can be added by placing .yml translation files in the lang/ folder.

• 🆔 UUID Modes: Supports flexible player UUID modes via config:

  • adapt - Automatically chooses based on the server’s online mode
  • online - Use Mojang authenticated UUIDs (accounts tied to Mojang accounts).
  • offline - Generate UUIDs based on player names (accounts tied to usernames).

• 🖥️ Server Language Config: Defines the server's default language (used mainly for console logs)

📢 Planned / Coming Soon

• Currently no planned features, but open to suggestions and pull requests!

🤝 Need Help or Want to Contribute?

Found a bug? Have a suggestion? Want to help improve it? You can:

• Open issues for bugs, ideas, or feature requests.
• Submit pull requests to improve the code, docs, or features.
• Or start a discussion in the GitHub repository.

Thank you for using Sentinel!