Kong Strong Energy for Valheim

English · Deutsch

A Valheim mod with energy drinks in the style of Kong Strong: more stamina, more speed, protection from fire, frost and poison, plus own models, empties with a deposit machine and build pieces like a fridge and a tap.

The drinks

Only one Kong drink works at a time, and you cannot drink a new one during the sugar crash. You can combine all drinks with mead.

Around the drinks

• Power animation: Drinking raises your arms like activating a Forsaken power, with Eikthyr's glow but without its sound. Your real power and its cooldown stay untouched.
• Caffeine tolerance: Several drinks within 15 minutes work weaker (the second at 50 %, every further one at 25 %). From the third on you get 2 minutes of heart racing with slower regeneration.
• Too awake to sleep: With an active Kong buff your bed refuses to let you sleep.
• Empties: Cans and bottles leave intact empties (not crushed, or the deposit machine could not scan them). Build a can pyramid from them, or trade them for coins at the deposit machine.
• Own models: Cans, bottles, canister, cup and keg are own models. Set CustomModels = false in the config to fall back to the game's mead bottles.
• "D K!" shout: After the Kong Strong cans an own shout can play ([Sound] Shout, on by default). The mod ships no sound: put your own WAV file (16 bit PCM) at BepInEx/config/KongStrong/shout.wav, it stays on your PC. Without the file it stays silent. ShoutBoost makes the sound louder.

Crafting

All drinks are brewed at the cauldron. You can build the cauldron once you have tin from the Black Forest, and it needs a fire underneath.

Sugar Free needs no honey, it is sugar free after all.

Build pieces (hammer)

All values, recipes and stations can be changed in the config (see Configuration).

Requirements

• BepInExPack_Valheim 5.4.2333 or newer
• Jotunn 2.30.2 or newer

In multiplayer all players and the server need the same version of the mod, or Jotunn refuses the connection.

Installation

The finished mod is on the release page as KongStrongEnergy-<version>.zip. It contains plugins/KongStrong.dll plus manifest.json and icon.png for mod managers.

With a mod manager (Windows and Linux)

In r2modman or Gale:

1. Create a Valheim profile and install BepInExPack_Valheim and Jotunn in it.
2. Import the zip with the import function for local mods (in r2modman: Settings → Import local mod), or install the package from Thunderstore.
3. Start Valheim through the mod manager (in r2modman: Start modded).

Manually on Windows

1. Open the Valheim folder: in Steam right click Valheim → Manage → Browse local files.
2. Download BepInExPack_Valheim and copy the contents of its BepInExPack_Valheim folder directly into the Valheim folder. Afterwards BepInEx\, winhttp.dll and doorstop_config.ini sit next to valheim.exe.
3. Download Jotunn and copy plugins\Jotunn.dll to BepInEx\plugins\.
4. Create the folder BepInEx\plugins\KongStrong\ and copy KongStrong.dll into it.
5. Start Valheim normally through Steam. No launch options are needed on Windows.

Manually on Linux (native Steam version)

1. Open the Valheim folder, usually ~/.local/share/Steam/steamapps/common/Valheim.
2. Copy the contents of BepInExPack_Valheim from the zip into this folder and make the start script executable:

   chmod +x start_game_bepinex.sh
   

3. Put Jotunn and KongStrong.dll in place like on Windows: BepInEx/plugins/Jotunn.dll and BepInEx/plugins/KongStrong/KongStrong.dll.
4. In Steam right click Valheim → Properties → Launch options:

   ./start_game_bepinex.sh %command%
   

5. Start Valheim through Steam.

Linux with Proton: If you run Valheim through Proton (compatibility forced), install the files like on Windows and use WINEDLLOVERRIDES="winhttp=n,b" %command% as launch option instead.

Dedicated server

Put BepInExPack_Valheim, Jotunn.dll and KongStrong/KongStrong.dll on the server the same way. On Linux start the server with start_server_bepinex.sh, on Windows as usual.

Does it work?

• BepInEx/LogOutput.log contains lines like Added KongStrongSugarFree.
• The drinks show up in the recipe list at the cauldron.
• For testing, use the console (F5): first devcommands, then for example spawn KongStrongSugarFree 5. The prefab names are KongStrongSugarFree, KongStrongClassic, KongSkyrEnergy, KongStrongXXL, KongStrongFrost, KongStrongToxic, KongStrongEitr, KongMetBombe, KongSkyrCup and KongLeergut (the empty).

Configuration

After the first start with the mod, the file BepInEx/config/felix.kongstrong.cfg is in your Valheim folder. Changes take effect after restarting the game.

The drink sections [SugarFree], [Classic], [Skyr], [XXL], [Frost], [Toxic], [Eitr] and [MetBombe] all have the same keys:

More sections: [SugarCrash], [CaffeineTolerance], [HeartRacing], [SkyrCup], [General] (sleep block, empties, models, animation), [Sound] and one per build piece: [Fridge], [CanPyramid], [DepositMachine], [Tap].

Updates: Recipes (Ingredients) and crafting station (CraftingStation) that still hold the default of an older version are set to the new default automatically at startup. Values you changed yourself stay as they are, so you do not have to delete the config.

The prefab names of ingredients are in the Jotunn item list.

Building it yourself

You need:

• the .NET SDK 8 or newer
  • Windows: installer from the Microsoft page or winget install Microsoft.DotNet.SDK.10
  • Arch/CachyOS: sudo pacman -S dotnet-sdk
• Valheim with BepInExPack and Jotunn installed. The build uses the DLLs straight from the game folder. No NuGet packages are downloaded.

git clone https://github.com/Stanni97/valheim-kong-strong.git
cd valheim-kong-strong
dotnet build -c Release

The build copies KongStrong.dll to BepInEx/plugins/KongStrong/ automatically and puts the release zip in dist/.

If Valheim is not in the default Steam folder, pass the path:

dotnet build -c Release -p:ValheimDir="D:\SteamLibrary\steamapps\common\Valheim"

Turn off the automatic copy into the game with -p:InstallToGame=false.

For a new version raise the version number in two places: <Version> in KongStrong.csproj and PluginVersion in src/KongStrongPlugin.cs.

Icons and model textures are made with Python 3 (Pillow): tools/make_icons.py (icons; --classic gives the first, clean style, which is also kept as finished files in Assets/backup-v1) and tools/make_textures.py (textures of the models). The gorilla comes from tools/gorilla.py, the meshes are built in code by src/Models.cs. The default fonts are Noto Sans Black and DejaVu Serif Bold; set other paths with the environment variables KONG_FONT_HEAVY and KONG_FONT_SLAB.

python3 tools/make_icons.py Assets 128
python3 tools/make_textures.py Assets
python3 tools/make_icons.py /tmp/icons256 256   # then copy sugarfree.png to Thunderstore/icon.png

Updates

• With a mod manager (recommended): r2modman and Gale show new versions from Thunderstore and install them. In multiplayer, update the server and all players together, they need the same version.
• Manual install from GitHub: If you installed the mod by hand, the optional Bifrost Updater can keep it current from the GitHub releases. It is a separate tool and not part of this package. Don't use it on a mod manager profile, the mod manager would then show the wrong version.

The mod itself never downloads anything and never updates itself.

Notice

This is an unofficial fan mod with no connection to Lidl, Milbona or the Kong Strong brand. Icons, models and textures are own work in the style of the cans.

License

Code and icons are under the MIT license. The license grants no rights to the Kong Strong, Milbona and Lidl trademarks, those stay with their owners.

Changelog

Deutsch

1.2.2

• A dedicated server no longer loads the shout, and without a shout.wav the "No shout file" line is logged once instead of once per drink.
• README: updates go through the mod manager (r2modman, Gale). Bifrost Updater is only mentioned as an optional tool for manual installs from GitHub.

1.2.1

• The textures of the build pieces repeated several times because Valheim's piece shader tiles them. Build pieces now use a plain Standard material, and the deposit machine texture is drawn to the machine's proportions (size unchanged).
• Empties are now an intact grey can in full size instead of a crushed one, so the deposit machine can scan them.
• The "D K!" shout is on by default and louder (volume 1, raised to full scale plus ShoutBoost). The mod no longer ships any sound: the shout only plays with your own shout.wav. Values still at the 1.2.0 default switch at startup.
• The deposit machine has English lettering (DEPOSIT / EMPTIES) for every game language except German (PFAND / LEERGUT).
• README is now English first, with the German version in README.de.md.

1.2.0

• New drinks: Frost, Toxic and Eitr Edition (resistances and eitr), Kong Mead Bomb (fermenter) and the Skyr cup as food.
• Own models and textures for all drinks (CustomModels), icons in Valheim's style (first version in Assets/backup-v1).
• Power animation with Eikthyr's glow when drinking, without using up the real power.
• Caffeine tolerance with heart racing, sleep block in beds, empties with a deposit machine.
• Build pieces: Kong fridge, can pyramid, deposit machine and Kong tap (shared servings in multiplayer).
• Optional "D K!" shout (off), own WAV via CustomShoutFile.
• Config migration: recipes and crafting station at an old default switch to the new one at startup, so updates arrive without manual work.
• Still only needs BepInEx and Jotunn (Harmony is part of BepInEx).

1.1.0

• All drinks are now made at the cauldron instead of the workbench. Existing configs keep their value, set CraftingStation = Cauldron there.
• New recipes: Sugar Free from blueberries, thistle and yellow mushroom; Urban Classic with bloodbag and yellow mushroom; Skyr Energy with egg; XXL from Ashlands ingredients (vineberries, smoke puffs) and yellow mushrooms. Existing configs keep their old Ingredients.
• Warning in the log when an ingredient in the config does not exist.

1.0.0

• First version with four drinks: Sugar Free, Urban Classic (with sugar crash), Skyr Energy and the XXL canister.