TurretAmmoFix

版本 v1.0.0·更新於 2026-09-21

Allow all bolt/ammo items to be loaded into turrets and ballistas by appending them to each Turret's allowed-ammo list at spawn.

模組介紹 作者原文

TurretAmmoFix

Let your turrets and ballistas actually use all ammo-type items.

In vanilla, a Turret (ballista) only accepts the specific ammo prefabs assigned to its Turret.m_allowedAmmo list. TurretAmmoFix scans every Ammo item in the game (ObjectDB and ZNetScene prefabs) and appends any that are missing to each turret's allowed-ammo list the moment it spawns — so bolt ammo from other mods, custom bolts, and any ItemType.Ammo item can be loaded and fired.

A Valheim BepInEx 5 plugin.

Features

  • Works on every Turret (ballista) instance at spawn, including modded ammo.
  • No new items, no recipes, no prefab injection, no networking — purely client-side list expansion.
  • Fully configurable.

Requirements

  • BepInExPack Valheim (installed automatically by your mod manager)

Installation

  • Install through your mod manager (recommended).
  • Manual: drop TurretAmmoFix.dll into BepInEx\plugins\.

How to use

Load the game and place a turret/ballista as usual. Open the turret's ammo-storage slot — every Ammo-type item in your inventory (vanilla bolts, custom bolts, and any ammo added by other mods) will now be loadable. Firing behaviour is unchanged; the mod only expands the allowed-ammo list.

Configuration

Config file is generated on first launch at BepInEx\config\custom.turretammofix.cfg:

| Key | Default | Description |

|-----|---------|-------------|

| Enabled | true | Master toggle. When false the mod makes no changes. |

| AllowAllBoltAmmo | true | Add every ItemType.Ammo item to turrets. |

How it works

A postfix on Turret.Awake collects all Ammo items reachable from ObjectDB.m_items and ZNetScene.m_prefabs, then appends any that are missing to m_allowedAmmo (each entry gets an inactive empty child visual, matching the vanilla pattern).

Changelog

See CHANGELOG.md.

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時,主機與所有用戶端需要安裝一致的模組。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

denikson-BepInExPack_Valheim

檔案與校驗

檔案名稱
TurretAmmoFix-1.0.0.zip
檔案大小
13.1 KiB