Multipliers

Multipliers

The Multipliers module lets you boost how much currency players earn when mining. Boosts from all three layers are multiplied together — not added — so a small rank bonus stacks powerfully on top of a global event.

final amount = base × global × player × rank

---

Three Types of Multipliers

Global Multiplier

A server-wide boost that applies to every player at once. Use it for events ("double-token weekend"). Set it with a duration; it expires automatically and survives restarts.

Attribute	Notes
Scope	All online players
Persistence	Saved to database
Duration	Timed (expires)
Capped by	global-max in multipliers.yml

Player Multiplier

A personal boost for one specific player. The player must be online to receive it.

Attribute	Notes
Scope	Single player
Persistence	Saved to database
Duration	Timed (expires)
Capped by	player-max in multipliers.yml

Rank Multiplier

A passive, permanent bonus granted by permission or LuckPerms group. It is never stored in the database — it is re-calculated from the player's permissions each time they join and then refreshed on a configurable interval. Rank multipliers never expire.

Attribute	Notes
Scope	Single player
Persistence	Permission-based (no DB)
Duration	Permanent while rank is held
Capped by	Not capped

---

How Stacking Works

All active layers are multiplied together at the moment a player earns currency. An inactive layer (expired or not configured) contributes 1.0 and is effectively ignored.

Example — a player with all three layers active:

Layer	Multiplier	Running total
Base amount mined	—	100
× Global	2.0	200
× Player	1.5	300
× Rank	1.25	375

The same player without a player multiplier active: 100 × 2.0 × 1.0 × 1.25 = 250.

---

Commands

Requires permission: xprison.multipliers.admin

Global multiplier

/gmulti <currency> <multiplier> <duration> <unit>
/gmulti <currency> reset

Argument	Description
currency	Internal currency name (e.g. tokens, gems)
multiplier	Multiplier value (e.g. 2.0)
duration	How long the multiplier lasts
unit	SECONDS MINUTES HOURS DAYS

Examples:

/gmulti tokens 2.0 2 HOURS      # 2× tokens for 2 hours (server-wide)
/gmulti gems 1.5 30 MINUTES     # 1.5× gems for 30 minutes
/gmulti tokens reset             # remove the tokens global multiplier

Player multiplier

/pmulti <player> <currency> <multiplier> <duration> <unit>
/pmulti <player> <currency> reset

Examples:

/pmulti Steve tokens 3.0 1 HOURS    # give Steve a 3× token boost for 1 hour
/pmulti Steve gems reset             # remove Steve's gems multiplier

The player must be online when the command is run.

---

Setting Up Rank Multipliers

Rank multipliers are defined in multipliers.yml under rank-multipliers. Each key is either a LuckPerms group name or an X-Prison permission suffix depending on use-luckperms-groups.

With LuckPerms (recommended)

Set use-luckperms-groups: true and use your LuckPerms group names as keys:

use-luckperms-groups: true

rank-multipliers:
  default:
    tokens: 1.0
  vip:
    tokens: 1.25
    gems: 1.25
  vip_plus:
    tokens: 1.5
    gems: 1.5
  legend:
    tokens: 2.0
    gems: 2.0
    money: 1.5

Players in the legend LuckPerms group automatically receive a permanent 2× token, 2× gem, and 1.5× money bonus.

With X-Prison permissions

Set use-luckperms-groups: false. Each key maps to the permission xprison.multiplier.<key>:

use-luckperms-groups: false

rank-multipliers:
  vip:
    tokens: 1.5

Grant xprison.multiplier.vip through your permissions plugin to activate that rank's bonus.

Which rank wins?

If a player matches multiple rank keys, the last matching key in the config wins (keys are checked top-to-bottom, and the last match overrides earlier ones). Order your ranks from weakest to strongest in the config.

---

Permissions

Permission	Description
xprison.multipliers.admin	Run /gmulti and /pmulti
xprison.multiplier.<key>	Passive rank multiplier (when use-luckperms-groups: false)

---

Configuration Tips

Caps — prevent admins or commands from setting unreasonably high values. Set global-max and player-max per currency in multipliers.yml. These caps do not apply to rank multipliers.

Refresh interval — online players' rank multipliers are re-evaluated every rank-multiplier-update-time seconds (default 60). Lower this if players change ranks often and need instant updates; raise it on large servers to reduce permission-check overhead.

---

Related Pages

• multipliers.yml — Default Config
• Commands & Permissions
• Developer API