AquaVirtual
A virtual spawner belongs to a player, not to a chunk. It sits in the database until they place it, becomes a real spawner block while it is out, and goes back to being data when they pick it up. Every one runs on a countdown.
Soft-depend: PlaceholderAPI, WorldGuard, WorldEdit
States
| State | Means |
|---|---|
STORED | Owned but not in the world |
PLACED | A real spawner block, producing mobs |
FROZEN | Paused by staff. No mobs, no countdown |
EXPIRED | The time ran out |
Duration modes
The mode decides when the countdown burns, and it is set per spawner.
| Mode | Burns |
|---|---|
REAL_TIME | Wall clock. Even while stored, even while the server is off |
ACTIVE_TIME | Only while the block is placed |
ONLINE_TIME | Only while placed and the owner is connected |
PERMANENT | Never |
spawners:
default-mode: REAL_TIMEdefault-mode is used when give gets no mode. Pass one to pick it per spawner:
/aquavirtual give Senkex 1 blaze 7d ACTIVE_TIME
/aquavirtual give Senkex 1 zombie 3d ONLINE_TIME
/aquavirtual give Senkex 1 cow permanentA REAL_TIME spawner cannot lose progress in a crash, because it is measured against the clock.
The other modes are counted while the server runs, so they can lose up to one save interval.
Slots
Every player has a number of slots, and a spawner takes one whether it is stored or placed. The
limit is the higher of the config default and the best aquavirtual.slots.<number> node they hold,
plus any manual bonus, capped by max-slots.
spawners:
default-slots: 5
max-slots: 256
permission-slots: true| Player holds | Slots |
|---|---|
| Nothing | 5 |
aquavirtual.slots.10 | 10 |
aquavirtual.slots.10 and aquavirtual.slots.25 | 25 |
aquavirtual.slots.500 | 256, the max-slots cap |
Files
| File | Holds |
|---|---|
config.yml | Storage, slots, time, expiry, placement, protection, spawning |
mobs.yml | The mob catalog, per mob rates and permissions |
blacklist.yml | Everywhere a spawner is not allowed to exist |
gui.yml | The spawner menu |
messages.yml | Every string |