Boosters, tickets and wands

Boosters, tickets and wands are defined in boosters.yml and drawn in menus/boosters.yml. All three are bought from /atlasspawner trust boosters, or given to a player directly with /atlasspawner trust item (useful for wiring another shop or crate plugin to sell them).

Boosters

A booster is a temporary multiplier, used by right-clicking a spawner with the booster item in hand.

• Scope SPAWNER — applies to the one spawner it is used on, and lives in that block. Its uses count is spent, one per production cycle; -1 is unlimited while it lasts.
• Scope ALL — applies to everything its owner has, on every server sharing the database, from the moment it is used from the hand (it does not need a spawner in front of the player). uses is meaningless for ALL and is always treated as unlimited — an owner with fifty spawners would otherwise burn a hundred uses in a couple of seconds.

Every booster has a kind (AMOUNT, DELAY, EXPERIENCE, DROPS, SELL) and a factor. A spawner’s own booster and its owner’s ALL booster of the same kind multiply together — the factors are never capped and never fall off with distance or with how many spawners are near. Within one scope, only one booster of a given kind runs at a time: buying or using a second one of the same kind replaces the first, it does not stack with it.

A booster’s duration (30m, 1h30m, 2d, or 0 for “until the uses run out”) decides when it stops multiplying — there is no timer counting down in the background; an expired booster simply stops applying the next time it would be checked.

config.yml’s boosters.enabled is the master switch for the shop and for boosters already running. Each kind also has its own switch (boosters.amount, boosters.delay, boosters.experience, boosters.drops, boosters.sell); turning one off makes every booster of that kind stop multiplying immediately, without removing the item or the row.

Tickets

See Upgrades and tickets for how a ticket applies — it is the same upgrade the menu sells, paid for once and carried as an item rather than bought on the spot. upgrades.enabled (and the per-axis switches) govern tickets exactly as they govern the menu.

Wands

A wand does to several spawners at once what the spawner menu does to one: right-click a spawner with a sell wand to sell every reachable spawner’s store, or an experience wand to collect every reachable spawner’s banked experience.

• radius — blocks around the clicked spawner also reached, up to wands.largest-radius (config default 8). 0 means only the spawner clicked.
• uses — spent once per click, not once per spawner reached. -1 is unlimited. The count is stored in the wand item itself, so giving the wand away carries however many uses are left on it, and it stops working — removed from the player’s hand — the moment its last use is spent.

A wand only reaches a spawner if the land it stands on allows the player to interact there — it cannot be used to empty stores inside a claim by standing just outside it.