NexusSpoofer splits its settings across several files, all generated automatically on first launch. config.yml holds the general settings, messages.yml holds every chat message, chat.yml holds the random fake chat lines and auto replies, names.yml sets how fake names are picked, skins.yml holds the built-in skin pool, reactions.yml controls how fakes react to real players, events.yml holds fake death messages and advancements, and the menus/ folder styles every menu (see the GUI Configuration section). Each recorded route is saved in its own file under movements/, and AFK spots are saved in data/afk.yml.

TAB List

SettingDefaultDescription
tab-list.enabledtrueShow fakes in the TAB list
tab-list.name-format{prefix}&7{name}{suffix}{afk}How fake names look in TAB
tab-list.default-ping-range[25, 90]Ping range fakes are given
tab-list.ping-update-seconds30How often fake ping changes slightly
tab-list.sort-by-weighttrueSort fakes by rank weight, needs 1.21.2 or newer
tab-list.sort-real-playerstrueAlso sort real players so ranks mix together
staff-indicator.enabledtrueShow the FAKE marker to players with nexusspoofer.seefakes
staff-indicator.format&8[&cFAKE&8] Marker shown before fake names

Server List

SettingDefaultDescription
ping.enabledtrueChange the server list player count
ping.include-fakestrueCount fakes before the mode is applied
ping.count-modeADDADD, MULTIPLY, FIXED or MAX_OF
ping.count-value0Value used by the count mode
ping.max-players-modeFIXEDADD, MULTIPLY, FIXED or MAX_OF for the max slot
ping.max-players-value100Value used by the max mode
ping.max-at-least-onlinetrueNever show a max lower than the online count
ping.sample4Names shown when hovering the player count
ping.sample-include-realtrueMix real players into the hover names
motd.enabledfalseUse a custom MOTD
motd.lines2 linesMOTD lines, supports {online} and {max}
ADD adds the value to real players plus fakes, MULTIPLY multiplies it, FIXED always shows the value, and MAX_OF shows whichever is higher. Leave count-value at 0 with ADD to show the real count plus fakes.

Chat and Join/Leave

SettingDefaultDescription
chat.enabledtrueFakes send random chat messages
chat.min-interval-seconds60Shortest time between fake messages
chat.max-interval-seconds240Longest time between fake messages
chat.per-fake-cooldown-seconds300How long one fake waits before talking again
chat.join-grace-seconds20Fakes stay quiet this long after joining
chat.format{prefix}&7{name}{suffix}&8: &f{message}Chat format, match it to your chat plugin
join-leave.enabledtrueBroadcast join and leave messages
join-leave.min-stay-minutes5Shortest time a fake stays online
join-leave.max-stay-minutes240Longest time a fake stays online
join-leave.manual-fakes-leavefalseFakes added with /spoofer add also leave on their own

In-World Fakes

SettingDefaultDescription
entities.enabledfalseShow fakes in the world
entities.max6Most fakes in the world at once
entities.spawn-radius8Spread around the center for standing fakes
entities.center""Set with /spoofer setcenter, empty uses the world spawn
entities.look-at-playerstrueStanding fakes look at nearby players
entities.look-range8Distance fakes notice players from, in blocks
entities.swing-chance0.02Chance a standing fake swings its arm
entities.skin-layers-indexautoLeave on auto unless told otherwise
entities.holograms-enabledtrueShow text above in-world fakes
entities.hologram-height2.35Height of the hologram, in blocks
entities.hologram-lines{prefix}Hologram text lines

Movements and AFK

SettingDefaultDescription
movements.enabledtrueFakes walk recorded routes
movements.auto-assigntrueNew fakes pick up a route on their own
movements.random-starttrueFakes start at a random point on the route
movements.default-modeLOOPLOOP or PINGPONG for new recordings
movements.route-orderSEQUENTIALSEQUENTIAL or RANDOM for fakes with several routes
movements.max-record-seconds600Longest recording allowed
afk.enabledtrueUse AFK spots
afk.auto-assign-chance0.3Chance a new fake takes a free AFK spot
afk.tag""Text for {afk} when a fake is AFK
afk.can-chatfalseAFK fakes can still chat
afk.seat-height0.0Height adjustment for sitting fakes
If sitting AFK fakes float above or sink into the block, change afk.seat-height. Negative values lower them and positive values raise them.

Daily Curve

SettingDefaultDescription
scheduler.enabledtrueRun the daily curve
scheduler.timezoneEurope/WarsawTime zone the curve times are read in
scheduler.jitter-percent15Random change applied to the target
scheduler.tick-interval-seconds30How often the curve is checked
scheduler.max-change-per-tick1Most fakes added or removed per check
scheduler.curve00:00 to 20:00Time and target fake count pairs, blended smoothly between times
The curve uses scheduler.timezone, not the server's clock. Change it to your own, for example America/New_York, or your busiest hours will be in the wrong place.

Ranks, Skins and Names

SettingDefaultDescription
ranks.enabledtrueGive fakes ranks
ranks.sourceAUTOAUTO, LUCKPERMS or CONFIG
ranks.groupsdefault 80, vip 14, mvp 6Group names and how often fakes get them
skins.default-sourceMIXEDBUILTIN, MOJANG, MINESKIN or MIXED
skins.fallback-chain[BUILTIN, MOJANG, MINESKIN]Order skin sources are tried in
skins.cache-ttl-hours168How long skin lookups are cached
skins.mineskin-api-key""Your MineSkin API key
skins.request-timeout-seconds6Timeout for skin lookups
names.sourceMIXEDLIST, GENERATED or MIXED
names.prefix""Text added before every fake name
names.suffix""Text added after every fake name
names.forbid-duplicates-with-realtrueRemove a fake if a real player with that name joins
names.min-length3Shortest name allowed
names.max-length16Longest name allowed
With LuckPerms installed, fakes use the prefix, suffix and weight of your real groups, so the names in ranks.groups must match your LuckPerms groups exactly. Without LuckPerms, give each group a prefix in the config, for example vip with weight: 14 and prefix: "&a[VIP] ".

Default Config File

tab-list:
  enabled: true
  name-format: "{prefix}&7{name}{suffix}{afk}"
  default-ping-range: [25, 90]
  ping-update-seconds: 30
  sort-by-weight: true
  sort-real-players: true

staff-indicator:
  enabled: true
  format: "&8[&cFAKE&8] "

ping:
  enabled: true
  include-fakes: true
  count-mode: ADD
  count-value: 0
  max-players-mode: FIXED
  max-players-value: 100
  max-at-least-online: true
  sample: 4
  sample-include-real: true

motd:
  enabled: false
  lines:
    - "&#4FA3F7&lNexus Network &8| &71.21"
    - "&7{online} players online"

chat:
  enabled: true
  min-interval-seconds: 60
  max-interval-seconds: 240
  per-fake-cooldown-seconds: 300
  join-grace-seconds: 20
  format: "{prefix}&7{name}{suffix}&8: &f{message}"

join-leave:
  enabled: true
  min-stay-minutes: 5
  max-stay-minutes: 240
  manual-fakes-leave: false

entities:
  enabled: false
  max: 6
  spawn-radius: 8
  center: ""
  look-at-players: true
  look-range: 8
  swing-chance: 0.02
  skin-layers-index: auto
  holograms-enabled: true
  hologram-height: 2.35
  hologram-lines:
    - "{prefix}"

afk:
  enabled: true
  auto-assign-chance: 0.3
  tag: ""
  can-chat: false
  seat-height: 0.0

movements:
  enabled: true
  auto-assign: true
  random-start: true
  default-mode: LOOP
  route-order: SEQUENTIAL
  max-record-seconds: 600

scheduler:
  enabled: true
  timezone: "Europe/Warsaw"
  jitter-percent: 15
  tick-interval-seconds: 30
  max-change-per-tick: 1
  curve:
    "00:00": 1
    "08:00": 2
    "12:00": 4
    "16:00": 6
    "20:00": 8

ranks:
  enabled: true
  source: AUTO
  groups:
    default: 80
    vip: 14
    mvp: 6

skins:
  default-source: MIXED
  fallback-chain: [BUILTIN, MOJANG, MINESKIN]
  cache-ttl-hours: 168
  mineskin-api-key: ""
  request-timeout-seconds: 6

names:
  source: MIXED
  prefix: ""
  suffix: ""
  forbid-duplicates-with-real: true
  min-length: 3
  max-length: 16

commands:
  list:
    enabled: true
    aliases: [list, minecraft:list, who, online, elist, ewho, eonline, playerlist, plist]
  msg:
    enabled: true
    aliases: [msg, tell, w, whisper, m, pm, message, t, emsg, etell, ewhisper, minecraft:msg, minecraft:tell, minecraft:w]
    reply-aliases: [r, reply, er, ereply]
    reply-window-seconds: 300
    auto-reply-chance: 0.35
    auto-reply-delay: [3, 12]
  intercept:
    tpa:
      aliases: [tpa, tpahere, etpa, etpahere, call, tpask]
      message: "&6Request sent to &c{target}&6."
    trade:
      aliases: [trade]
      message: "&aTrade request sent to {target}."
    duel:
      aliases: [duel]
      message: "&eYou sent a duel request to {target}."
    pay:
      aliases: [pay, epay]
      message: "&c{target} isn't accepting payments right now."
  tab-complete:
    enabled: true
    commands: [tpa, tpahere, pay, trade, duel, invsee, seen, whois, profile, stats]
Run /spoofer reload after editing any file. No restart is needed.

Chat Lines and Names

SettingDefaultDescription
messages25 linesRandom lines fakes say in chat (chat.yml)
auto-replies10 linesReplies fakes send back to /msg (chat.yml)
list25 namesName list used by LIST and MIXED (names.yml)
generated.first15 wordsFirst half of generated names (names.yml)
generated.second15 wordsSecond half of generated names (names.yml)
generated.number-chance0.45Chance a generated name ends in numbers (names.yml)
generated.underscore-chance0.25Chance a generated name has an underscore (names.yml)
generated.lowercase-chance0.2Chance a generated name is all lowercase (names.yml)
builtin{}Skin pool, filled with /spoofer captureskin (skins.yml)

Reactions

reactions.yml controls how fakes react to real players. The join section has welcome-back for returning players and first-join for new players. The chat section holds any number of reactions, each with its own triggers and replies, and you can add as many as you like.

SettingDefaultDescription
enabledtrueTurns every reaction on or off
<reaction>.enabledtrueTurns one reaction on or off
<reaction>.triggersper reactionWords in real chat that set off the reaction (chat reactions only)
<reaction>.chanceper reactionChance the reaction happens, from 0 to 1
<reaction>.respondersper reactionMinimum and maximum fakes that reply
<reaction>.delayper reactionMinimum and maximum seconds before the first reply
<reaction>.cooldown-secondsper reactionTime before the same reaction can happen again
<reaction>.repliesper reactionLines fakes pick from, {player} is the real player

Fake Events

SettingDefaultDescription
deaths.enabledtrueBroadcast fake death messages (events.yml)
deaths.min-interval-minutes10Shortest time between deaths
deaths.max-interval-minutes35Longest time between deaths
deaths.messages15 linesDeath messages, {other} picks another fake
advancements.enabledtrueBroadcast fake advancements
advancements.min-interval-minutes8Shortest time between advancements
advancements.max-interval-minutes30Longest time between advancements
advancements.formats.<type>per typeMessage for task, goal and challenge advancements
advancements.list26 advancementsAdvancement names and their type, each fake only gets one once

GUI Configuration

Every menu is built from its own file in the menus/ folder. Titles, rows, slots, materials, names, lore and actions can all be changed. Text uses & colour codes and hex colours written as &#RRGGBB, for example &#4FA3F7.

FileControls
menus/main.ymlThe main menu opened by /spoofer gui, with toggles for every system
menus/fakes.ymlThe list of active fakes, with pages
KeyDescription
titleInventory title. fakes.yml supports {page} and {pages}
rowsNumber of rows, 1 to 6
filler.enabledFills empty slots (main.yml)
filler.materialItem used to fill empty slots
filler.nameName of the filler item
items.<name>.slotSlot the button sits in
items.<name>.materialAny Minecraft material
items.<name>.nameDisplay name
items.<name>.loreLore lines. main.yml supports {real}, {fake}, {shown}, {max}, {target} and {state}
items.<name>.actionWhat the button does when clicked
fake-item.nameName of each fake's head (fakes.yml)
fake-item.loreLore of each fake's head, supports {prefix}, {group}, {ping}, {type}, {online} and {leaves}

Button actions

ActionDoes
TOGGLE:<setting>Flips a true or false setting in config.yml, for example TOGGLE:chat.enabled
SCHEDULERPauses or resumes the daily curve
OPEN_FAKESOpens the fakes list
ADD_FAKEAdds a random fake
REMOVE_ALLRemoves every fake, needs a shift-click
RELOADReloads every file
PREVIOUSPrevious page (fakes.yml)
NEXTNext page (fakes.yml)
BACKBack to the main menu (fakes.yml)
CLOSECloses the menu
NONEDoes nothing
Any true or false setting in config.yml can be turned into a GUI button with TOGGLE:<setting>, so you can add buttons for things like motd.enabled or commands.list.enabled.

Messages

KeyDefault
prefix&#4FA3F7&lSpoofer &8» &7
join&e{name} joined the game
leave&e{name} left the game
no-permission{p}&cYou don't have permission.
fake-added{p}Added fake &f{name}&7.
fake-removed{p}Removed fake &f{name}&7.
count`{p}Real &f{real} &8&7Fake &f{fake} &8&7Shown &f{shown}&7/&f{max}`
list-command-entry{prefix}&f{name}
list-command-separator&7,
msg-to-fake&7[&fme &7-> {prefix}&f{target}&7] &f{message}
msg-from-fake&7[{prefix}&f{target} &7-> &fme&7] &f{message}
movement-started{p}Recording &f{name}&7. Walk your route, then &f/movement end&7.
movement-saved{p}Saved &f{name} &8(&7{seconds}s, {mode}&8)&7.
movement-actionbar`&#FF5555● &fRecording &#4FA3F7{name} &8&f{seconds}s&7/{max}s`
afk-created{p}Saved AFK spot &f{name} &8(&7{mode}&8)&7 with your current gear.
afk-set{p}&f{fake} &7is now AFK at &f{name}&7.
The Messages table shows the main ones. messages.yml has every message, including the /list layout (list-command), the help pages (help and movement-help) and every command reply. {p} is replaced with the plugin prefix, while {prefix} is always the fake's rank prefix.