Capes Precision Drop

Stop tossing things. Place items from your inventory exactly where you want them.

Drop seeds right next to your chickens, berries in front of a boar you're taming, or food inside a lox pen, without it bouncing off somewhere else. Place mode gives you a build-style preview of the item, and your normal build controls to aim, rotate, and place it.

Features

• Build-style placement: a preview of the item and the build marker follow your crosshair, with the same aiming and range as the hammer.
• Your own controls: place, rotate, and cancel use your build controls, including any changes you've made in Valheim's Controls menu.
• Toggle, not hold: turn place mode on once and place as many items as you like, then turn it off.
• Controller support: set your controller button or combination just by pressing it.
• Clear status: an on-screen label shows whether place mode is ON or OFF (and reminds you if no key is set yet). You can move it, resize it, or turn it off.
• Vanilla by default: with place mode off, dropping works exactly like the base game.
• Client-side: only you need it installed. It works on servers and with friends who don't have it.

Recommended: a config menu mod

To set your key or controller button in game, you need a mod that adds a settings menu (usually opened with F1). This mod doesn't require one, so use whichever you already have, for example:

• Official BepInEx ConfigurationManager
• Mod Configs, or any other BepInEx configuration manager

No config menu? You can still set everything by editing BepInEx/config/th3cap3.valheim.capesprecisiondrop.cfg in a text editor (see below).

Setup

Nothing is bound by default, so pick a key or button after installing. Until you do, the indicator shows an orange "set a place key" reminder whenever your inventory is open.

Keyboard: press F1 in game, find Capes Precision Drop, and set PlaceKey.

Controller: press F1, tick RecordPlaceButton, then press and hold your button or combination on the controller and let go. It saves automatically. Esc or waiting 10 seconds cancels. A combination, like holding a bumper and pressing another button, avoids clashing with the buttons' normal actions.

Without a config menu: open BepInEx/config/th3cap3.valheim.capesprecisiondrop.cfg (in r2modman: Settings > Browse profile folder) and set, for example, PlaceKey = LeftAlt or PlaceButton = JoyLBumper + JoyButtonY. The file appears after you launch the game once with the mod installed.

How to use

1. Open your inventory. The indicator shows "Precision Drop: OFF". Press your place key or button and it switches to "Precision Drop: ON".
2. Drop an item the normal way: drag it outside the inventory, or use your controller's drop button.
3. The inventory closes and a preview of the item follows your crosshair.
4. Use your build controls:

Place mode stays on until you press the key again with the inventory open, so you can place several items in a row.

Settings

Good to know

• Placed items are still normal dropped items. They can tip over or roll on slopes, and animals eat them as usual.
• Only items from your own inventory can be placed, not from chests.
• SeneaL UI: with SeneaL UI enabled, the F1 menu doesn't register key presses when setting a key. Set it in the config file instead, or disable SeneaL UI, set the key, and turn it back on.

For mod authors

UI mods can show their own place mode indicator and hide this one, through CapesPrecisionDrop.PrecisionDropAPI:

These names are stable. Everything else in the mod is internal and may change.

With a hard dependency, reference CapesPrecisionDrop.dll and add [BepInDependency("th3cap3.valheim.capesprecisiondrop")]. Without one, check BepInEx.Bootstrap.Chainloader.PluginInfos for the GUID and use reflection:

var api = System.Type.GetType("CapesPrecisionDrop.PrecisionDropAPI, CapesPrecisionDrop");
bool on = (bool)api.GetProperty("IsPlaceModeOn").GetValue(null);
api.GetMethod("HideBuiltInIndicator").Invoke(null, new object[] { MyPlugin.GUID });

Author

Made by Th3Cap3. Found a bug or have an idea? Let me know on the mod's page.

Changelog

1.0.1

• Fixed: the "set a place key" reminder and the "Place mode ON/OFF" messages were hidden behind the inventory window.
• The on-screen indicator now shows every state, on top of the inventory:
  • Set a key (orange): no key or button is set yet. Shows while the inventory is open.
  • OFF (dimmed): shows while the inventory is open, so you know what your key will do.
  • ON (gold): shows all the time while place mode is on, as before.
  • Placing (gold): while aiming, as before.
• After recording a controller button, the indicator briefly shows "Place button set to ..." or "Recording cancelled".
• Mod page: added a "Recommended: a config menu mod" section and clearer steps for setting the key in the config file.

1.0.0

First release.

• Place mode: toggle it with your place key or controller button while the inventory is open. While it's on, dropping an item lets you place it instead of tossing it.
• Build-style placement: a preview of the item and the build marker follow your crosshair, with the same aiming and range as the hammer.
• Uses your own build controls to place, rotate, and cancel, including any remaps in Valheim's Controls menu.
• Rotation with the mouse wheel or your controller's build rotate controls.
• Controller support, including recording a button or button combination by pressing it.
• On-screen "Precision Drop: ON" indicator, with adjustable position and size, or turn it off.
• Public API for UI mods: read place mode status and hide the built-in indicator.