Drinking

Gourd bottles allow the player to drink the fluids they contain.

By default, the maximum amount of fluid consumed per drinking is 250 mB which is generally one serving of a bottle.

Milk, honey, and potion fluids are by default configured to be drinkable from gourd bottles. Drinking milk would clear the status effects applied to the player. Drinking honey would restore the same amount of hunger like honey bottles and also clears the poison status effect. Drinking potion fluids would apply the aforementioned potion's effects to the player.

Water can also be drunk from gourd bottles. Drinking water from gourd bottles is equal to drinking vanilla water bottles.

Potion mixtures would apply it's potion effects to the player when drunk. The durations of the potion effects applied are proportional to their molarity inside the mixture. Read the linked article for more info on potion mixing.

Recipes

To make other fluids drinkable, recicropal:drinking recipes could be configured. Their structure can be described as following.

Drinking Recipe
root
• type : recicropal:drinking
• conditions Predicates to achieve conditionally-loaded data.
• fluid A fluid definition to match for drinking.
  • Either a tag or fluid but not both.
    • tag A fluid tag to match.
    • fluid A fluid ID.
  • nbt An optional NBT structured as-is. If this is specified, the recipe would sensitively match for the NBT. If not, the recipe woould ignore the fluid's NBTs.
• amount The amount of fluid to be drunk. If not specified, the recipe would allow drinking the fluid with any number between 0 and the configured drinkingMaxAmount, which is 250 by default.
• results A list of drink_result_types. See below for further info.
  • type The ID of the type.
  • Other arbitrary properties each type may require.

drink_result_types are in-game effects that would trigger when fluids are drunk. Currently, there are 6 drink_result_types available:

• recicropal:finish_item would trigger effects of an item when that item is used.
• recicropal:finish_item_transfer_nbt would trigger effects of an item when that item is used with the NBT from the fluid drunk transferred to the item. Its main use case is for handling potion fluids.
• recicropal:mixture would trigger the effects of potion mixtures when they drunk. It is not meant to be used for other fluids.
• recicropal:heal, recicropal:set_fire, and recicropal:zap trigger what their names suggest and are all meant for debugging purposes only. They may be removed in upcoming updates.