Aspect Alchemy

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 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.

1. Place the Aspect Cauldron over a heat source.
2. Fill it with water (spawns with 1 level by default).
3. Add up to 3 unique ingredients (right-click or Q-throw).
4. Wait for it to boil — watch the water change color.
5. 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)

⭐ = Rare ingredient with a doubled aspect — guaranteed to appear in the potion even without a second matching ingredient.

• 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.

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 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.

1. Place the Aspect Cauldron over a heat source.
2. Fill it with water (spawns with 1 level by default).
3. Add up to 3 unique ingredients (right-click or Q-throw).
4. Wait for it to boil — watch the water change color.
5. 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)

• 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.