Aspect Alchemy Sub logo

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.

banner2

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 boiling state, 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>

Planned features

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.