SwmarlyValheimBetterFistsWeapons
Gives every Unarmed/Fists weapon the vanilla knife secondary attack instead of the unarmed kick.
模組介紹 作者原文
Swmarly Valheim Better Fists Weapons
This BepInEx mod gives every vanilla Unarmed/Fists weapon the normal vanilla knife special attack.
What it changes
Fist weapons such as the Fenris claws no longer perform the unarmed kick when middle-clicking. Their secondary attack is replaced with the same attack definition used by Valheim's knives, including:
- the knife secondary animation and hit shape;
- the knife attack timing and stamina cost;
- the knife's special-attack damage multiplier;
- the fist weapon's own slash audio and visual effects from its primary attack;
- the normal weapon damage and Fists/Unarmed skill scaling of the equipped fist weapon.
The mod copies the live knife attack at runtime instead of hardcoding a multiplier. That keeps the behavior aligned with the installed Valheim build and with any knife-balance changes that happen before the item database is built.
Multiplayer and dedicated servers
Install the mod on the dedicated server and on every client. The change is made to each peer's local item database; it does not add a new item, recipe, or network protocol. Having the same version everywhere keeps the attack definition and combat behavior consistent for all players.
The plugin also loads in the dedicated-server process. The server does not need to render the animation, but loading the same item-data patch there avoids having different weapon definitions between the server and clients.
Compatibility
The patch runs after Valheim builds ObjectDB. It looks for a knife item with a real secondary attack, then applies a clone of that attack to actual fist-weapon items whose skill type is Skills.SkillType.Unarmed. Valheim's PlayerUnarmed placeholder is explicitly excluded, so empty hands retain the normal vanilla unarmed kick. Non-item entries in ObjectDB.m_items are also skipped.
If another mod deliberately changes knife or fist secondary attacks, the final definition present when ObjectDB.Awake completes is what this mod mirrors. Load order can therefore matter when another mod also edits these same attack fields.
Building
The project targets.NET Framework 4.7.2 and expects these paths:
- Valheim: C:\Program Files (x86)\Steam\steamapps\common\Valheim
- BepInEx: the BepInEx directory inside the Valheim installation
Override them when necessary:
dotnet build src -c Release `
-p:ValheimManagedDir="D:\Games\Valheim\valheim_Data\Managed" `
-p:BepInExCoreDir="D:\Games\Valheim\BepInEx\core"
python scripts/package.py
The GitHub Actions workflow downloads the current dedicated-server assemblies and builds the package automatically.
安裝與使用 安裝:BepInEx 外掛
- 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
- 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時,主機與所有用戶端需要安裝一致的模組。
下面這些內容需要先安裝,否則該模組不會生效: