# ⚡ Fake Tab Players v2.4.0 — Realistic Activity & Ping Simulation ### 🌟 New Features & Enhancements - **Dynamic Simulated Activity**: Fake players now organically generate simulated death messages and advancement announcements in chat at configurable intervals. - **Realistic Ping Jitter**: Built-in ping variance simulates real-life network latency fluctuations, making tablist entries indistinguishable from real players. - **LuckPerms Fallback Mode**: Embedded LuckPerms API support ensures complete compatibility and zero startup crashes on servers running without LuckPerms or during delayed API initialization. - **New Admin Commands**: - `/faketab simulate death [player]` — Instantly trigger realistic death simulation for a fake player. - `/faketab simulate advancement [player]` — Announce an advancement celebration for a fake player. - **PlaceholderAPI Expansion Support**: Enhanced placeholders for fake player count, ping, and activity status. - **Optimized Packet Pipeline**: Cleaned packet formatting for ultra-low overhead on high-capacity servers. ### 🐛 Fixes & Stability - Resolved LuckPerms class resolution when LuckPerms is absent. - Ensured thread-safe tablist ordering updates. - Tested and verified on modern Paper/Purpur/Spigot runtime environments.

### 👥 Fake Tab Players v2.3.0 Release Notes - **🌐 Paper Server List Ping Hover Sample Listing**: - Implemented dynamic player sample population for Paper and modern server pings. - Potential players hovering over the player count in their Minecraft multiplayer list will now see realistic fake player names listed in the sample preview! - **⚡ Enhanced Command Tab-Completion**: - Added smart tab-completion for bot personalities and behavioral moods in `/faketab setmood <player> <mood>` (`friendly`, `toxic`, `neutral`, `helpful`, `silent`, `funny`, `pvper`) and `/faketab setpersona <player> <persona>` (`sweat`, `noob`, `builder`, `trader`, `casual`, `chatter`). - **🌐 Native Folia & Paper 1.20 - 1.21.x Multi-Threading Support**: - Added `folia-supported: true` and verified clean multi-threaded initialization. - **🛡️ Shaded SQLite-JDBC & PacketEvents Compatibility**: - Shaded SQLite storage drivers and verified seamless operation with PacketEvents 2.12.0.

## v2.2.0 — New Commands, Bug Fixes & AI Improvements ### 🔴 Bug Fixes - **Fixed `friend-prefer-chance` config path** — was silently reading wrong key, friend memory now works correctly - **Fixed `/faketab clear` ConcurrentModificationException** — no more crash on clearing all players - **Fixed name validation** — now accepts 2-character names (valid since Minecraft 1.19.4) - **Fixed ping fluctuation** — was hardcoded ±7ms, now configurable - **Fixed config migration** — proper v1→v2 upgrade path with new keys auto-added ### ✨ New Features - `/faketab info <name>` — View UUID, group, ping, skin, mood, last-joined of any fake player - `/faketab setpersona <name> <persona>` — Directly set AI persona (miner/builder/pvper/farmer/trader/explorer) + mood - `/faketab batch-toggle <online|offline|all>` — Bulk toggle all fake players at once - `/faketab randomskin <name>` — Assign a random popular Minecraft skin instantly - `ai.temperature` config key — Tune AI creativity (0.0–1.0, default 0.75) - `fake-players.ping-fluctuate-range` config key — Control ping variation range - `chat.min-real-players` config key — Only trigger AI chat when X real players are online - Google `gemini-2.5-flash` + `gemini-2.5-flash-lite` added to fallback model chain - Tab completion for all new commands including persona suggestions

# 📋 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. |