Skip to content

UltraSpoof

Fake Players

Names and IPs

Bots are drawn from two lists in data.yml. A bot takes a name and an IP, and that pair stays together while it is online. A name already online will not be picked twice.

Edit both under Names & IPs in the menu, or use commands:

  • /ultraspoof generate-names 50 pulls 50 names from our name API.
  • /ultraspoof generate-ips 50 makes up 50 IPs.
  • /ultraspoof import <url-or-names> takes a URL or a list you paste in.

Skins

Bots wear the real skin of whoever owns that name on Mojang. So AlexPvP looks like AlexPvP. If nobody owns the name, the bot gets the default skin and nothing else changes. Skins are cached for 30 minutes, and a failed lookup never stops a bot from joining.

Where they spawn

Spawn points live in data.yml and each one has a weight. Higher weight means picked more often. Add them from the menu while standing where you want them.

Ping

Two modes.

MATCH_PLAYERS copies the range your real players actually have. This is the realistic one. default is the value used when nobody real is online, and max-step caps how far a ping can move in one update.

CONFIGURED walks between a min and a max you set, with separate chances and step sizes for going up and going down.

update-seconds is how often every bot's ping moves.

Ranks

Each rank has a name, a weight and a list of console commands. When a bot first gets a rank, those commands run with %player% replaced by its name. That is how you wire it to LuckPerms or whatever you use:

lp user %player% parent set vip

no-rank-weight is the chance of getting nothing. With 25 there and one VIP rank at 5, most bots stay plain.

A rank sticks to the name, so a bot keeps it across sessions. Turn the whole thing off with ranks.enabled.

Auto join

This is what makes the count move on its own.

The target is worked out like this:

target = base + (real players x percent / 100)

then kept between min and max. With base 0, percent 150 and 10 real players, the target is 15 bots.

  • joins.interval-min-seconds and max control how spread out arrivals are.
  • lifetime.min-minutes and max-minutes is how long a bot stays before it leaves.

Fluctuation

Peak hours. Each window has days, a start and an end, and while it is active it adds to both the base and the percent. Windows can cross midnight, like a weekend one running 13:00 to 02:00.

Set timezone to yours. The list of Java timezone IDs is here.

Windows stack. If two are active at once, both bonuses apply.

Coming back after a restart

fake-players.restore-roster-on-start is on by default. The plugin remembers who was online and brings the same names back, instead of drawing fresh ones from the pool. A restart then looks like the same players returning, which is what actually happens on a real server.

The roster is saved every minute while running too, so a crash does not lose it.

Ports

port-start and port-end are the range a bot's fake connection port is picked from. You rarely need to touch this.