Installation

🚀 Installation & Getting Started

Welcome to the official SmartLogin installation guide. Follow these simple steps to install, configure, and launch the suite on your server.

---

📋 System Requirements

Component	Minimum Requirement	Recommended Specification
Server Software	Paper 1.21.x / Purpur 1.21.x	Paper 1.21.4 (Build 92+)
Java Runtime	Java 21 (Temurin / OpenJDK)	Eclipse Temurin JDK 21
Server RAM	2 GB free memory	4 GB+ for busy networks
Database Storage	SQLite (Embedded, zero dependencies)	SQLite (WAL Mode enabled) or MySQL 8.0 / MariaDB

🧩 Optional Integrations

• GeyserMC & Floodgate: Enables native Minecraft Bedrock player support (Mobile, Consoles, Windows 10/11) with tactile PinPad and verified auto-login.
• FastLogin: Seamless auto-login for genuine Java Premium Mojang accounts.
• ProtocolLib / PacketEvents: Enhanced packet handling and dynamic map rendering.
• PlaceholderAPI (PAPI): Auth and 2FA status placeholders for TAB, scoreboards, and chat formats.

---

📥 Installation Steps

1. Download the Plugin:
   Get the latest SmartLogin-1.0.0.jar from Modrinth or GitHub Releases.
2. Upload to Server:
   Place the SmartLogin-1.0.0.jar file into your server's /plugins/ directory.
3. Start the Server:
   Start your Minecraft server. SmartLogin will generate its modular configuration structure in plugins/SmartLogin/:

   plugins/SmartLogin/
   ├── config.yml          # Core config, HUD, immersion, streamer & lockdown
   ├── auth.yml            # Hashing algorithms, Bedrock & Premium auto-login
   ├── database.yml        # SQLite (WAL) & MySQL (HikariCP) storage
   ├── 2fa/
   │   ├── discord.yml     # Discord Bot, DMs & security webhooks
   │   ├── telegram.yml    # Telegram Bot & login OTP notifications
   │   ├── email.yml       # SMTP Server for verification & recovery
   │   └── totp.yml        # Google Authenticator & in-game QR maps
   └── lang/
       ├── en.yml          # English (Default)
       ├── es.yml          # Spanish
       ├── pt.yml          # Portuguese
       ├── fr.yml          # French
       ├── de.yml          # German
       ├── ru.yml          # Russian
       └── zh.yml          # Chinese
   

---

🧙 Interactive Setup Wizard

When the first player with Operator (OP) or smartlogin.admin permission joins a fresh installation, SmartLogin opens an interactive In-Game Setup Wizard GUI:

1. Default Language Selection: Choose the server's primary language with a single click.
2. Database Engine Choice: Select between embedded high-speed SQLite (WAL mode) or external MySQL (HikariCP).
3. Security Policy Tuning: Set minimum password length, IP account limits, and streamer protections.
4. Instant Completion: The wizard saves configurations and applies them immediately with zero reload downtime.

💡 Tip: You can re-run the wizard at any time using:
/smartlogin setup or reset it completely with /smartlogin resetsetup.

---

◀ Previous Page Home & Manifesto

🏠 Wiki Index Main Documentation

Next Page ▶ Configuration (YAML)