ShieldGolf — disc golf with shields

Throw a round shield like a golf disc. The flight is physical: real disc lift, drag and spin, so a hard throw turns right, a soft one fades left, wind pushes it, and it skips, rolls or glances off trees when it lands. There is no scoring: build a course from ordinary pieces (or put a basket down with /discbasket) and count your own strokes.

Client-side. The server needs nothing. Friends without the mod see the shield fly and land as an ordinary dropped item and can pick it up.
Nothing new in the game. No prefabs, models or recipes; thrown shields are the game's own dropped items, baskets are vanilla building pieces.
Vanilla stays vanilla. With a weapon in your right hand, or until you arm throw mode, every button does what it always did.

Full guide with the flight model, a throw calculator, basket plans and the config reference: guide.html in the mod's folder (open it in a browser; in Gale and r2modman: Open folder on the mod, or the profile's BepInEx/plugins/ShieldGolf/ or BepInEx/plugins/z3n-ShieldGolf/). It always matches the version you have installed. The latest one is online: https://shieldgolf.planetdg.com/

Want to play the real thing? Find a disc golf course near you on Planet DiscGolf.

Install

Gale, r2modman or Thunderstore Mod Manager: install ShieldGolf into the Valheim profile you play with, or import the zip as a local mod (Gale: the profile's mod list; r2modman: Settings → Import local mod). BepInExPack_Valheim is the only dependency.
Start the game from the mod manager. The profile's BepInEx/LogOutput.log shows ShieldGolf <version>: 11 shields in 5 classes.

Only players who want to throw need it, but give it to everyone in the round: when a long throw flies near another player, the game hands the shield to their client in mid-air, and only a client with the mod flies it on. Without it the shield just drops there. Players with the mod also see each other aim (the held shield's tilt and wind-up). Everyone should run the same version.

Built and measured on Valheim 1.0.20 (Linux shows it as l-1.0.20). On another version the log warns and the throws may be off.

Without a mod manager

The mod is one file, ShieldGolf.dll, loaded by BepInEx from the game folder. Steam's game folder is C:\Program Files (x86)\Steam\steamapps\common\Valheim on Windows and ~/.steam/steam/steamapps/common/Valheim (or ~/.local/share/Steam/steamapps/common/Valheim) on Linux.

BepInEx, once: download BepInExPack_Valheim (denikson) from Thunderstore, open the zip, and copy the contents of its BepInExPack_Valheim folder (BepInEx, doorstop_libs, winhttp.dll, doorstop_config.ini, the two .sh scripts) into the game folder, next to valheim.exe / valheim.x86_64.
The mod: open z3n-ShieldGolf-<version>.zip and copy ShieldGolf.dll to <game folder>/BepInEx/plugins/ShieldGolf/ (make the folder; any name works, BepInEx loads every DLL under plugins). Updating is replacing that one file.
Windows: start the game from Steam as usual; winhttp.dll in the game folder makes it load BepInEx. Linux, native build: in Steam, right-click Valheim → Properties → Launch options, enter ./start_game_bepinex.sh %command%. If the log in step 4 never appears, make the script executable once: chmod +x "<game folder>/start_game_bepinex.sh". Linux with Proton (the Windows build forced in Compatibility): use WINEDLLOVERRIDES="winhttp=n,b" %command% as the launch option instead.
Check <game folder>/BepInEx/LogOutput.log for ShieldGolf <version>: 11 shields in 5 classes.

The config file then lives at <game folder>/BepInEx/config/z3n.shieldgolf.cfg. r2modman, Gale and Thunderstore Mod Manager keep their own profiles and ignore the game folder's BepInEx, so a manual install and a managed one don't see each other; use one or the other.

Controls

Hold one of the listed shields with nothing in the right hand.

Input	What it does
Secondary attack click (middle mouse unless you rebound it)	Arms throw mode, in backhand. Further clicks switch forehand and backhand; with a buckler or the Wood shield they step backhand, putt, forehand. Holding it half a second leaves throw mode. With a listed shield alone in your hands this button no longer kicks.
Block hold (right mouse)	The camera stops and the mouse tilts the shield: left dips the left edge (hyzer, bends left), right dips the right edge (anhyzer, bends right); up and down set the nose (±10°). Two lines at the top left read out the nose and tilt while you hold. Both stay where you leave them. A quick tap flattens both.
Attack hold, release (left mouse)	Wind up, then throw. Holding 1.2 s is a full throw: the bow's draw sound plays and the shield jolts. Let go right then for a clean throw with no release error; hold on and you overpower it: the shield trembles and the throw turns over to the turn side (right for a backhand, left for a forehand), more for an understable shield, less with skill. In putt mode it reaches the chains at 15–20 m. Aim with the camera: a level aim already throws about 10° upward, which is close to the best loft. Aim down a little for a low, fast line; aiming up stalls the disc.
Equip a weapon, unequip the shield, open a menu	Throw mode turns off; a menu opened mid wind-up cancels the throw.
Any movement key after a throw	Takes the camera back from the shield.

Forehand spins the other way, so turn and fade swap sides.

Putt mode (bucklers and the Wood shield) is a push putt. Look at the chains and wind up: the putt goes toward the point under the crosshair, arcing up and dropping onto it. About half a second reaches 5 m and 0.8 s reaches 10 m; a full wind-up reaches the chains at 15 m at Blocking 0 and 20 m at Blocking 100. The putt spins less than a normal throw, so it floats straight and fades a little at the end. Aimed within 3.5 m, a putt is a tap-in: the shield leaves from above your head and lobs down where you look, so a shield parked under the basket still goes over the rim. Tap-ins need putt mode, so switch to a buckler or the Wood shield to finish a hole; a short throw with any other shield or stance is a normal throw. Look into the basket (the funnel or the chains), not at the pole under it. Step by step, with diagrams: https://shieldgolf.planetdg.com/#tapin To see the distances, set [debug] distance_rings = true: in throw mode, rings at 3.5 m, 10 m and 20 m lie around the point you look at.

The discs

Class	Shields	Flight numbers	Carry at Blocking 100
Putter	Bronze, Iron, Carapace and Deep North (gold) bucklers	2 / 3 / 0 / 1	about 65 m
Mid-range	Wood shield, Banded shield	5 / 4 / −1 / 1	about 80 m
Fairway driver	Silver shield	7 / 5 / 0 / 2	about 90 m
Distance driver	Black metal, Flametal and Deep North (gold) round shields	11 / 5 / −1 / 3	about 125 m
Ultimate	Shield of Roots	2 / 7 / −1 / 1 (27.3 cm)	about 58 m

The Shield of Roots is the ultimate frisbee disc (a Discraft Ultra-Star): slow and floaty, it sinks slowest of all, hangs longest off a hill and lands flat. An easy throw floats straight; a full flat rip turns over right, so hyzer it. It does not putt.

Every shield flies a little differently:

Blocking is the golf skill: a fresh character throws about two thirds as far with less spin, so the disc turns and fades more. A landed throw trains Blocking by its carry. Each throw costs 10 stamina.
Quality sets stability: quality 1 is understable (turns right, fades little), max quality is overstable (holds, then fades hard).
Wear: a landing costs 1 durability, a tree or rock 3. A worn shield is beat in and turns more; repairing it makes it stable again.
Weight sets the disc's mass (150–180 g); heavier drifts less in wind.
Landings: a fast, shallow landing skips; a disc that comes down on its edge rolls. One that stops where you would slide (steeper than 38°) slides down to a spot you can stand on.

Other shields (tower shields, the square iron shield) stay vanilla.

Baskets

With the hammer (1.8.0): the baskets are in the hammer's build menu, Misc tab, as "Disc basket: wood funnel", "iron funnel", "iron tray", "gallows" and "backboard". Place one like any other piece: you aim the basket's pole (the gallows: the post on your right as you face it) and the preview shows the whole basket around it. It handles exactly like that pole: snapping, rotation with the mouse wheel, red where it can't stand, a workbench nearby. The whole basket's materials are shown and taken as usual. What gets built is the same ordinary pieces as below, so players without the mod see a normal basket and the server needs nothing. Like any piece, a basket shows up once you have learned all its materials: the wood ones from the start, the iron ones after you have found iron.

With a command: /discbasket in chat (or discbasket in the F5 console) builds a basket 4 m ahead of you, facing you, out of ordinary building pieces: a blueprint the command lays out for you. You bring the parts: it takes the materials the hammer would charge for the pieces from your inventory, says what is missing, and remove refunds them. In a world with the No build cost modifier it costs nothing, as the hammer does there, and removing it gives nothing back. Everyone sees the basket. With the mod, removing any piece of it with the hammer takes down the whole basket and refunds it (1.9.0); a player without the mod removes just that piece.

Command	Builds
`/discbasket` or `/discbasket 5`	The wood funnel: a log pole in a thatch funnel 4 m across, a crown of wood beams with twelve hanging 2 m wood poles as chains. No iron.
`/discbasket 1`	The same funnel with iron beams and iron poles.
`/discbasket 2`	A flat iron tray 4 m across with a rim.
`/discbasket 3`	The gallows: a tray hanging from a curtain of iron poles between two log posts. Throw at the curtain.
`/discbasket 4`	The backboard: the funnel with a wooden wall behind it. Bank the shot off the wall. The forgiving one, and wood only.
`/discbasket 2 8`	Design 2, 8 m ahead (3–20 m).
`/discbasket remove`	Takes the whole nearest basket (within 8 m) down and refunds it. Use it: the crown and chains hold each other up when the pole goes.
`/discbasket help`	The usage.

Someone else's ward and no-build zones refuse them. The game decides nothing: a shield that stays in the basket is in, by the players' word.

Cheats, achievements and the cheated mark

By default the mod marks nothing and flags nobody: baskets are paid for, and there is no way to get a shield but to craft or find one. Two things are cheats, and they only work where the game runs its own cheat commands (devcommands in a world you host):

discshields in the console (or /discshields in chat) puts one shield of each class into your inventory, marked as a cheated item the way spawn marks what it creates. Carrying one blocks achievements until it is dropped or put in a chest; it is a mark on the shield, not on you.
[basket] free = true makes baskets cost nothing. Their pieces carry the game's cheated mark like nocost pieces, and refund nothing.

Neither sets the character's own cheat flag (the one confirmcheats warns about), and neither touches the world. Note that any BepInEx mod, this one included, makes the game count the session as modded, which by itself blocks Steam achievements while the mod is loaded; the game's own opt-in, yesiuseddevcommandsbutiwantmyachievementsanyway 1 in the console, lifts that per character.

One more thing the mod does for you: in a modded session the game normally skips its confirmcheats warning, so devcommands and then god, tod, spawn… flags the character for good without a word. ShieldGolf puts the warning back ([safety] confirm_cheats, on by default): a cheat command is refused with the game's own message until you run confirmcheats, exactly as in an unmodded game.

Config

BepInEx/config/z3n.shieldgolf.cfg in the profile (or the game folder for a manual install), written on the first start; every setting explains itself there. Since 1.10.0 everything that changes a throw or a basket is fixed in the mod: the disc classes, flight constants and wind, skill, wear, the basket designs and the controls that shape a throw. Every game flies its own throws, so this keeps everyone throwing the same shields. The config keeps how the controls feel (mouse sensitivity for tilt and nose, tap and exit timings), the chase camera and visuals, the debug aids (tuning_log, distance_rings), confirm_cheats, and the /discbasket defaults. [testrun] is a developer check and stays off. Lines of the fixed settings from older versions are removed from the file on the first start.

Known limits

The mid-air handoff to another player's client is built from the game's ownership rules but was tested alone so far; please report what you see when a long throw crosses a friend.
Gamepad is untested: arming follows the game's secondary-attack binding, but tilt and nose were built for the mouse.
Mods that change blocking or attacking on Player may conflict.

MIT license.