---

⚡ What is TAuth?

Authentication plugins shouldn't feel outdated.

TAuth is a modern authentication engine designed from the ground up to protect player accounts while keeping the login experience fast, seamless, and lightweight.

Built with modern Java practices, asynchronous database operations, UUID-based account handling, BCrypt password hashing, and configurable security controls, TAuth gives server owners a powerful authentication layer without unnecessary complexity.

Whether you're protecting a small SMP or operating a large public network, TAuth is built to stay out of the player's way while keeping their account protected.

---

💎 Signature Features

🔑 1. Secure Authentication System

A complete authentication flow designed around account security and reliability.

• Register & Login — Simple and intuitive account authentication.
• BCrypt Password Hashing — Passwords are securely hashed instead of being stored in plain text.
• UUID-Based Accounts — Player identities are tied to their Minecraft UUID for reliable account tracking.
• Secure Password Validation — Robust credential validation during authentication.
• Login Timeout — Automatically handle players who remain unauthenticated for too long.
• Configurable Cooldowns — Fine-tune authentication-related actions to match your server's security requirements.

---

🤖 2. Trusted IP Auto Login

TAuth makes returning players feel almost completely frictionless.

After a successful manual login, TAuth can associate the player's account with their trusted IP.

Returning with:

Same Username + Trusted IP

✅ Automatically authenticated.

Returning from:

New / Untrusted IP

🔒 Manual authentication required.

This creates a seamless experience for regular players while still requiring authentication whenever their network identity changes.

---

🛡️ 3. Built-In Brute-Force Protection

Player accounts shouldn't be vulnerable to endless password attempts.

TAuth includes configurable protection against repeated authentication attempts, helping server owners defend against:

• Automated password guessing
• Repeated failed login attempts
• Credential abuse
• Rapid authentication spam

Security controls remain configurable so you can balance protection and player convenience.

---

🚀 4. Performance-First Architecture

Authentication should never become a source of server lag.

TAuth is designed around asynchronous operations and clean separation of responsibilities, keeping database-related work away from the server's critical main-thread path whenever possible.

⚡ Performance Principles

• Asynchronous Database Operations
• Efficient Account Lookups
• Non-Blocking Authentication Flow
• Lightweight Runtime Behaviour
• Minimal Unnecessary Processing

The result is an authentication layer designed to remain responsive even as your player count grows.

---

🧱 5. Modern Java Architecture

TAuth isn't built as a collection of tangled authentication commands.

The plugin follows a clean architecture designed around separation of responsibilities, maintainability, and future extensibility.

That means:

Cleaner internals.
More predictable behaviour.
Easier maintenance.
Room for future expansion.

Every subsystem is built with the goal of making TAuth reliable today and easier to evolve tomorrow.

---

⚙️ 6. Deep Configuration Control

Different servers have different security requirements.

TAuth puts important authentication behaviour under administrator control instead of forcing everyone into the same configuration.

Fine-tune aspects such as:

• Login timeout behaviour
• Authentication cooldowns
• Security restrictions
• Trusted IP behaviour
• Authentication messages
• Account protection settings

Build the authentication experience that fits your server, your community, and your security model.

---

🧠 7. Seamless Player Experience

Security doesn't have to mean friction.

TAuth is designed to minimize unnecessary interaction for returning players while keeping authentication strict when it matters.

For trusted returning players:

Join → Authenticate automatically → Play.

For new or untrusted connections:

Join → Authenticate manually → Access the server.

Simple for players.

Powerful for administrators.

---

🔐 8. Security Without the Bloat

TAuth focuses on the features that matter instead of overwhelming your server with unnecessary systems.

No bloated authentication flow.

No unnecessary complexity.

No outdated architecture.

Just a focused authentication engine built around:

Security. Performance. Reliability. Simplicity.

---

🔄 Authentication Flow

                 ┌─────────────────────┐
                 │      Player Joins   │
                 └──────────┬──────────┘
                            │
                            ▼
                 ┌─────────────────────┐
                 │   Account Exists?   │
                 └──────────┬──────────┘
                       ┌────┴────┐
                      NO        YES
                       │          │
                       ▼          ▼
               ┌────────────┐  ┌────────────────┐
               │  Register  │  │ Trusted IP?    │
               └─────┬──────┘  └───────┬────────┘
                     │             ┌────┴────┐
                     │            YES       NO
                     │             │          │
                     │             ▼          ▼
                     │      ┌────────────┐ ┌──────────┐
                     │      │ Auto Login │ │  Login   │
                     │      └─────┬──────┘ └────┬─────┘
                     │            │             │
                     └────────────┴─────────────┘
                                  │
                                  ▼
                         ┌─────────────────┐
                         │ Server Access   │
                         └─────────────────┘

---

🔒 Security Stack

Security Layer	Protection
🔐 Password Storage	BCrypt Hashing
🆔 Account Identity	UUID-Based
🛡️ Attack Protection	Brute-Force Protection
🌐 Trusted Sessions	Trusted IP Auto Login
⏱️ Session Control	Configurable Login Timeout
⏳ Rate Control	Configurable Cooldowns
✅ Credential Checks	Secure Password Validation

---

📋 Core Features

Feature	Included
🔑 Register & Login	✅
🔐 BCrypt Password Hashing	✅
🆔 UUID-Based Accounts	✅
🤖 Trusted IP Auto Login	✅
🛡️ Brute-Force Protection	✅
⏱️ Configurable Cooldowns	✅
⌛ Login Timeout	✅
⚡ Asynchronous Database Operations	✅
⚙️ Extensive Configuration	✅
🧱 Clean Java Architecture	✅
🚀 Performance-Focused Design	✅

---

⚙️ Designed for Server Owners

TAuth gives administrators control without turning authentication management into a complicated process.

Its configuration-first approach makes it possible to adapt the plugin to different server environments, security requirements, and player workflows.

From a private SMP to a large public network, TAuth is designed to scale with your infrastructure and evolve with your server.

---

🛠️ Installation

1. Download TAuth.jar.
2. Place the plugin inside your server's plugins/ directory.
3. Ensure your server is running a supported Paper/Spigot environment with the required Java version.
4. Start or restart your server.
5. Configure TAuth to match your authentication and security requirements.
6. You're ready to protect your players.

💡 Tip: Review the configuration carefully before opening your server to players so authentication behaviour matches your intended security model.

---

🎯 Built for Modern Minecraft

TAuth was created for server owners who expect more from their authentication system.

Fast enough for high-traffic environments.
Secure enough for serious servers.
Simple enough for everyday players.

---