Content generated with AI — it may contain mistakes.

ExyliaSurvivalCore/GuidesUpdated in v1.2.2

Run boosters

Money, experience and drops boosters for one player or everybody, with presets, stacking and an admin screen. Currencies, shops and markets live in ExyliaEconomy and ExyliaMarket.

Page 10 of 385 min read
Currencies moved to ExyliaEconomy

ExyliaSurvivalCore no longer keeps currencies, balances, the ledger or /balance, /pay, /baltop and /wallet. They belong to ExyliaEconomy. The shop, markets, trading and sell wands belong to ExyliaMarket. The only economy feature left here is boosters. How ExyliaLib handles money in every Exylia plugin is on ExyliaLib economy.

Boosters#

A booster multiplies money, experience or drops for one player or for everybody, for a time. The module is boosters in config.yml. Multipliers are worked out through ExyliaLib's modifier pipeline, so other Exylia plugins list their own payouts and honour the same boosters.

TypeMultiplies
moneyMoney paid in the default currency
xpExperience
dropsItems

Sources#

A booster names the payout it applies to, or * for all of them.

SourceWhat it multiplies
minesA mine's blocks: loot tables, vanilla drops and their experience
blocksNatural blocks outside mines, as listed under drops.blocks
cropsGrown crops outside mines, as listed under drops.crops
mob-dropsWhat a vanilla mob drops when a player kills it
orbsExperience orbs picked up
shop-sellSelling to the shop, by /sell, a sell wand or autosell
worth-sellSelling what worth.yml prices, the same three ways
farmingThe money of the farming categories

The reward lists of missions, votes, referrals, projects, playtime-rewards, afk-zones, duel-rooms, power-ups, rewards, crates, seasons and mobs are boosted too (a custom mob may name its own source in /mobsadmin). In a reward list a money booster multiplies the money, an experience booster the experience and a drops booster the items; commands are never multiplied. Several of those payouts now come from ExyliaRewards and the other plugins that took those modules over.

Money counts in the default currency only. Refunds and transfers are never boosted. A multiplier that is not whole rounds each drop at random, so x1.5 on one item gives two half of the time and the average is exact. The source is free text: one that nothing pays under multiplies nothing.

Personal and global#

Given withStarts
Personal/boostersadmin give <player> <money|xp|drops> <multiplier> <duration> [source]When the player clicks it in /boosters
Global/boostersadmin global <money|xp|drops> <multiplier> <duration> [source]At once, on every server

A personal booster waits in /boosters until its owner starts it, so it can be given to somebody who is offline or on another server, which is what a web store needs. The player is told when one arrives. A global booster is announced on every server when it starts and when it ends. /boostersadmin clear (with confirm) ends every running global booster without announcing it.

The multiplier must be above 1 and at most 100. The duration is 30m, 2h, 1d; a bare number is seconds. No source means *.

Presets#

A preset is a booster ready to hand out: a name, an icon, a type, a source, a multiplier and a duration. Giving one copies it, so editing or deleting a preset never changes a booster already given.

CommandWhat it does
/boostersadmin preset give <player> <preset>Gives a player a personal booster from a preset
/boostersadmin preset global <preset>Starts the preset for everybody on the network

Both work from the console, so a store can use them. Presets, and every setting below, are built from the admin screen: /boostersadmin with no arguments opens it (presets, running boosters and settings).

Stacking#

Every running booster of a type that applies to a payout counts, the player's own and the global ones together. modules/boosters/config.yml:

yaml
settings:
  stacking: ADD
  max-multiplier: 5.0
  one-per-type: true
drops:
  excluded-from-all: [crates]
  blocks: ['*_ORE', ANCIENT_DEBRIS, '*_LOG', ...]
  crops: [WHEAT, CARROTS, POTATOES, ...]
stackingx2 and x1.5 make
ADDx2.5
MULTIPLYx3
HIGHESTx2

The result is never below x1, and never above max-multiplier; 0 removes the cap. one-per-type (default true) stops a player running a second personal booster of a type; global boosters do not count against it.

drops.excluded-from-all lists sources a drops booster for * leaves alone (default crates): only a booster naming them multiplies them. drops.blocks is what the blocks source multiplies (* matches any part of a name, so *_ORE is every ore) and drops.crops what crops multiplies; seeded crops count only fully grown and a block a player placed never counts, so placing and breaking multiplies nothing.

Boss bar#

A boss bar shows while any booster applies to the player, filling with the time left on the one that ends last. Its text and style are the bossbar block of modules/boosters/messages.yml; %money%, %xp%, %drops%, %left% and %count% work in the text, and an empty text hides it.

Check that it works#

Run /boostersadmin give <you> money 2 10m, open /boosters and click the booster to start it. The boss bar shows x2 and %exyliasurvivalcore_boosters_money% reads 2. Sell something to the shop to see the payout double.

Commands, permissions and placeholders#

/boosters lists the global boosters running, then the player's own, running first, then waiting. Its screens are in modules/boosters/menus/. Players need exyliasurvivalcore.boosters; admins need exyliasurvivalcore.boosters.admin.

CommandWhat it doesPermission
/boostersOpens your boostersexyliasurvivalcore.boosters
/boostersadminOpens the boosters admin menuexyliasurvivalcore.boosters.admin
/boostersadmin give <player> <MONEY|XP|DROPS> <multiplier> <duration> [source]Gives a player a boosterexyliasurvivalcore.boosters.admin
/boostersadmin global <type> <multiplier> <duration> [source]Starts a booster for everybodyexyliasurvivalcore.boosters.admin
/boostersadmin preset give <player> <preset>Gives a player a configured presetexyliasurvivalcore.boosters.admin
/boostersadmin preset global <preset>Starts a configured preset for everybodyexyliasurvivalcore.boosters.admin
/boostersadmin clear [confirm]Ends every boosterexyliasurvivalcore.boosters.admin
PlaceholderShowsExample
%exyliasurvivalcore_boosters_money%The reader's money multiplier, their own boosters and the global ones together — `1`, `1.5`, `2.25`1.5
%exyliasurvivalcore_boosters_xp%The same for experience1
%exyliasurvivalcore_boosters_drops%The same for drops—
%exyliasurvivalcore_boosters_active%The reader's boosters running right now1
%exyliasurvivalcore_boosters_stored%The reader's boosters kept but not started yet2
%exyliasurvivalcore_boosters_global_money%The money multiplier of the global boosters alone—
%exyliasurvivalcore_boosters_global_xp%The same for experience—
%exyliasurvivalcore_boosters_global_drops%The same for drops—
%exyliasurvivalcore_boosters_global_left%Time left on the first running global booster, or `—`1h 5m 3s

Where the rest went#

  • Currencies, the Vault bridge, balances, the ledger, /balance, /pay, /baltop, /wallet: ExyliaEconomy.
  • The shop, the market, auctions, orders, trading, sell wands and autosell: ExyliaMarket.

Something missing on this page? Tell us on Discord