Aspect Alchemy
Video_2026-04-27_20-15-09(1).gif
e956ea8a07ba76cebb1cbe89b0e1c23e29c43b96_0.webp
recipe_cauldron.png
recipe_bottle_lvl2.png
recipe.png
Description
Aspect Alchemy adds a deep, customizable potion-making system using a special Aspect Cauldron. Combine ingredients based on their hidden "aspects" (status effects) to create powerful elixirs — then collect them in bottles of different sizes, infuse arrows, or just bathe in the brew directly.
Every ingredient has hidden aspects which can be discovered through experimentation.
Blocks
- Aspect Cauldron — the main block of the mod. Holds up to 3 water levels (just like vanilla), tracks a
boilingstate, and stores up to 3 ingredients. Breaking it drops an empty cauldron. - Aspect Empty Cauldron — the base form; fill it with water to get started.
Heating & Boiling
Place the cauldron over a Campfire, Fire, Soul Fire, Lava, or Magma Block to heat it up. Heating takes 10 seconds (200 ticks). Remove the heat source and the cauldron cools down instantly.
- While boiling, the cauldron emits bubble particles and plays ambient lava sounds.
- ⚠️ Entities standing inside a boiling cauldron take 1 damage per second unless fire-immune.
Adding Ingredients
Add up to 3 unique ingredients by right-clicking with them in hand or throwing them in with Q. Duplicate ingredient types are not accepted.
Each ingredient carries a list of status effects (its aspects). The system works like this:
- An effect must appear across 2 or more ingredients to be included in the final potion.
- Amplifier = number of occurrences minus 1, capped at level V.
Living Water Visuals
- Water color dynamically changes based on added ingredients — it shows the average blend of all active effects' colors.
- Empty cauldron resets to classic vanilla blue.
- Visual feedback lets you see the brew's composition at a glance.
Stand inside a cauldron with a brewed potion to absorb its effects — 1 second of exposure = 3 seconds of effects, refreshed every tick. Great for a quick heal before exploration or combat without consuming a bottle.
- Fire on the entity is extinguished while standing inside.
- ⚠️ Instant Damage in the brew deals extraordinary damage.
Bottle Sizes & Multi-Use Bottles
Each scoop of the cauldron lowers the water level by 1. At level 1, the cauldron empties and reverts to its empty form.
Vanilla Bottle: 1 sip
Small Bottle: 2 sips
Medium Bottle: 3 sips
Large Bottle: 4 sips
Multi-use bottles (MultiUsePotionItem) can be refilled from the cauldron — as long as the effects in the bottle match those in the cauldron and the bottle isn't already full.
Dynamic Potion Names & Colors
Potions get a dynamically generated name based on their strongest effect: [Prefix] [Effect] [Roman Numeral]
- Prefix depends on whether the dominant effect is beneficial or harmful.
- Color = average of all active effects' colors.
- Potion names appear in blue; arrow names appear in red.
Tipping Arrows
One water level = 32 tipped arrows. Infuse them by:
- Right-clicking with regular arrows in hand, or
- Throwing them into a boiling cauldron with Q
Arrows inherit the cauldron's effects, dynamic name (red text), and custom color. Usage count is stored in NBT.
- Place the Aspect Cauldron over a heat source.
- Fill it with water (spawns with 1 level by default).
- Add up to 3 unique ingredients (right-click or Q-throw).
- Wait for it to boil — watch the water change color.
- Scoop your potion with any bottle size, tip arrows, or jump in to bathe.
Effects must appear in at least 2 ingredients to make it into the final potion. Plan your combinations wisely.
Item Aspect Reference (Spoiler Warning)
<details> <summary>Spoiler</summary>
| Ingredient | Aspects (Status Effects) |
|---|---|
| Rabbit's Foot | Speed, Jump Boost, Mining Fatigue, Luck |
| Phantom Membrane | Speed, Slow Falling, Levitation |
| Sugar | Speed, Absorption, Saturation |
| Blaze Powder | Speed, Strength, Fire Resistance, Glowing |
| Sweet Berries | Speed, Hunger, Instant Damage |
| Feather | Slow Falling, Speed, Weakness |
| Ender Pearl | Speed, Levitation, Weakness |
| Redstone | Haste, Strength, Night Vision, Instant Damage |
| Gunpowder | Haste, Strength, Hunger, Glowing, Instant Damage |
| Lapis Lazuli | Haste, Water Breathing, Hunger, Luck |
| Quartz | Haste, Glowing, Weakness |
| Fermented Spider Eye | Jump Boost, Blindness, Nausea, Poison, Weakness |
| Ghast Tear | Regeneration, Fire Resistance, Health Boost, Levitation, Bad Omen |
| Golden Apple | Regeneration, Absorption, Luck |
| Milk Bucket | Saturation, Regeneration, Weakness |
| Honey Bottle | Instant Health, Regeneration, Slowness |
| Turtle Helmet | Resistance, Water Breathing, Slowness, Mining Fatigue |
| Obsidian | Resistance, Slowness, Fire Resistance |
| Diamond | Resistance, Health Boost, Luck |
| Amethyst Shard | Resistance, Night Vision, Luck, Slowness |
| Clay Ball | Slowness, Resistance, Instant Health |
| Bone | Weakness, Resistance |
| String | Slowness, Weakness, Invisibility |
| Glistering Melon Slice | Health Boost, Saturation, Slowness |
| Golden Carrot | Night Vision, Saturation, Slowness |
| Magma Cream | Fire Resistance, Hunger, Instant Damage, Unluck, Slow Falling |
| Nether Brick | Fire Resistance, Strength, Wither |
| Spider Eye | Blindness, Poison, Weakness |
| Pufferfish | Water Breathing, Nausea, Poison, Instant Damage |
| Rotten Flesh | Hunger, Strength, Poison |
| Red Mushroom | Poison, Nausea, Strength |
| Brown Mushroom | Instant Health, Hunger, Weakness |
| Glowstone Dust | Night Vision, Nausea, Glowing, Weakness |
| Dragon's Breath | Absorption, Instant Damage, Levitation, Bad Omen |
| Chorus Fruit | Levitation, Nausea, Invisibility |
| Egg | Levitation, Weakness, Instant Health |
| Nether Wart | Resistance, Fire Resistance, Poison, Unluck, Slowness |
| Coal | Strength, Hunger, Instant Damage |
| Soul Sand | Slowness, Wither, Unluck, Invisibility |
| Honeycomb | Instant Health, Slowness, Absorption |
| Wither Rose ⭐ | Wither ×2, Instant Damage, Strength |
| Torchflower ⭐ | Regeneration ×2, Night Vision, Luck |
| Pitcher Plant ⭐ | Absorption ×2, Slowness, Poison, Water Breathing |
| Echo Shard ⭐ | Strength ×2, Speed, Wither |
⭐ = Rare ingredient with a doubled aspect — guaranteed to appear in the potion even without a second matching ingredient.
</details>
- Alchemy Automation.
- Integration with other mods.
- Different Minecraft versions support.
- Forge support.
- Alembic Addon: Aspect Separation with different Aspect Solubility (Water / Oil / Alcohol).
- Explosive Potion, Burning Potion (usable as fuel), Potion of Experience, Potion of Zombification.
- Boiling, tanning, and infusing leather armor in potions for permanent status effects.
Bug Reporting
Please report issues on our GitHub Issues page with:
- Minecraft and mod versions.
- Mod list (if relevant).
- Steps to reproduce and logs (via Pastebin).
Community and Support
Support: Nothing, at least for now )
License: MIT License. Feel free to use the code in your projects with attribution.
The Aspect Alchemy Team
