# XFakePlayersPro Commands Guide Complete reference for all commands, permissions, and usage examples. --- ## Command Overview | Command | Permission | Description | |---------|-----------|-------------| | `/fake add ` | `xfakeplayers.admin` | Create a new fake player | | `/fake remove ` | `xfakeplayers.admin` | Delete a fake player | | `/fake list` | `xfakeplayers.admin` | List all fake players | | `/fake connect ` | `xfakeplayers.admin` | Connect a fake player | | `/fake disconnect ` | `xfakeplayers.admin` | Disconnect a fake player | | `/fake setgroup ` | `xfakeplayers.admin` | Set LuckPerms group | | `/fake reload` | `xfakeplayers.admin` | Reload configuration | | `/fake info ` | `xfakeplayers.admin` | View fake player details | --- ## Detailed Command Usage ### `/fake add ` Creates a new fake player with the specified name. **Usage:** ``` /fake add Steve /fake add Alex /fake add xXPro_Gamer123Xx ``` **What happens:** - New fake player is created with random UUID - Player is saved to `players.yml` - Player is assigned default LuckPerms group - Player is NOT automatically connected (use `/fake connect` or enable auto-connect) **Best practices:** - Use realistic names (common Minecraft names, not "FakePlayer1") - Mix style preferences (some with underscores, some with numbers, some plain) - Avoid obvious patterns (all starting with "Bot_") **Good examples:** ``` /fake add CraftyBuilder /fake add MiningPro /fake add Epic_Warrior /fake add SkyBlockMaster /fake add PvPLegend ``` **Bad examples:** ``` /fake add Bot1 /fake add FakePlayer /fake add TestUser123 /fake add AAAAAA ``` --- ### `/fake remove ` Permanently deletes a fake player. **Usage:** ``` /fake remove Steve ``` **What happens:** - Fake player is disconnected if online - Player is removed from memory and `players.yml` - Action cannot be undone **Warning:** This permanently deletes the fake player. If you want to temporarily remove them, use `/fake disconnect` instead. --- ### `/fake list` Shows all fake players and their online status. **Usage:** ``` /fake list ``` **Output example:** ``` === Fake Players (5 total, 3 online) === ✓ Steve [ONLINE] - Group: vip - Ping: 42ms ✓ Alex [ONLINE] - Group: default - Ping: 28ms ✗ Notch [OFFLINE] - Group: admin ✓ Herobrine [ONLINE] - Group: default - Ping: 35ms ✗ Dream [OFFLINE] - Group: default ``` **Legend:** - `✓` = Online - `✗` = Offline - Ping shown only for online players --- ### `/fake connect ` Manually connects a fake player to the server. **Usage:** ``` /fake connect Steve ``` **What happens:** - Fake player is added to TAB list (ProtocolLib packets sent) - Join message is broadcast (if enabled) - Player starts a session with random duration - Player begins chat/advancement simulation **Notes:** - Player must exist (use `/fake add` first) - Player must be offline - Session duration is random (configured in `config.yml`) **Auto-connect alternative:** Enable auto-connect in `config.yml`: ```yaml activity: auto-connect: enabled: true min-players: 2 max-players: 8 ``` --- ### `/fake disconnect ` Manually disconnects a fake player from the server. **Usage:** ``` /fake disconnect Steve ``` **What happens:** - Fake player is removed from TAB list - Leave message is broadcast (if enabled) - Player stops chat/advancement simulation - Player remains saved (can be reconnected later) **Notes:** - Player must be online - Does not delete the fake player - Player may auto-reconnect if auto-connect is enabled --- ### `/fake setgroup ` Assigns a LuckPerms group to a fake player. **Usage:** ``` /fake setgroup Steve vip /fake setgroup Alex admin /fake setgroup Notch owner ``` **Requirements:** - LuckPerms must be installed - Group must exist in LuckPerms - Fake player must exist **What happens:** - Fake player's `luckPermsGroup` field is updated - TAB list display name updates with new prefix/suffix - Chat messages show new prefix - Changes are saved to `players.yml` **View available groups:** ``` /lp listgroups ``` **Create a group:** ``` /lp creategroup vip /lp group vip permission set some.permission true /lp group vip meta setprefix "&b[VIP] " ``` --- ### `/fake reload` Reloads configuration from `config.yml` without restarting the server. **Usage:** ``` /fake reload ``` **What happens:** - `config.yml` is reloaded - Activity simulators restart with new settings - Scoreboard refreshes - Fake players remain connected - TAB list updates **Does NOT reload:** - `players.yml` (fake players are not re-loaded) - New fake players added manually to file - Plugin dependencies (ProtocolLib, LuckPerms, PAPI) **To fully reload fake players:** 1. `/fake reload` 2. Restart server (or disconnect/reconnect all fake players) --- ### `/fake info ` Shows detailed information about a fake player. **Usage:** ``` /fake info Steve ``` **Output example:** ``` === Fake Player Info: Steve === UUID: 12345678-1234-1234-1234-123456789abc Name: Steve Status: ONLINE Ping: 42ms LuckPerms Group: vip Session Start: 5 minutes ago Session Duration: 45 minutes remaining Last Activity: 2 seconds ago Skin: Present (texture length: 512) ``` **Use cases:** - Check if fake player is online - View UUID for manual `players.yml` editing - Debug connection issues - Verify LuckPerms group assignment --- ## Permissions ### `xfakeplayers.admin` **Default:** `op` **Grants access to:** - All `/fake` commands - Configuration reload - Creating/deleting fake players - Connecting/disconnecting fake players **Usage:** ``` /lp user permission set xfakeplayers.admin true /lp group moderator permission set xfakeplayers.admin true ``` ### `xfakeplayers.bypass` **Default:** `op` **Grants:** - Bypass fake player TPA requests - See actual player counts (if debug mode enabled) - Ignore fake player chat simulation (optional) **Usage:** ``` /lp user permission set xfakeplayers.bypass true ``` --- ## Usage Examples ### Scenario 1: Setting Up Initial Fake Players ```bash # Create 5 fake players /fake add CraftySteve /fake add MiningExpert /fake add BuilderPro /fake add SkyWarrior /fake add DiamondHunter # Assign varied ranks /fake setgroup CraftySteve vip /fake setgroup BuilderPro vip /fake setgroup MiningExpert default /fake setgroup SkyWarrior default /fake setgroup DiamondHunter admin # Connect them manually /fake connect CraftySteve /fake connect MiningExpert /fake connect BuilderPro # Or enable auto-connect in config.yml ``` ### Scenario 2: Populating Server at Launch ```bash # config.yml activity: auto-connect: enabled: true interval: 300 # Check every 5 minutes min-players: 3 # Keep 3-10 fake players online max-players: 10 ``` Then create fake players: ```bash /fake add Player1 /fake add Player2 /fake add Player3 /fake add Player4 /fake add Player5 # ... create 10-15 total ``` Fake players will auto-connect and maintain 3-10 online at all times. ### Scenario 3: Event Mode (High Activity) Before an event, temporarily increase fake players: ```bash # Connect many fake players /fake connect Player1 /fake connect Player2 /fake connect Player3 /fake connect Player4 /fake connect Player5 # Or modify config.yml activity: auto-connect: min-players: 8 max-players: 15 # Reload /fake reload ``` After the event: ```bash # Disconnect extras /fake disconnect Player1 /fake disconnect Player2 # Or reduce config limits activity: auto-connect: min-players: 2 max-players: 5 # Reload /fake reload ``` ### Scenario 4: Fixing TAB Display Issues If fake players aren't showing in TAB: ```bash # 1. Verify fake players exist /fake list # 2. Reconnect them /fake disconnect Steve /fake connect Steve # 3. Reload plugin /fake reload # 4. Check ProtocolLib /pl ``` --- ## Configuration Integration Commands work with `config.yml` settings. Here's how: ### Auto-Connect ```yaml activity: auto-connect: enabled: true ``` - Fake players auto-connect based on min/max settings - Manual `/fake connect` still works - Players may auto-disconnect after session duration ### Session Duration ```yaml activity: session-duration: min: 600 # 10 minutes max: 3600 # 1 hour ``` - Connected fake players stay online for random duration - After duration expires, they auto-disconnect - Manual `/fake disconnect` works anytime ### LuckPerms Integration ```yaml integration: luckperms: enabled: true default-group: 'default' ``` - New fake players get `default-group` automatically - Use `/fake setgroup` to change - Prefixes/suffixes show in TAB and chat --- ## Troubleshooting ### "Fake player not found" **Cause:** Player doesn't exist in `players.yml` **Solution:** ``` /fake add ``` ### "Fake player is already online" **Cause:** Trying to connect an already-connected player **Solution:** ``` /fake disconnect /fake connect ``` ### "Fake player is already offline" **Cause:** Trying to disconnect an offline player **Solution:** Player is already offline, no action needed. ### Changes not applying **Cause:** Config cached in memory **Solution:** ``` /fake reload ``` ### Group not found **Cause:** LuckPerms group doesn't exist **Solution:** ``` /lp listgroups /lp creategroup /fake setgroup ``` --- ## Advanced Tips ### Bulk Operations To create many fake players quickly, use a command block or script: **Command block loop:** ``` /fake add Player1 /fake add Player2 /fake add Player3 # etc. ``` **Or edit `players.yml` directly:** ```yaml players: - uuid: '...' name: 'Player1' # ... other fields - uuid: '...' name: 'Player2' # ... other fields ``` Then reload server (config reload won't work for this). ### Realistic Rank Distribution Mirror your real server's rank distribution: - 70% default - 20% VIP - 8% VIP+ - 2% admin/mod **Example:** ```bash # Out of 10 fake players: /fake setgroup Player1 default # 7 default /fake setgroup Player2 default /fake setgroup Player3 default /fake setgroup Player4 default /fake setgroup Player5 default /fake setgroup Player6 default /fake setgroup Player7 default /fake setgroup Player8 vip # 2 vip /fake setgroup Player9 vip /fake setgroup Player10 admin # 1 admin ``` ### Testing Setup Test your fake players before going live: 1. Create 2-3 fake players 2. Connect them: `/fake connect Player1` 3. Check TAB list (press Tab key) 4. Check scoreboard (if using scoreboard plugin) 5. Check server list (refresh server list in launcher) 6. Send a TPA request to a fake player: `/tpa Player1` 7. Watch for chat messages and advancements If any step fails, see `INTEGRATION_GUIDE.md`. --- ## Quick Reference **Create and connect:** ``` /fake add /fake connect ``` **Assign rank:** ``` /fake setgroup ``` **Remove:** ``` /fake disconnect /fake remove ``` **View:** ``` /fake list /fake info ``` **Reload:** ``` /fake reload ``` --- For integration with TAB, scoreboard plugins, and more, see `INTEGRATION_GUIDE.md`.