Addons

Addons are optional extra features that ship with Asteroid. Each is a separate module you can turn on or off on its own. They live in their own config files under plugins/Asteroid/addons/.

Every addon has an enabled flag at the top of its file. All addons are off by default. Turn one on, edit its settings, and reload.

Addon	File	What it does
Login	login.yml	Logs fake players into an auth or login plugin
Ranks	ranks.yml	Gives fake players ranks with weighted probability
Voting	voting.yml	Makes fake players vote on voting sites
Ping	ping.yml	Makes each fake player's ping drift realistically over time
Persistent IPs	persistent_ips.yml	Keeps a stable IP address per fake player

Login

If your server uses an auth or login plugin (the kind that asks players to run /login), fake players may get stuck at the login screen. This addon logs them in automatically using a password.

enabled: false
password: "doarandom"

password is what fakes log in with. Leave it as doarandom to have Asteroid generate one secure random password the first time the addon is enabled.

Ranks

Gives fake players ranks so they do not all look like default members. Weighted: each rank has a weight, and higher weights are handed out more often.

enabled: false
persistent: true
ranks:
  default: 60
  vip: 30
  mvp: 10

persistent keeps a fake's rank forever once given. Add your own ranks with weights; higher weight means the rank is given more often. Suggested only when giving ranks through commands does not work for your setup.

Voting

Makes fake players cast votes on Minecraft voting sites, so your vote counts and vote-party progress keep moving.

enabled: false
interval: "{random[10,30]}"
vote-cooldown: 24
vote-all-sites: false
voting-sites:
  - "Minecraft-MP"
  - "MinecraftIpList"

Setting	What it does
interval	Seconds between votes. Randomize it so votes are spread out.
vote-cooldown	Hours before the same fake can vote again on the same site.
vote-all-sites	If true, the chosen fake votes on all eligible sites at once with a small 3 to 10 second delay between each. If false, one random site per interval.
voting-sites	The list of site names votes are sent for.

Ping

Makes each fake player's ping change over time naturally instead of staying frozen. Each fake runs its own timer, so updates are spread out.

enabled: false
interval: "{random[10,30]}"
ping:
  useRealisticGenerator: true
  custom: "{random[20,180]}"
  fluctuation: 10

Setting	What it does
interval	Seconds between ping updates for each fake.
ping.useRealisticGenerator	Use Asteroid's built-in realistic generator for the baseline. If false, uses custom.
ping.custom	The baseline ping when useRealisticGenerator is false.
ping.fluctuation	How much, in milliseconds, each update nudges the ping up or down. Set to 0 to fully re-roll the ping each update instead, which looks jumpier.

Persistent IPs

Keeps a stable IP address tied to each fake player profile, so the same fake always appears to connect from the same place across sessions and restarts.

enabled: false
ips: {}

ips is managed automatically. Do not edit it by hand unless you know what you are doing.