Back to mods
Alchemy project artwork

Vintage Story Mod DB · Vintage Story mod

Alchemy

Brew a range of player-enhancing potions, then drink them, throw them at your friends/foes, or coat your weapons with them. Most recipes use flowers and herbs gathered from the world, ground down with a mortar & pestle and distilled into potion bases. Potions

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Alchemy release should I use?

Updated 2 days ago
Latest stable file 2.1.16
Game version 1.22.0, 1.22.1, 1.22.2
Loader Built-in Vintage Story mod system

Alchemy 2.1.16 targets 1.22.0, 1.22.1, 1.22.2. It must be installed on the client. Installation on the dedicated server is optional. No extra mods listed for this file.

Where it goes

Is Alchemy required on the client, server, or both?

It must be installed on the client. Installation on the dedicated server is optional.

Client Required
Dedicated server Optional
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This release supports both sides, but the source does not require it on the server.

What else does Alchemy 2.1.16 need?

2.1.16. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Alchemy without breaking your instance.

Built for Alchemy 2.1.16. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 2.1.16. It targets 1.22.0, 1.22.1, 1.22.2; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    It must be installed on the client. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 2.1.16. It opens that exact file at the source.

About this project

What does Alchemy add?

Brew a range of player-enhancing potions, then drink them, throw them at your friends/foes, or coat your weapons with them. Most recipes use flowers and herbs gathered from the world, ground down with a mortar & pestle and distilled into potion bases.

Potions

Potions come in weak, medium and strong tiers. The current line-up:

  • Archer's Flask: better ranged accuracy, damage and draw/load speed
  • Fighter's Flask: more melee damage
  • Hunter's Delight: more animal loot and faster harvesting, plus more forage and wild crops, and a wider animal seek range
  • Looter's Delight: more gears from metal piles, more contents from broken storage vessels, and extra forage and wild crops
  • Miner's Flask: faster mining on stone and ores, plus more ore from mined blocks
  • Sprinter's Flask: faster walk speed
  • Vitality Flask: raises your maximum health for the duration
  • Healing Oil: restores health over time
  • Potent Oil: increases healing effectiveness
  • Spiked Oil: poison that damages over time
  • Predator Pheromones: widens your animal seek range, drawing creatures toward you
  • Scent Mask: shrinks your animal seek range, hiding you from creatures
  • Purging Brew: increases hunger rate
  • Settling Brew: lowers hunger rate

Most potions come in three strengths - a higher strength increases the size of the effect, not how long it lasts.

Utility flasks:

  • Recall Flask: teleport back to your spawn/return point
  • Glow Flask: emit a bright glow
  • Water Breathing Flask: breathe underwater
  • Warmth Flask: keeps your body temperature from falling below normal
  • Stability Flask: a one-time boost to temporal stability
  • Nutrition Flask: evens out nutrition across food groups (usually at a small overall cost)
  • Featherfall Flask: reduced fall damage
  • Spider Flask: climb any surface
  • Growth Flask / Shrinking Flask: grow or shrink your size until death/disconnect
  • Reshape Flask: reopen character creation once via the .charsel command
  • Flight Flask: lets you fly for the duration (creative only)

 Utility flasks come in a single strength and last for the duration shown on the flask.

Making potions

Alchemy is split into three tiers, each needing progressively more advanced equipment. Every recipe is in the in-game handbook (search "potion"), but in short:

  • Tier 1 - Edible Herbs: the earliest form, needing only a mortar & pestle. Grind mushrooms and horsetail into a basic potion base, grind herbs/flowers into a weak base, then combine them into an edible herb ball you eat directly for a weak effect.
  • Tier 2 - Medium Potions: liquid brews made in a brewing cauldron (copper age). Seal a basic potion base with water in a barrel to make potion tea, then brew a weak base + potion tea in the cauldron with a wooden stirring spoon, and bottle the result into flasks.
  • Tier 3 - Strong Potions: the most powerful brews, adding glassworking and aqua vitae. Dry herb cuttings on a herb rack, cook them, craft a strong base, then brew it with aqua vitae and potion tea using a glass stirring spoon.

Brewing cauldrons are dedicated to brewing potions in larger batches then cooking pots (not for cooking meals) and come in many metal variants. Place one, build the firepit under it with dry grass and firewood, attach the right stirring spoon, add the ingredients, and light the fire beneath it to cook the brew.

Ways to use potions

  • Drink them for a personal buff. A progress bar shows while consuming, and healing effectiveness can optionally affect drink speed.
  • Coat your weapons - apply suitable potions (such as Spiked Oil) directly onto melee weapons to pass the effect on to whatever you hit.
  • Throw them - throwable flasks (both glass and ceramic variants) shatter on impact and apply their potion to every creature in the splash radius.

In-game guide

The handbook now contains a full set of alchemy guides - covering how to make potions, the herb/potion tiers, weapon coating, throwable flasks, and a Potion Effects Glossary that explains the underlying stats. Search for "potion" in the handbook to find all recipes and guides.

Configuration

The mod is highly configurable - there are hundreds of config values to adjust. If you want to change anything, I highly recommend installing ConfigLib, which gives you an in-game settings menu instead of editing files by hand.

Among many other things you can:

  • Enable or disable individual potions entirely.
  • Tune each potion's effect strength, duration and per-tier scaling.
  • Adjust drink/eat/coating times, and whether healing effectiveness affects them.
  • Configure side effects (health, intoxication, psychedelic and saturation changes on drink).
  • Toggle and tune weapon coating - which potions are allowed, max charges, coating strength, and which items can be coated
  • Tune throwable flasks - splash radius and applied strength.

Notes

  • Balancing is an ongoing effort - suggestions are very welcome.
  • The Miner's Flask only speeds up mining on stone and ores.
  • The Potent Flask increases healing effectiveness which now only makes bandages quicker to apply (and potions to drink/eat with the config turned on)
  • Poison and healing effects are applied over time.
  • Potion effects are cleared on death or when restarting the game.
  • You need a potion base to make edible herbs/potions. You will need a potion flask to drink them (Can be changed in the config).
  • You can't drink a potion while you already have that potion's effect active (Can be changed in the config).

Compatibility

Migration & version warnings

New installs can ignore this section - it only matters when updating an existing save.

Updating to 2.1.0 or higher: existing potion liquids and potion tea liquid will shrink. To fix this run /alchemymigrate in chat if you are a server admin or playing singleplayer. This multiplies all alchemy liquids by 25 across every loaded chunk and online players' inventories. Back up your save first. You can also migrate a specific player by adding their name, e.g. /alchemymigrate player Llama3013.

To-do list

This is a simple to do list. I might complete things randomly and motivation for development of this mod ebbs and flows. Feel free to comment suggestions.

  • Add a Stoneskin potion (or equivalent).
  • Make custom potions easier to define (still fairly hardcoded with the new config).
  • Knapping system for turning flowers into cuttings.
  • More flower compatibility with mods that add extra flowers (low priority - tedious).
  • Glassmaking compatibility for crafting flasks.
  • Ancient Tools compatibility for mortar & pestle crafting.
  • Rework recipes to make a bit of loose real-world sense.
  • Create flower/mushroom scythe tool the sickle (I did a discord poll but players were split on adding this)
  • Add an option to have perish times to potions (I did a discord poll but players were split on adding this)

Credits

  • Rejn_Bashag: potion flask, herb rack and mortar & pestle shapes, improved potion names, and cover art.
  • Brun: chamomile shape and texture plus small cuttings tweaks. Check out their mod Soap and Lye: Bloom and Lather, which also has alchemy compatibility.

 

Translations:

  • Russian - ChimMAG (newest), Dr_Oldman (older, x2)
  • Spanish - JefferZ
  • Spanish (Latin America) - tomandoawa
  • Ukrainian - JustOmi
  • Polish - FlayedCrusader
  • German - Chrizzlybear
  • French - Victor Ros
  • Czech - DejVIIK (latest), DejFidOFF (older)
  • Simplified Chinese - Aimli_ (newest, x3), MoonWalker1997 (older)
  • Korean - purple8cloud

 

Old description

This mod adds some potions that enhance the player. Currently these are: Archer's Flask, Fighter's Flask, Healing Oil, Hunter's Delight, Looter's Delight, Miner's Flask, Potent Oil, Purging Brew, Predator Pheromones, Scent Mask, Settling Brew, Spiked Oil, Sprinter's Flask, Vitality Flask, Recall Flask, Glow Flask & Water Breathing Flask.

Warning if you update to 2.1.0-rc.50 or higher existing potion liquids and potion tea liquid will shrink. If you still want to update then install 2.1.0-rc.53 or higher and then run the migration command of /alchemymigrate in chat. This will multiply all alchemy liquids by 25 on every currently loaded chunk and online players inventories. It's recommended to backup your save just in case. You can also perform the migration for specific players by adding their names on the migration such as /alchemymigrate Llama3013

 

Version 1.5.0 changes the potion to a liquid so all potions previously created will not port over but empty potion flasks will.

Version 1.6.4 trims the herb rack variants so all herb racks previously created will not port over. (Sorry for the inconvenience)

Some notes:

  • This mod is currently balanced slightly better than before but some of it may still be overpowered. Balancing suggestions are very much welcome.
  • Mining potion increases mining speed only on stone and ores.
  • Poison and Regen potion poison/heal you over time.
  • Potion effects disapear after dying or restarting your game.
  • Potion bases and potion flasks are required to make/drink potions.
  • The ingredients to make potions bases other than the basic one are currently just different combinations of flowers with a mortar & pestle.
  • All the recipes should be in the handbook. (search for "potion").
  • Wild Farming mod is recommended if you want a renewable source of flowers.
  • There is a wildcraft patch done by another modder if you have wildcraft herbs and spices. (I have not tested this)
  • Should be compatible with most mods.
  • If you want a more immersive distilling crafting you can try out Alchemistry (Outdated: last working VS version was 1.19.8). Warning using Alchemistry mod overwrites the original crafting of potions so you will have to follow the alchemistry's crafting recipes for potions if installed.
  • You cannot drink the same potion when you already have the potion's effects active.
  • At the time of writing 05/12/2023 Simple alchemy mod is incompatible with this mod.
  • Haven't tried this mod out yet but if you want flasks placed in a bookshelf tryout https://mods.vintagestory.at/shelfobsessed

 

To do list:

  • Allow poison potion to be applied to weapons and arrows/bolts. Hopefully can piggy back off the sharpening system from 1.22
  • Create some stoneskin potion or equivalent.
  • Allow for custom potions its sorta hardcoded a bit more with the new config
  • Knapping system for turning flowers into cuttings.
  • Allow potions to be drunk through any container.
  • Add more flower compatability with mods that add extra flowers. Low priority as its tedious
  • Add glassmaking compatability to create flasks
  • Add ancient tools compatability to allow mortar & pestle crafting
  • Change recipes to make some sort of loose real life sense

This is a simple to do list. I might complete things randomly and motivation for development of this mod ebbs and flows. Feel free to comment suggestions.

 

Big thanks to Rejn_Bashag for making the new potion flasks, herb racks and mortar & pestle shape, creating better names for potions and cover art.

Thanks to Brun for chamomile shape and texture plus some small cuttings tweaks. If you want to thank them try out their own mod Soap and Lye: Bloom and Lather. It also has alchemy compatability.

Thanks to ChimMAG for newest Russian translation and Dr_Oldman for older Russian translation (x2).

Thanks to JefferZ for Spanish translation.

Thanks to JustOmi for Ukranian translation.

Thanks to FlayedCrusader for Polish translation.

Thanks to Chrizzlybear for German translation.

Thanks to tomandoawa for Spanish - Latin America translation.

Thanks to Victor Ros for French translation.

Thanks to DejVIIK for latest translation and DejFidOFF for older translation for Czech translation.

Thanks to Aimli_ for newest Simplified Chinese translation (x2) and MoonWalker1997 for older Simplified Chinese translation

Thanks to purple8cloud for Korean translation

 

 

Any questions, bug reports or suggestions go to vintage story discord and send a message on the alchemy post. You can still use github, comments below or forum but I will be more likely to see it on discord.

Link to the discord server invite

Project description from Vintage Story Mod DB.

Pick your setup

Alchemy releases for each Vintage Story version.

Choose the version and loader you play, then open the matching release.

114 available setups

Showing the newest 12 of 114 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Alchemy versions and loaders

168 of 168 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.