Varkour

Varkour (Valheim parkour mod)

Build parkour courses with the Parkour Pole, run them, and compete on server-side time leaderboards.

Built for Valheim 1.0 (Unity 6) on BepInEx 5 with Jotunn 2.30.

What you need

• BepInExPack_Valheim 5.4.2350 or newer
• Jotunn 2.30.1 or newer (ValheimModding-Jotunn). Varkour needs it and won't load without it.
• Everyone in a multiplayer game needs Varkour, and the server needs it too (a dedicated server or the hosting player). Jotunn blocks the connection if the versions don't match.

Install with Gale

1. In Gale, create a new profile for testing (for example "Varkour test").
2. In that profile, install Jotunn from the Thunderstore browser. BepInExPack gets installed with it.
3. Import this zip as a local mod: use Gale's Import menu, choose Local mod, and pick the Varkour zip. The zip is in the usual Thunderstore format (manifest.json, icon.png, plugins/Varkour.dll).

• If the import fails, open the profile folder instead (profile menu, "Open profile folder") and copy plugins/Varkour.dll to BepInEx/plugins/Varkour/Varkour.dll.

1. Launch Valheim from Gale. In BepInEx/LogOutput.log (or the console) you should see:

Varkour <version> loaded (client).

1. The config file is BepInEx/config/dillon.varkour.cfg. It's created on first launch, and you can edit it in Gale's config editor.

Controls (defaults, change them in the config)

| Key | What it does | |---|---| | F8 | Opens/closes the Varkour window (pole equipped, not mid-run) | | Left Alt | While the window is open: switch between clicking the window and controlling the game. When the window is dimmed the game has the mouse, so you can look around, open the zone menu and place zones with the window still up. You can walk in both modes | | F9 | Restart: teleports you into the Start Zone of your current or last course and cancels the run | | F10 | Cancels the current run or countdown | | F6 | Practice mode only: teleports you back to the last zone you hit | | Right-click (in editor) | Opens the zone menu (Start / Checkpoint N / End) | | M1 (in editor) | Places the selected zone | | Shift + scroll (in editor) | Changes the size of the next zone (0.5 to 5 m in 0.5 m steps, starts at 1 m). The ghost ring shows the size and the HUD shows the number | | Middle mouse (vanilla Remove key, in editor) | Removes the zone under your crosshair |

Quick start

1. Craft the Parkour Pole at a workbench (5 Wood) and equip it.
2. Press F8, type a name, and click New course. The editor opens.
3. Close the window. Right-click and place a Start Zone, a few Checkpoints, and an End Zone.
4. Press F8 and click Close editor.
5. Stand still in your Start Zone: READY while the countdown runs, SET when it's done, GO as you leave the zone. The timer starts when you leave the Start Zone.
6. Finish without cheats or practice mode, and the course is published with your run as its first leaderboard entry. Buffs are fine: holding the pole gives you Parkour Time (no fall damage, bonuses capped at vanilla, vanilla fall speed, and a stamina pool from the best three foods you carry, checked once when you equip it).

Where data is saved

• Server (single player, the host, or a dedicated server): BepInEx/config/Varkour/<world>/server.json
• Your drafts: BepInEx/config/Varkour/<world>/drafts.json (only on your own PC)

Manual test checklist

Single player

Parkour Time (the pole's effect)

• [ ] Equipping the pole shows "Parkour Time" among your status effects; unequipping removes it.
• [ ] Sprint a fixed distance (for example between two workbenches) with the pole equipped. Time it at Run skill 0, then raise the skill with the console (devcommands, then raiseskill run 100) and time it again. The times should match. If you have gear or a mead with a positive movement speed bonus, it should make no difference either.
• [ ] Put on heavy armor (iron or padded). With the pole equipped you're still slower than with no armor.
• [ ] Get overweight. Encumbrance behaves exactly as in vanilla (you walk slowly), with or without the pole.
• [ ] Jump off something tall with the pole equipped: no damage. With a feather cape you fall at vanilla speed.
• [ ] Carry three foods and equip the pole: your max stamina becomes base + their three stamina values (never below 150) and the bar fills. With no food it is 150.
• [ ] Unequip the pole. Speed buffs, fall damage and your eaten-food stamina come back.