rAlchemist

How it works

1. A player opens the menu with /alchemist.
2. The player puts in 2 to 15 positive potions of one kind: regular, splash or lingering.
3. The player sees the result, the price and the failure chance before paying.
4. The player clicks the mix button and takes the potion.

Features

• Up to 15 potions mixed into one with all their effects.
• Preview of the potion, price and failure chance before paying.
• Price: a base, a fee per potion and a fee per effect. The default is 3000 plus 250 per effect.
• Payment through Vault, BVault, CoinsEngine or PlayerPoints, several currencies for one mix.
• Failure chance of 5% per effect, capped at 50%. The potions burn or turn into a spoiled potion.
• 5 alchemist levels: slots from 5 to 15, up to 20% discount, 25% off the failure chance.
• 5 anvil essences: time, power, stealth, mystery, eternity.
• A ban on identical effects and groups of incompatible effects.
• A cooldown and a daily limit, separate values for permission groups.
• A discount from the permission ralchemist.discount.20.
• 11 potion colors in the palette and a custom #RRGGBB color.
• A fully configurable menu: size, slots, buttons, texts.
• MiniMessage, SQLite or MySQL, Folia support.

Essences

A player applies an essence to a potion in an anvil for experience levels. One essence goes into one potion. Crafting tables, furnaces and brewing stands do not consume essences.

Essence	What it does	Anvil cost
Time	Extends effects up to 5 minutes	1 level
Power	Raises effect level by 1, up to II	3 levels
Stealth	Removes the particles of an invisibility potion	3 levels
Mystery	Disguises the potion as a water bottle and hides its effects until someone drinks it	1 level
Eternity	Positive effects last until death or milk	30 levels

You change the material, name, CustomModelData, cost and strength of every essence in items.yml.

Requirements

Server	Java	Economy	Storage
Paper 1.21.4+ or Folia	21	Vault, BVault, CoinsEngine or PlayerPoints	SQLite with no setup, or MySQL

Commands

Command	What it does	Permission
/alchemist	Opens the alchemist menu	ralchemist.use
/alchemist #RRGGBB	Sets a custom potion color	ralchemist.use
/alchemist give <player> <type> [amount]	Gives an essence: time, power, stealth, mystery, eternity	ralchemist.admin
/alchemist points add <player> <amount> [points or levels]	Adds alchemist points or levels	ralchemist.admin
/alchemist points set <player> <amount> [points or levels]	Sets alchemist points or level	ralchemist.admin
/alchemist points query <player> [points or levels]	Shows a player's points or level	ralchemist.admin
/alchemist reload	Reloads the configs	ralchemist.admin
/alchemist help	Shows the command list	ralchemist.admin

Alias: /alchemy. You change the command name and aliases in config.yml.

Permissions

Permission	What it gives	Default
ralchemist.use	Access to the menu	Everyone
ralchemist.admin	Admin commands	Operators
ralchemist.bypass.cooldown	Mixing with no cooldown	Operators
ralchemist.bypass.limit	Mixing with no daily limit	Operators
ralchemist.discount.<number>	A discount in percent, adds to the level discount	Nobody
ralchemist.limits.<name>	Limits of a group from mixing.yml	Nobody

Good to know

• Only positive potions go into a mix. This rule has no switch.
• The plugin sends anonymous usage statistics to bStats. Set metrics: false in config.yml to turn it off.
• The plugin checks for a new version and reports it in the console. Set update-check: false in config.yml to turn it off.

config.yml

settings:
  debug: false # detailed console messages for troubleshooting
  metrics: true # anonymous bStats statistics
  update-check: true # console message about a new plugin version

command:
  main: alchemist # main command name
  aliases: [ alchemy ] # extra command names

# Mixing price.
# Every "- provider" block adds one more currency. The player pays all of them at once.
# Total: (base + per-potion x potions + per-effect x effects) minus the player's discount.
price:
  costs:
    - provider: VAULT # economy plugin: VAULT, BVAULT, COINSENGINE, PLAYERPOINTS
      currency: money # COINSENGINE: currency ID. BVAULT: account name. VAULT and PLAYERPOINTS ignore this field
      base: 3000 # base price of a mix
      per-potion: 0 # fee for every potion in the slots
      per-effect: 250 # fee for every effect in the result

# Menu sounds. An empty key turns the sound off.
sounds:
  click: # button click
    key: "minecraft:ui.button.click" # sound ID
    volume: 0.5 # volume from 0.0 to 1.0
    pitch: 1.0 # pitch from 0.5 to 2.0
  mix-success: # successful mix
    key: "minecraft:block.brewing_stand.brew"
    volume: 1.0
    pitch: 1.0
  mix-fail: # failure or error
    key: "minecraft:block.note_block.bass"
    volume: 1.0
    pitch: 1.0

config-version: 2 # internal field, leave it as is

mixing.yml

min-potions: 2 # minimum potions for a mix
allow-crossed: false # true: a mixed potion goes into a new mix
allow-duplicates: false # true: potions with the same effect are allowed
combine-essences: false # true: essences work on mixed potions, and potions with an essence go into a mix

# Effects from one group never end up in one potion.
# Names as in the /effect command. A group needs at least two effects.
incompatible:
  - [strength, resistance]
  - [regeneration, instant_health]

# Failure chance in percent:
# base-chance + chance-per-effect x number of effects, minus the level bonus, capped at max-chance.
failure:
  mode: SPOIL # BURN: the potions burn. SPOIL: the player gets the spoiled potion from items.yml
  base-chance: 0 # failure chance before effects are counted
  chance-per-effect: 5 # added for every effect
  max-chance: 50 # chance cap

limits:
  cooldown-seconds: 0 # cooldown between mixes, 0 turns it off
  daily-mixes: 0 # mixes per day, 0 turns the limit off
  # Separate limits with the permission ralchemist.limits.<name>.
  # With several permissions the player gets the shortest cooldown and the highest limit.
  groups:
    vip: # permission ralchemist.limits.vip
      cooldown-seconds: 0
      daily-mixes: 0

config-version: 1 # internal field, leave it as is

levels.yml

points-per-mix: 10 # points for one successful mix

# Level list. The section key is the level number. Add and remove levels freely.
list:
  1:
    points: 0 # points required for the level
    slots: 5 # unlocked potion slots
    discount: 0 # mixing discount in percent
    fail-reduction: 0 # percent taken off the failure chance
  2:
    points: 50
    slots: 8
    discount: 5
    fail-reduction: 5
  3:
    points: 150
    slots: 10
    discount: 10
    fail-reduction: 10
  4:
    points: 400
    slots: 12
    discount: 15
    fail-reduction: 15
  5:
    points: 1000
    slots: 15
    discount: 20
    fail-reduction: 25

config-version: 1 # internal field, leave it as is

items.yml

# The potion a player gets after a mix.
crossed-potion:
  model-data: 0 # CustomModelData for a resource pack
  name: "<white>Mixed potion" # name, MiniMessage format
  lore: [] # lines under the name

# The potion a player gets on failure in SPOIL mode.
spoiled-potion:
  model-data: 0
  name: "<white>Spoiled potion"
  lore:
    - " <white>Something went wrong..."
  effects: # format: effect:level:seconds
    - poison:1:15
    - nausea:1:10

# Time essence.
essence:
  material: AMETHYST_SHARD # essence item
  glow: false # enchantment glint
  model-data: 0 # CustomModelData for a resource pack
  duration-minutes: 5 # extends effects up to this many minutes, 1440 at most
  level-cost: 1 # anvil cost in experience levels, from 1 to 39
  name: "<white>Time essence"
  lore: # {minutes} inserts duration-minutes
    - " <white>Effect time: up to <#7FC4B8>{minutes} min."

# Power essence.
power-essence:
  material: BLAZE_POWDER
  glow: true
  model-data: 0
  max-level: 2 # effect level cap
  ignored-effects: [night_vision, invisibility, fire_resistance, water_breathing, slow_falling, glowing] # these effects are never raised
  level-cost: 3
  name: "<white>Power essence"
  lore: # {max} inserts max-level
    - " <white>Maximum level: <#D9A26B>{max}"

# Stealth essence: removes effect particles.
stealth-essence:
  material: PHANTOM_MEMBRANE
  glow: true
  model-data: 0
  required-effects: [invisibility] # potions it works on. Empty list []: any potion
  level-cost: 3
  name: "<white>Stealth essence"

# Mystery essence: disguises a potion as a water bottle.
mystery-essence:
  material: INK_SAC
  glow: true
  model-data: 0
  level-cost: 1
  name: "<white>Mystery essence"

# Eternity essence: positive effects last until death or milk.
eternity-essence:
  material: NETHER_STAR
  glow: true
  model-data: 0
  level-cost: 30
  name: "<white>Eternity essence"

config-version: 1 # internal field, leave it as is

database.yml

storage: sqlite # where player points, levels and color are stored: sqlite or mysql

# Read only with storage: mysql
mysql:
  host: localhost # database server address
  port: 3306
  database: ralchemist # database name
  user: "root"
  password: ""

config-version: 1 # internal field, leave it as is