📋 FakeTabAiPlugin — Release Changelog v2.1.0

---

🚀 1. Major New Features & Capabilities

• 🧠 Smart Fallback Offline Chat Simulation Engine (SmartFallbackChatEngine):
  • Added an intelligent, local context-aware response engine that works out-of-the-box with zero API keys.
  • Intelligently simulates real conversations for greetings, Lifesteal/Hearts banter, PvP callouts, mining updates, trading, death reactions, and private messages when external AI providers are offline or rate-limited.
• ⚡ One-Click Bulk Auto-Generator (/faketab autogen <count> [theme]):
  • Allows server owners to generate up to 100 realistic fake players in a single command.
  • Includes curated theme presets: indian (Hinglish/Lifesteal names), pvp (Tryhard PvP usernames), and global (SMP usernames).
  • Automatically assigns random realistic pings (20–80ms), permissions groups, and skin identities.
• 🎨 Custom Skin Assignment & Mojang Fallback (/faketab setskin):
  • Added ability to assign any valid Minecraft skin to any fake player independently of their display name.
  • Added automatic secondary fallback to Mojang Official Session Server API if Ashcon is down or rate-limited.
• 🎛️ Redesigned Multi-Page Interactive Admin GUI (/faketab gui):
  • Added page navigation (supports >45 fake players with Next/Previous arrows).
  • Added Quick Action control buttons: [+] Auto-Generate 10, Connect All Online, Disconnect All Offline, System & AI Diagnostics, and Reload.

---

🛠️ 2. Critical Bug Fixes & Reliability

• Fixed GUI Click Routing Failure: Resolved an issue where clicking players in the GUI invoked an unmapped /faketab toggle command.
• Fixed Tab List Steve/Alex Skin Glitch: Fixed a visual packet timing bug where asynchronously fetched skins were never pushed to online viewers' tab lists.
• Fixed Server List Ping Count Spoofing: Corrected ServerPingListener to only add currently online fake players rather than all stored profiles (including offline ones).
• Removed Immersion-Breaking [FAKE] Tags: Stripped [FAKE] suffixes from the leaderboard (/lb) command bridge output to preserve server realism.
• Fixed Soft-Dependency Crashes: Removed hard dependency on LuckPerms; the plugin now starts cleanly on servers using Vault or vanilla permissions without shutting down.

---

⚡ 3. Performance & Data Persistence

• 💾 Persistent SQLite Skin Caching (player_skins table):
  • Texture values and signatures are now saved to SQLite database, eliminating redundant web requests across server restarts and avoiding 429 Too Many Requests API throttling.
• 🔒 Profile Metadata Storage:
  • Added YAML serialization for customSkin and customMood properties in individual player profile files under plugins/FakeTabAiPlugin/players/.

---

🎮 4. Expanded Admin Command Suite

Command	Description
/faketab gui	Opens the interactive visual manager.
/faketab autogen <count> [theme]	Instantly populates realistic players (indian, pvp, global).
/faketab toggle <player>	Toggles a fake player online/offline with join/leave messages.
/faketab say <player> <message>	Forces a fake player to broadcast a message in chat.
/faketab dm <fake> <real> <msg>	Forces a fake player to whisper a real player.
/faketab setskin <player> <skin>	Assigns a custom Mojang skin to a fake player.
/faketab setmood <player> <mood>	Changes the personality/mood of a fake player.
/faketab setping <player> <ping>	Sets custom tab latency in milliseconds.
/faketab stats	Displays AI quota status, provider health, and player statistics.
/faketab clear	Removes all fake players and cleans up tab list packets.