Everfilling Flasks

AI usage disclaimer: This mod was developed with AI-agent assistance using this agent workflow. The project owner reviewed the work during development.

Rechargeable healing flasks in the spirit of souls-like games. A flask lives in its own slot,
refills itself over time, and is drunk by holding a key (R by default). Drinking takes time,
slows movement, and a solid hit cancels it. A journal comes with it, opened from the flask
screen.

Like Black Myth: Wukong, flasks are swappable and their properties change with infusions.
Infusions are not consumed. They stay in the flask and keep working, making the drink faster,
the healing larger, the drink harder to interrupt, or leaving an effect behind afterwards.

Flasks are built around Everlasting Seeds, found in dungeon chests, abandoned mineshafts, and
village blacksmiths. The infusions come from the same chests. The Humble Flask leads to the
Sturdy and then the Radiant, each crafted from the one below.

This is a base rather than a big content mod. It ships a few flasks and a few infusions, and an
API for add-ons to bring the variety.

Flask recharge freezes while the Inhibited effect is active. That is in there because I play with
Combat Inhibited myself. What
the mod looks for is the effect rather than that particular mod, so anything providing it works.
It is not required, it is off by default.

Add-ons

Mods that build on Everfilling Flasks:

• Flasks Additions: many new
  flasks, each crafted from the rare items of other mods and each healing in its own way
• Elusive Infusions: infusions
  crafted from Elusive Flora plants, with after-drink effects, flask modifiers with trade-offs,
  and stronger Concentrated versions

For modpack creators

The config file provides options for:

• Changing each flask’s properties: charges, healing, recharge time, drink time, damage
  threshold, and how much infusion potency it holds
• Changing each infusion’s potency cost and its strength
• Removing any of the recipes
• Changing the starting flask, or granting none at all
• Taking the seeds and infusions out of chest loot, which leaves flasks uncraftable unless
  another source provides them
• Dropping flasks on death instead of keeping them
• Changing how much drinking slows movement, or removing the slowdown
• Switching on the Inhibited link
• Replacing or hiding any journal entry’s text, per item, for when a pack moves something
  elsewhere
• A diagnostics log that records every flask decision and its reason, for tracking down reports

For mod developers

Using the API, add-ons can:

• Register their own flasks, infusions and items, which appear in the journal automatically with
  no journal work on the add-on’s side
• Give a flask its own numbers, including how many infusion slots it carries, and its own liquid
  colour, its own HUD icons, or a replacement for the flask HUD entirely
• Alter the properties of any flask a player drinks, for example a bauble that speeds up drinking
  or increases healing
• Run their own effect when a drink completes, and replace the burst and chime that follow it
• Declare a heal that pays out over time, push a flask’s refill forward on their own events,
  read what a drink actually did, and scale a secondary effect through the effect power bonus
• Mark infusions that refuse to share a grid, read the drink outcome from an infusion, and get
  the infusion tooltip written for them in the same style as the built-in ones

Installation

Install on both client and server.

Requires:
Inventory Button Bar, which
adds the inventory button that opens the flask screen, and
Patchouli ROFL Edition,
which draws the journal. If the flask button does not appear in a pack with many bar buttons, move or
resize the bar in Inventory Button Bar’s config.

Source and add-on API: GitHub