---

FakePlayerCount sets what the multiplayer server list reports for your server: the online count, and the names shown when someone hovers over it. Run a fixed number, add to your real count, or let it drift within a range. One jar, no dependencies, server-side only.

Note: This only touches the server-list ping. Nothing is spawned in-world, no chunks are loaded, and clients install nothing.

---

Features

• Three count modes: fixed, add, or a value that drifts within a range.
• Custom hover list built from your own names, with color code support.
• Names reshuffle on every ping so the list never looks static.
• Optional max-players override so the count never reads as full.
• Runs after vanish plugins (SuperVanish, EssentialsX) instead of being overwritten by them.
• /fakecount reload applies config changes without a restart.
• No external dependencies.

---

Modes

Mode	Behavior
fixed	Shows a fixed number.
add	Adds a set amount on top of your real online count.
range	Drifts between a minimum and maximum over time.

---

Hover list

When someone hovers the player count, they see a list built from names you define instead of an empty tooltip:

plew6vg
DrDonutt
Penguinoooo_
maangcho4
pyko199
Chachoune
CommandGhost

Names come from the config, support color codes, and reshuffle on each ping.

---

Configuration

# ============================================================
#  FakeCount configuration
# ============================================================

fake-count:

  # Turn the whole feature on or off.
  enabled: true

  # How the displayed online count is calculated:
  #   fixed -> always show exactly the 'online' value below
  #   add   -> show the REAL online players PLUS the 'online' value
  #   range -> drift up and down between range-min and range-max over time
  mode: range

  # Used by 'fixed' and 'add' modes.
  online: 432

  # The count wanders randomly between these two values so it looks alive.
  range-min: 19012
  range-max: 19499
  # How often (in seconds) the number changes.
  range-update-seconds: 1
  # The most the number can move in a single change.
  # Bigger = it travels across the range faster.
  range-step: 15
  # --------------------------------------------------------------------

  # Maximum player slots shown on the server list.
  # Keep this comfortably ABOVE your highest count so it never looks full.
  # Set to -1 to leave your server's real max-players untouched.
  max-players: 20000


# ============================================================
#  Hover names (the list shown when you hover the player count)
# ============================================================

hover-names:

  # Turn the fake hover list on or off.
  enabled: true

  # true  -> hide the real players and show only the fake names below
  # false -> show real players first, then add the fake names underneath
  replace-real: false

  # How many names (picked at random from the list) to show each time.
  # Set to -1 to always show every name in the list.
  show-count: -1

  # Don't use this it adds 2 instead of 1
  show-and-more: false

  # Don't use this it adds 2 instead of 1
  and-more-format: ""

  # The pool of fake names. Use & for color codes (e.g. &b = aqua).
  names:
    - "plew6vg"
    - "DrDonutt"
    - "Penguinoooo_"
    - "maangcho4"
    - "pyko199"
    - "Chachoune"
    - "CommandGhost"
    - "hammyham220"
    - "ovoura"
    - "SteeperBoar1552"
    - "✨oung501"
    - "TTKxSky"
    - "xMatiq"
    - "WeesterMC"
    - "eggyweggy1"

---

Commands

Command	Description	Permission
/fakecount reload	Reloads the config without a restart	fakecount.admin (op by default)

---

FAQ

Does it spawn real bots or players? No. It changes the count and hover list on the server-list ping. Nothing is created in-world.

Count shows 0 with the plugin installed. Another plugin handling the ping, usually a vanish plugin, is overriding it. FakeCount already runs at the latest priority; if it persists, pull the other plugin to confirm.

Can I change the number without restarting? Yes. Edit the config and run /fakecount reload.

---