Getting Started

Getting Started

A five-minute tour. You need operator rights (or ultimatevirtualspawner.admin.spawner) for the first step only.

1. Give yourself a spawner

/spawner give <yourname> ZOMBIE 5

ZOMBIE is a type key from spawners.yml. To see every key configured on your server:

/spawner types

The default types are PIG, COW, ZOMBIE, SPIDER, SKELETON, CREEPER, PIGLIN, BLAZE and IRON_GOLEM.

You now hold 5 spawner items. Each item in that stack is worth 1 spawner.

2. Place it

Place normally → 1 spawner is placed, 4 stay in your hand.

Sneak + place → the whole item stack is placed at once, as a single block holding 5 spawners.

The block is now a managed spawner: it is registered in the database, owned by you, and it will never spawn a real mob.

3. Stack more onto it

Hold another spawner item of the same type and right-click the block.

• Right-click → adds 1.
• Sneak + right-click → adds as many from the held stack as will fit.

The block's stack size grows up to MAX_STACK_PER_BLOCK (default 100000). Stacking a different type is rejected — one block, one mob type.

4. Watch it generate

Every GENERATION_INTERVAL_SECONDS (default 5 s) the spawner rolls its drop table once per spawner in the stack, and stores the result. A 5-stack zombie spawner generates five times as fast as a 1-stack.

Nothing spawns. Nothing drops on the floor. Check what it has collected:

/spawner info

while looking at the block. It prints type, owner, stack size, stored loot, stored XP, access mode and coordinates.

5. Open the GUI

Right-click the spawner with an empty hand. The main menu opens:

Slot	Button	What it does
11	Spawner Storage (chest)	Opens the virtual storage
13	Mob head	Sells all stored loot and claims stored XP
15	Collect XP (bottle)	Claims stored XP only

Click the chest to enter storage.

6. Collect your loot

Storage behaves like a chest, but everything in it is virtual:

Click	Effect
Left-click an item	Pick it up onto the cursor
Right-click an item	Pick up half
Shift-left-click an item	Move it straight into your inventory
Shift-right-click an item	Toggle its filter — stop or resume storing that material
Left-click with a full cursor	Put items into storage

And along the bottom row:

Slot	Button	What it does
45	Back	Return to the main menu
46	Filter Settings	Per-drop filter screen with enable-all / disable-all
48	Collect All	Everything into your inventory
49 / 51	Previous / Next page	Paging
52	Drop Loot	Drop this page's loot on the ground
53	Sell All	Opens the sell confirmation screen

7. Sell it

Click Sell All. A confirmation screen shows the payout and your multiplier before anything is sold — click the green pane to confirm, the red pane to cancel.

Selling needs a working economy. If you see "Selling is disabled or no economy plugin is installed", open config.yml and set:

ECONOMY:
  PROVIDER: INTERNAL

then restart (this one setting needs a full restart, not /spawner reload). See Economy.

Check the money landed:

/balance

8. Take the spawner back

Break it with a Silk Touch pickaxe.

• Break → removes 1 spawner from the stack and gives you the item.
• Sneak + break → removes up to 64 at once.

Without Silk Touch the break is cancelled and you get "You need Silk Touch to break this spawner!". Creative mode and ultimatevirtualspawner.spawner.bypass are the only exemptions — being an operator is not enough by itself, though ops hold the bypass node by default.

To split a held stack item instead:

/spawner split 10

Where to go next

• How It Works — the generation maths, and why the numbers look the way they do
• Spawner Types — add your own mob types and drop tables
• Configuration — everything you can change
• Permissions — what to grant your players