RecallTames
Admin commands for safely recalling existing tamed creatures from anywhere in the world.
模組介紹 作者原文
RecallTames
RecallTames adds admin-only console commands for Valheim servers and local worlds. It can find existing tamed creatures saved in the world's ZDO data, including creatures in unloaded areas, and recall them near the administrator without deleting, cloning, or respawning them.
The mod was built for Valheim 1.0.x, BepInExPack Valheim, and compatibility with taming mods such as Meldurson-LetMeTameYou.
Main Features
- Finds tamed creatures from world ZDO data, not only currently loaded Character instances.
- Teleports the same existing ZDO instead of spawning a replacement.
- Keeps creature name, level/stars, tame state, inventory/custom mod data, AI state data, and owner data intact.
- Supports all creature prefabs that are marked as tamed and can be resolved through ZNetScene.
- Works with vanilla and modded creatures.
- Filters by prefab name.
- Filters by visible star count.
- Places recalled creatures in rings around the admin instead of stacking them in one spot.
- Creates JSON backups before teleporting.
- Supports undo from the latest backup.
- Uses server-side validation for dedicated servers.
Installation
Install with r2modman Mod Manager, or manually place:
RecallTames.dll
inside:
BepInEx/plugins/RecallTames/
Recommended multiplayer setup:
- Install on the dedicated server.
- Install on the administrator's client.
- Other players do not need the mod unless they also want to use the command.
Commands
Open the Valheim console and use:
recalltames
recalltames help
recalltames list
recalltames count
recalltames count Wolf
recalltames count Wolf 2
recalltames preview all
recalltames preview Wolf
recalltames preview Wolf 2
recalltames all
recalltames all stars 2
recalltames all confirm
recalltames Wolf
recalltames Boar 2
recalltames Troll
recalltames Serpent here
recalltames Serpent force
recalltames undo
recalltames undo confirm
Prefab names are used for commands. For example, use Boar, Wolf, Lox, Troll, Serpent, or the exact modded prefab name shown by:
recalltames list
Commands are case-insensitive.
Star Filtering
The number after a prefab name means visible stars, not internal Valheim level.
Examples:
recalltames Boar 2
Recalls only 2-star Boars.
recalltames Wolf 1
Recalls only 1-star Wolves.
recalltames Troll 0
Recalls only no-star Trolls.
Valheim stores these internally as:
- 0 stars = level 1
- 1 star = level 2
- 2 stars = level 3
RecallTames handles this conversion automatically.
Safety Backups
Before teleporting creatures, RecallTames writes a backup JSON file to:
BepInEx/config/RecallTames/backups/
The backup includes:
- ZDOID
- prefab name
- old position
- new position
- tamed name, if present
- level
Use:
recalltames undo
to restore the latest moved creatures to their previous positions. Missing/dead ZDOs are skipped and reported.
Config
Config file:
BepInEx/config/RecallTames.cfg
Important options:
[General]
EnableMod = true
RequireAdmin = true
EnableLogging = true
CreateBackupBeforeTeleport = true
[Placement]
StartRadius = 4
RingSpacing = 4
CreatureSpacing = 3
MaxRadius = 30
FlyingHeight = 5
[Safety]
RequireConfirmationAbove = 20
AllowUnknownPrefabs = false
AllowWaterCreaturesOnLand = false
LetMeTameYou Compatibility
RecallTames does not patch taming, breeding, AI, pregnancy, feeding, or command behavior. It only reads already existing tame state from ZDO data.
If a creature tamed by LetMeTameYou is stored as a normal tamed creature with tamed = true, RecallTames should find it.
Verified against local Meldurson-LetMeTameYou 0.0.3.
Known Limitations
- Water-like creatures, such as Serpent, are treated conservatively. Use here near safe water or force if you knowingly accept the risk.
- The mod does not load remote zones just to test collision. Placement is spread in rings and uses current terrain height when available.
- For ZDOs owned by another network peer, RecallTames does not take ownership. It moves the ZDO, marks data dirty, and asks Valheim
安裝與使用 安裝:BepInEx 外掛
- 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
- 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時,主機與所有用戶端需要安裝一致的模組。
下面這些內容需要先安裝,否則該模組不會生效: