✨ Overview

KeskinNameGuard automatically locks base usernames on a first-come, first-served basis across Java Edition and Bedrock Edition (via Floodgate/Geyser). It eliminates cross-platform impersonation risks seamlessly and securely without performance overhead.

💡 How It Works:
If keskinreal joins on Java and _keskinreal tries to join from Bedrock, both names normalize to keskinreal. The platform that joins first claims the lock — subsequent logins from the opposing platform are instantly rejected.

🌟 Key Highlights

• 🔒 First-Come, First-Served Locking: Automatic platform lock for base usernames.
• 🔌 Official Floodgate API: Reliable Bedrock detection with configurable prefix fallback.
• 🔤 Unicode NFKC Normalization: Case-insensitive and clean normalization across character sets.
• 💾 Atomic Lock Database: Persistent storage with built-in statistics.
• 📂 Usercache Import: One-click import tool for existing usercache.json Java players.
• 🌐 17 Bundled Languages: Automatic client-locale matching.
• 🛡️ Zero Telemetry: Offline license for keskinreal, 100% internet-free, zero NMS dependencies.

⚡ Commands & Permissions

📜 Commands

🔑 Permissions

• keskinnameguard.admin — Access all administration commands (Default: OP)
• keskinnameguard.bypass — Bypass cross-platform login conflicts (Default: false)

🌐 Supported Languages (17)

English • Turkish • Spanish • German • French • Portuguese • Dutch • Bulgarian • Hindi • Simplified Chinese • Traditional Chinese • Russian • Italian • Japanese • Korean • Polish • Ukrainian

📦 Requirements & Installation

Prerequisites

• Server: Purpur or Paper 26.2
• Runtime: Java 25
• Dependencies: Floodgate 2.x (and Geyser setup)

Quick Installation

1. Stop your server.
2. Place KeskinNameGuard.jar into your plugins/ folder.
3. Start the server and check Floodgate status via /kng stats (should show API).
4. Run /kng import usercache once to protect existing Java players.