UsefulTankards

Turn tankards into practical adventuring gear. They can store and serve meads, modify drinking movement and animation speed, apply effect bonuses, use durability, and expose server-synced recipe and gameplay settings. ValheimCuisine's Goblet of Kings is supported too.

Drink from a tankard without standing still. Movement and drinking speed are configurable.

Better tankards can extend buff duration and shorten potion cooldowns.

Tankards are not repairable by default, making Dvergr tankards especially valuable. Repairability can be enabled per tankard if your setup provides a valid repair path.

Tankards carry their own mead storage, and their tooltip shows both tankard bonuses and stored meads.

Modded meads can be stored too. ValheimCuisine's Goblet of Kings is detected and configured automatically.

When stored meads are currently usable, a tankard can drink them directly from its storage. Use DataForge if you want to align custom mead effect durations: https://thunderstore.io/c/valheim/p/sighsorry/DataForge/

What It Adds

• Tankards store meads in a small inventory, include that storage in item weight and tooltips, and can drink usable stored meads directly.
• Movement while drinking and drinking animation speed are configurable.
• Pure recovery-over-time effects can get shorter cooldowns; other timed effects can get longer durations.
• Configurable durability and repairability let tankards act as limited-use drinking tools.
• Tankard and Anniversary Tankard recipes are configurable, and ValheimCuisine's Goblet of Kings is supported when installed.
• ServerSync keeps gameplay-affecting settings aligned on dedicated servers.

Tankard Progression

Each supported tankard has its own settings for durability, repairability, potion cooldown reduction, buff duration bonus, and storage slots.

• Tankard: small storage and a modest bonus.
• TankardAnniversary: stronger than the basic tankard.
• Tankard_dvergr: the strongest vanilla tankard profile.
• VC_GoK: supported when ValheimCuisine is installed, using the Dvergr profile defaults.

Storage

Press the interact key while hovering a tankard in your inventory to open its internal storage. Only drinkable consumables with a consume status effect can be placed inside. Stored meads are saved on change, so tooltip contents, dropped tankards, and item weight stay in sync.

When a tankard is used, UsefulTankards checks the stored meads and drinks any that can currently be consumed. Food rules, potion categories, and active status effect categories are respected.

With EpicLoot's socket UI installed, Use opens tankard storage before EpicLoot consumes the input. Hold EpicLoot's configured Socket Overlay Modifier (normally LeftAlt) with Use to leave the input to its socket UI. EpicLoot confirmation prompts retain control, and switching from sockets to tankard storage closes and saves the socket UI first. Keep NewtonsoftJsonDetector installed; it is a required dependency of EpicLoot. This optional integration targets the UI contracts in EpicLoot 0.14.5; changed or missing contracts produce one startup warning and leave Use input to EpicLoot.

Potion And Buff Bonuses

UsefulTankards classifies each timed status effect before applying a tankard bonus.

• A pure recovery-over-time effect has health, stamina, or eitr recovery over time without any additional timed stat modifier. It is treated as a potion-style effect and can receive cooldown reduction.
• Every other timed effect receives the buff-duration bonus instead. This includes mixed effects that combine recovery over time with another modifier.

This makes tankards useful without turning every drink into the same kind of bonus.

Configuration

Configuration is server-synced by default.

General options include:

• Movement While Drinking: 0 keeps the vanilla movement lock, 1 allows normal movement, and values in between allow partial movement.
• Tankard Animation Speed: 1 keeps vanilla speed, 2 is twice as fast, and 3 is three times as fast.

Per-tankard options include:

• durability
• repairability
• potion cooldown reduction
• buff duration bonus
• storage slots (values above five round the rectangular grid up to the next multiple of five)

Recipe options are available for:

• Tankard
• TankardAnniversary

Compatibility

UsefulTankards is designed to stay lightweight and config-driven. ValheimCuisine's VC_GoK is detected automatically when ValheimCuisine is installed.

Localization

UsefulTankards includes English and Korean tooltip text for the tankard storage prompt and tankard bonus lines. Any other selected language falls back to English.

Building And Checking Changes

This source targets Valheim 1.0.7. Tankard storage accepts the game's v109 inventory format. Older embedded tankard data (including v100–106), unsupported future formats, and incomplete loads are retained unchanged but cannot be opened or consumed. This mod does not migrate those payloads; the game's own character/world loading is unchanged.

Build with the .NET SDK, the .NET Framework 4.8 developer pack, and a Valheim 1.0.7 installation containing BepInEx and original, unmodified game assemblies:

dotnet build UsefulTankards.csproj -c Debug -p:DeployToGame=true

GamePath supplies default dependency paths; BepInExPath and CorlibPath can also be overridden individually. Compilation and ILRepack use the original game assemblies. After a successful Debug build and ServerSync merge, DeployToGame=true copies only the final mod DLL to the local Valheim BepInEx/plugins folder. Use DeployToGame=false to skip copying, or DeployToGameDirectory to select another plugin folder. Debug builds do not generate release packages. Release builds merge ServerSync and regenerate the Thunderstore manifest and ZIP. The bundled ServerSync build is documented in Libs/README.md.

Run the storage regression checks with the .NET 8 SDK or a compatible newer SDK:

dotnet run --project Tests/StorageRegression.csproj

These checks compile the production storage code against small game test doubles. They do not replace Valheim, Harmony, or multiplayer testing. See Tests/README.md in the source checkout for coverage and the remaining in-game checks.