Skip to content

Commands

BeestoXd edited this page Aug 15, 2026 · 1 revision

Commands

Two command families: /spawner for spawners, and /balance /baltop /pay /eco for the built-in economy.

Every command has tab completion.

/spawner

Aliases: /spawners, /uvs, /virtualspawner

Base permission: ultimatevirtualspawner.command.spawner (everyone by default)

Command Permission Console? Description
/spawner admin.spawner no Open the admin panel
/spawner info (base) no Inspect the spawner you are looking at
/spawner panel admin.spawner no Open the admin panel
/spawner give <player> <type> [amount] admin.spawner yes Give a spawner item
/spawner split <amount> (base) no Split the held spawner item
/spawner types (base) yes List the configured spawner types
/spawner remove admin.spawner no Remove the spawner you are looking at
/spawner reload admin.spawner yes Reload every config file
/spawner version (base) yes Show version and compatibility info

Permissions are shown without the ultimatevirtualspawner. prefix. /spawner list is accepted as an alias of types, and /spawner forcebreak of remove.


/spawner info

Look at a managed spawner (within 6 blocks) and run it.

/spawner info
----------- Spawner Info -----------
Type: Zombie Spawner
Owner: Steve
Stack: 250
Stored Loot: 41,320
Stored XP: 4625.0
Access: OWNER_ONLY
Location: world 128, 63, -344

Needs no admin permission — but it only works on a spawner you are physically looking at.


/spawner give <player> <type> [amount]

/spawner give Steve ZOMBIE
/spawner give Steve ZOMBIE 64
/spawner give Steve IRON_GOLEM 1.5K
  • <type> is a key from the TYPES section of spawners.yml — see /spawner types. It is case-insensitive.
  • [amount] defaults to 1 and accepts K / M / B / T / Q suffixes and separators (1_000, 1,000).
  • The target player must be online.
  • Works from console.

The amount is the number of spawners, not the number of items. Amounts above 64 are handed out as several item stacks.


/spawner split <amount>

Splits the spawner item in your hand.

/spawner split 10

Takes 10 spawners out of the held item and gives you a separate item for them. Fails if you hold nothing managed, if the held item is worth only 1 spawner, or if <amount> is not smaller than the current stack.

Useful for handing part of a stack to another player, or for placing an exact number.


/spawner types

--------- Spawner Types (9) ---------
PIG - Pig Spawner | entity: PIG | drops: 2
COW - Cow Spawner | entity: COW | drops: 2
ZOMBIE - Zombie Spawner | entity: ZOMBIE | drops: 4
...

/spawner remove

Deletes the managed spawner you are looking at — database row, stored loot and all. No item is returned and there is no confirmation. Use it for cleaning up a broken or abandoned spawner, not as a routine tool.


/spawner reload

Reloads config.yml, spawners.yml, menus.yml, messages.yml and sounds.yml, then re-reads every setting, re-parses the spawner types, re-syncs placed spawner blocks and refreshes anti-ESP for every online player.

What /spawner reload does not pick up:

Setting Why
ECONOMY.PROVIDER The provider is wired up once at start-up. Changing it needs a full restart.
DATABASE.* The connection is opened at start-up. Changing it needs a full restart.
COMPATIBILITY.* The gate runs once, before anything else loads.
SETTINGS.GENERATION_INTERVAL_SECONDS The repeating task keeps its original period. The value is re-read for the catch-up maths, so the effective rate changes, but the task still fires on the old schedule until restart.

Everything else — drop tables, prices, menus, messages, sounds, anti-ESP, stack limits — applies immediately.


/spawner version

----------- UltimateVirtualSpawner -----------
Plugin version: 1.0
Server software: Paper
Server version: 1.21.10
Supported range: 1.21.10 - 26.2
Scheduler: Bukkit (global)
Managed spawners: 84
Economy: Internal (mode: INTERNAL)

On Folia the scheduler line reads Folia (regionised). If no economy is usable the line reads unavailable (mode: VAULT), which is the fastest way to confirm a selling problem.

Include this output in every bug report.


Economy commands

These are handled by this plugin only while it owns the money — that is, while ECONOMY.PROVIDER is INTERNAL, or AUTO with no external economy registered. With an external economy in charge they tell you which plugin to use instead.

All amounts accept K / M / B / T / Q suffixes: /eco give Steve 1.5M.

/balance [player]

Aliases: /bal, /money, /uvsbalance

/balance          → Balance: $12,480
/balance Steve    → Balance of Steve: $12,480

ultimatevirtualspawner.command.balance (everyone) for your own, ...balance.others (op) for someone else's. From console the player argument is required.

/baltop [size]

Aliases: /balancetop, /moneytop

/baltop
/baltop 25

Defaults to ECONOMY.INTERNAL.BALTOP_SIZE (10). Permission: ultimatevirtualspawner.command.baltop (everyone).

/pay <player> <amount>

/pay Steve 500
/pay Steve 1.5K

Blocked when ECONOMY.INTERNAL.ALLOW_PAY is false, when the amount is below MINIMUM_PAY (default 0.01), when you pay yourself, or when you cannot cover it. Both sides get a message with their new balance. Permission: ultimatevirtualspawner.command.pay (everyone).

/eco <give|take|set|reset> <player> [amount]

Aliases: /economy, /uvseco

/eco give Steve 1000
/eco take Steve 250
/eco set Steve 0
/eco reset Steve

reset puts the player back to ECONOMY.INTERNAL.STARTING_BALANCE. The affected player is notified for give, take and set. Permission: ultimatevirtualspawner.command.eco (op).


Amount format

Everywhere a number is accepted:

Input Value
500 500
1.5K 1,500
2M 2,000,000
3B 3,000,000,000
1T 1,000,000,000,000
1Q 1,000,000,000,000,000
1,000 / 1_000 1,000

Suffixes are case-insensitive.

See also

  • Permissions — the full node list with LuckPerms examples
  • Economy — provider modes and the Vault bridge
  • messages.yml — customise every message these commands print

Clone this wiki locally