Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
TamedTransport
Take your beloved pets with you anywhere, craft cages and transport them. Config options for portal restrictions and tamed/untamed/young/adult. Server-synced and locked in multiplayer.
By dannanboi
| Last updated | a day ago |
| Total downloads | 109 |
| Total rating | 0 |
| Categories | Misc Tools Server-side Client-side Utility Transportation AI Generated Deep North Update |
| Dependency string | dannanboi-TamedTransport-1.0.0 |
| Dependants | 0 other packages depend on this package |
README
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
- Install
BepInEx/plugins/dannanboi_TamedTransport.dllon clients and servers. Remove older or duplicate DLL copies before upgrading. - Start the game or server once to generate
BepInEx/config/dannanboi.tamedtransport.cfg,TamedTransport/cages.yamland theTamedTransport/iconsfolder underBepInEx/config. - For multiplayer, edit the server/host's files.
Compatibility
Requires BepInEx 5 for Valheim and matching TamedTransport versions on clients and server. Supports single-player, hosted multiplayer, and dedicated servers. Mods that replace animal prefabs, change cage custom data or stacking, override hammer placement, or alter portal restrictions may need compatibility adjustments.
dannanboi Mod Philosophy
My mods aim to be small and modular, stay close to Valheim's vanilla experience, and work well together or independently. Enable all features to make bigger changes, or choose the ones that suit your playstyle. Your run should be yours to customize. Features described as "an added bonus" or "nice to have" should always be optional. In multiplayer, the server controls gameplay settings, while visual settings stay local to each player.
Credits
You, the player. Thanks for using my mod!
