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
| Setting | Default | Description |
|---|
tab-list.enabled | true | Show 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-seconds | 30 | How often fake ping changes slightly |
tab-list.sort-by-weight | true | Sort fakes by rank weight, needs 1.21.2 or newer |
tab-list.sort-real-players | true | Also sort real players so ranks mix together |
staff-indicator.enabled | true | Show the FAKE marker to players with nexusspoofer.seefakes |
staff-indicator.format | &8[&cFAKE&8] | Marker shown before fake names |
Server List
| Setting | Default | Description |
|---|
ping.enabled | true | Change the server list player count |
ping.include-fakes | true | Count fakes before the mode is applied |
ping.count-mode | ADD | ADD, MULTIPLY, FIXED or MAX_OF |
ping.count-value | 0 | Value used by the count mode |
ping.max-players-mode | FIXED | ADD, MULTIPLY, FIXED or MAX_OF for the max slot |
ping.max-players-value | 100 | Value used by the max mode |
ping.max-at-least-online | true | Never show a max lower than the online count |
ping.sample | 4 | Names shown when hovering the player count |
ping.sample-include-real | true | Mix real players into the hover names |
motd.enabled | false | Use a custom MOTD |
motd.lines | 2 lines | MOTD 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
| Setting | Default | Description |
|---|
chat.enabled | true | Fakes send random chat messages |
chat.min-interval-seconds | 60 | Shortest time between fake messages |
chat.max-interval-seconds | 240 | Longest time between fake messages |
chat.per-fake-cooldown-seconds | 300 | How long one fake waits before talking again |
chat.join-grace-seconds | 20 | Fakes 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.enabled | true | Broadcast join and leave messages |
join-leave.min-stay-minutes | 5 | Shortest time a fake stays online |
join-leave.max-stay-minutes | 240 | Longest time a fake stays online |
join-leave.manual-fakes-leave | false | Fakes added with /spoofer add also leave on their own |
In-World Fakes
| Setting | Default | Description |
|---|
entities.enabled | false | Show fakes in the world |
entities.max | 6 | Most fakes in the world at once |
entities.spawn-radius | 8 | Spread around the center for standing fakes |
entities.center | "" | Set with /spoofer setcenter, empty uses the world spawn |
entities.look-at-players | true | Standing fakes look at nearby players |
entities.look-range | 8 | Distance fakes notice players from, in blocks |
entities.swing-chance | 0.02 | Chance a standing fake swings its arm |
entities.skin-layers-index | auto | Leave on auto unless told otherwise |
entities.holograms-enabled | true | Show text above in-world fakes |
entities.hologram-height | 2.35 | Height of the hologram, in blocks |
entities.hologram-lines | {prefix} | Hologram text lines |
Movements and AFK
| Setting | Default | Description |
|---|
movements.enabled | true | Fakes walk recorded routes |
movements.auto-assign | true | New fakes pick up a route on their own |
movements.random-start | true | Fakes start at a random point on the route |
movements.default-mode | LOOP | LOOP or PINGPONG for new recordings |
movements.route-order | SEQUENTIAL | SEQUENTIAL or RANDOM for fakes with several routes |
movements.max-record-seconds | 600 | Longest recording allowed |
afk.enabled | true | Use AFK spots |
afk.auto-assign-chance | 0.3 | Chance a new fake takes a free AFK spot |
afk.tag | "" | Text for {afk} when a fake is AFK |
afk.can-chat | false | AFK fakes can still chat |
afk.seat-height | 0.0 | Height 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
| Setting | Default | Description |
|---|
scheduler.enabled | true | Run the daily curve |
scheduler.timezone | Europe/Warsaw | Time zone the curve times are read in |
scheduler.jitter-percent | 15 | Random change applied to the target |
scheduler.tick-interval-seconds | 30 | How often the curve is checked |
scheduler.max-change-per-tick | 1 | Most fakes added or removed per check |
scheduler.curve | 00:00 to 20:00 | Time 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
| Setting | Default | Description |
|---|
ranks.enabled | true | Give fakes ranks |
ranks.source | AUTO | AUTO, LUCKPERMS or CONFIG |
ranks.groups | default 80, vip 14, mvp 6 | Group names and how often fakes get them |
skins.default-source | MIXED | BUILTIN, MOJANG, MINESKIN or MIXED |
skins.fallback-chain | [BUILTIN, MOJANG, MINESKIN] | Order skin sources are tried in |
skins.cache-ttl-hours | 168 | How long skin lookups are cached |
skins.mineskin-api-key | "" | Your MineSkin API key |
skins.request-timeout-seconds | 6 | Timeout for skin lookups |
names.source | MIXED | LIST, GENERATED or MIXED |
names.prefix | "" | Text added before every fake name |
names.suffix | "" | Text added after every fake name |
names.forbid-duplicates-with-real | true | Remove a fake if a real player with that name joins |
names.min-length | 3 | Shortest name allowed |
names.max-length | 16 | Longest 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:
- "FA3F7&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
| Setting | Default | Description |
|---|
messages | 25 lines | Random lines fakes say in chat (chat.yml) |
auto-replies | 10 lines | Replies fakes send back to /msg (chat.yml) |
list | 25 names | Name list used by LIST and MIXED (names.yml) |
generated.first | 15 words | First half of generated names (names.yml) |
generated.second | 15 words | Second half of generated names (names.yml) |
generated.number-chance | 0.45 | Chance a generated name ends in numbers (names.yml) |
generated.underscore-chance | 0.25 | Chance a generated name has an underscore (names.yml) |
generated.lowercase-chance | 0.2 | Chance 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.
| Setting | Default | Description |
|---|
enabled | true | Turns every reaction on or off |
<reaction>.enabled | true | Turns one reaction on or off |
<reaction>.triggers | per reaction | Words in real chat that set off the reaction (chat reactions only) |
<reaction>.chance | per reaction | Chance the reaction happens, from 0 to 1 |
<reaction>.responders | per reaction | Minimum and maximum fakes that reply |
<reaction>.delay | per reaction | Minimum and maximum seconds before the first reply |
<reaction>.cooldown-seconds | per reaction | Time before the same reaction can happen again |
<reaction>.replies | per reaction | Lines fakes pick from, {player} is the real player |
Fake Events
| Setting | Default | Description |
|---|
deaths.enabled | true | Broadcast fake death messages (events.yml) |
deaths.min-interval-minutes | 10 | Shortest time between deaths |
deaths.max-interval-minutes | 35 | Longest time between deaths |
deaths.messages | 15 lines | Death messages, {other} picks another fake |
advancements.enabled | true | Broadcast fake advancements |
advancements.min-interval-minutes | 8 | Shortest time between advancements |
advancements.max-interval-minutes | 30 | Longest time between advancements |
advancements.formats.<type> | per type | Message for task, goal and challenge advancements |
advancements.list | 26 advancements | Advancement 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 FA3F7.
| File | Controls |
|---|
menus/main.yml | The main menu opened by /spoofer gui, with toggles for every system |
menus/fakes.yml | The list of active fakes, with pages |
| Key | Description |
|---|
title | Inventory title. fakes.yml supports {page} and {pages} |
rows | Number of rows, 1 to 6 |
filler.enabled | Fills empty slots (main.yml) |
filler.material | Item used to fill empty slots |
filler.name | Name of the filler item |
items.<name>.slot | Slot the button sits in |
items.<name>.material | Any Minecraft material |
items.<name>.name | Display name |
items.<name>.lore | Lore lines. main.yml supports {real}, {fake}, {shown}, {max}, {target} and {state} |
items.<name>.action | What the button does when clicked |
fake-item.name | Name of each fake's head (fakes.yml) |
fake-item.lore | Lore of each fake's head, supports {prefix}, {group}, {ping}, {type}, {online} and {leaves} |
| Action | Does |
|---|
TOGGLE:<setting> | Flips a true or false setting in config.yml, for example TOGGLE:chat.enabled |
SCHEDULER | Pauses or resumes the daily curve |
OPEN_FAKES | Opens the fakes list |
ADD_FAKE | Adds a random fake |
REMOVE_ALL | Removes every fake, needs a shift-click |
RELOAD | Reloads every file |
PREVIOUS | Previous page (fakes.yml) |
NEXT | Next page (fakes.yml) |
BACK | Back to the main menu (fakes.yml) |
CLOSE | Closes the menu |
NONE | Does 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
| Key | Default |
|---|
prefix | FA3F7&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 FA3F7{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.