---

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`.

---

<div align="center">

add sindosu on discord if there are any issues.

</div>