TamedTransport

Description

TamedTransport adds reusable cages for transporting boars, wolves, and lox. Capture tamed offspring by default, carry them in your inventory, and release them through the hammer's build menu. In multiplayer, the server controls capture permissions, portal access, and cage definitions, synchronizes settings and icons, and validates capture and placement requests.

Overview

| Feature | Description | | --- | --- | | Wooden Animal Cage | Holds a piglet, or an adult boar when enabled. Requires a level 3 workbench. | | Reinforced Animal Cage | Holds a wolf cub, or an adult wolf when enabled. Requires a level 3 forge. | | Heavy Animal Cage | Holds a lox calf, or an adult lox when enabled. Requires a level 5 forge. | | Pick up animals | Carry the matching empty cage, look at an eligible animal, and press Y. Hover text shows the configured key. | | Saved animal state | Preserves the animal's form, name, stars, health, and tame state. Growth and taming progress pause while caged. | | Cage contents | The tooltip shows the animal's name and star quality under Currently holding:. | | Reusable cages | Capture replaces the empty cage with its loaded version; release restores it. Loaded items skip discovery popups. | | Place animal | Equip a hammer and select Place animal under Misc while carrying exactly one loaded cage. | | Placement preview | Transparent green/red feedback follows workbench restrictions. Water, dungeons, ward restrictions, and no-build areas block placement. | | Safe placement input | Blocks attacks from the placement click until released. Movement remains available. | | Multiple loaded cages | Hides the placement entry and shows a message until only one loaded cage remains. Empty cages do not count. | | Optional capture rules | Separate options allow adults and untamed animals. Both are off by default; capturing does not tame an animal. | | Portal access | Empty cages can teleport. Loaded cages use native stone portals; ordinary portal access is optional. | | Editable cages | YAML controls names, descriptions, models, recipes, station levels, and empty/loaded weights. | | Custom icons | Separate PNGs for all six cages and the placement entry. Missing icons use Wood. | | Live updates | Valid config, YAML, and icon edits reload automatically. Invalid YAML/icon edits retain the last valid settings. | | Interrupted transfers | Pending requests retry when the cage returns to inventory. Pending captures recover in their original world. | | Saves and achievements | Uses normal Valheim saves and leaves achievement eligibility and achievement-enabling mods untouched. | | Multiplayer | Matching versions on clients and server, authoritative validation, synchronized settings, and cached transfers reduce repeated network work. |

Configuration and values

Start the game or server once to generate BepInEx/config/dannanboi.tamedtransport.cfg, BepInEx/config/TamedTransport/cages.yaml, and BepInEx/config/TamedTransport/icons/.

In multiplayer, edit the server/host's Settings, YAML, and icons. Keybindings and UI text remain local. Existing configuration is preserved on upgrade; examples are included in the package. Only empty cages are craftable. Cage values below follow Wooden / Reinforced / Heavy order.

| Section / option | Default | Meaning | | --- | --- | --- | | Settings / Enable Mod | true | Enables crafting, capture, and placement. Existing contents are preserved when disabled. | | Settings / Allow capturing adults | false | Allows adult boars, wolves, and lox to use their species' cage. | | Settings / Allow capturing untamed | false | Allows untamed animals. Untamed adults also require adult capture. | | Settings / Allow through portals | false | Allows loaded cages through ordinary portals. Empty cages always pass; native stone portals also allow loaded cages. | | Keybindings / Pick up | Y | Local pickup shortcut, displayed in hover text. | | UI / Pick up text | Pick up <animal> | Hover text; <animal> becomes the animal's name. | | UI / Contents text | Currently holding: | Heading for saved animal details in cage tooltips. | | UI / Multiple cages message | Can only place one animal at a time, please clear inventory. | Message when several loaded cages are carried. | | YAML / basics / displayName | Cage-specific name | Item name shown in inventory and crafting. | | YAML / basics / description | Cage-specific description | Item description before saved animal details. | | YAML / basics / useModel | dvergrprops_crate | Prefab supplying the cage's visuals, without its container or other behavior. | | YAML / basics / weightPerUnit | Empty: 25 / 50 / 100; loaded: 450 / 750 / 1000 | Total weight of each empty or loaded cage. Normal carrying limits apply. | | YAML / basics / craftingStation | piece_workbench / forge / forge | Crafting station for each empty cage. | | YAML / basics / stationLevel | 3 / 3 / 5 | Required station level. | | YAML / ingredients (Wooden) | Wood[30], LeatherScraps[10], Resin[15] | Empty Wooden cage recipe. | | YAML / ingredients (Reinforced) | FineWood[30], Iron[15], DeerHide[10] | Empty Reinforced cage recipe. | | YAML / ingredients (Heavy) | FineWood[40], BlackMetal[30], Chain[8] | Empty Heavy cage recipe. | | YAML / placement icon | dbtt_PlaceAnimal | PNG basename for the Place animal build-menu icon. |

Cage icons use icons/<top-level cage name>.png, such as icons/dbtt_WoodenCageLoaded.png. The build-menu icon uses icons/<placement icon>.png. Missing files fall back to Wood. Keep all six YAML entries; loaded entries contain basics only.

Transport recovery state is stored in BepInEx/config/TamedTransport/state/. Keep it with world backups.

Manual Installation