导入宠物

宠物是角色文件。应用自带的宠物和放在 Codex 宠物文件夹（~/.codex/pets）里的宠物什么都不用做就会出现在邀请标签里，其他宠物则需要导入。

用链接一键导入 0.1.0 起

如果宠物画廊里有在 PlayPets 中打开这样的链接，点一下就行。链接的形式是 playpets://import?url=<宠物页面地址>。装了 PlayPets 的话，它会先问“要导入这只宠物吗？”并显示链接来自哪个站点；确认后就会导入那只宠物，然后打开邀请标签。如果你运营着画廊，请在宠物页面上加上这个链接。

text

playpets://import?url=https%3A%2F%2Fpetdex.dev%2Fpets%2Fboba

导入宠物窗口 0.1.0 起

点邀请标签上方的导入宠物，会打开一个窗口。有两种方法。

在宠物页面地址里粘贴社区站点的宠物页面地址或 GitHub 宠物文件夹地址，然后点导入。
点从本机文件夹导入，选一个宠物文件夹。

导入完成后，那只宠物会立刻作为伙伴被邀请到乐园。会出现“已导入新宠物并邀请到乐园。”的提示。

文件只从 https 地址下载，并且只从你粘贴的地址所在的站点（及其子域名）下载。如果宠物页面指向其他站点上的文件，就不会导入。

支持的站点 0.1.0 起

发现更多宠物默认折叠，方便找到地址输入框和导入按钮。展开后会显示紧凑的站点列表和导入说明。打开站点，把喜欢的宠物页面地址复制到上面的输入框即可。这些是社区链接，列出站点并不代表合作关系。

站点	站点地址
OpenPets Registry	openpets.sh
Petdex	petdex.dev
Codex PokéPets	github.com/dnnyngyen/codex-pokepets
Awesome Codex Pet	codexpet.top
Codex Pets	codex-pets.net

没有标签的地方也可以：GitHub 上宠物文件夹（含 pet.json 的文件夹）的地址，以及用 codex-pet-share 搭建的站点上的宠物页面地址，同样能导入。

以上站点有专门的导入支持。标记为**（仅浏览）**的发现站点没有专门的导入器，但兼容的通用宠物页面仍可能通过粘贴地址导入。仅添加站点链接不会自动增加导入支持。

地址不对或站点没有响应时，窗口里会显示原因。导入过程中无法关闭窗口。

本机的文件夹 0.1.0 起

用从本机文件夹导入选的文件夹不会被复制，应用会直接读取原位置。所以它会显示在邀请标签的从本机选择的宠物分组里，旁边带着文件夹名。

移动了文件夹，伙伴会等着

伙伴是通过宠物文件夹的路径来识别宠物的。如果移动或删除了选中的文件夹（或拔掉了文件夹所在的硬盘），下次打开应用时，那只宠物的伙伴就没法来到乐园。它不会被删除，而是带着原来的亲密度等着，并会有提示告诉你有几位伙伴在等。把文件夹放回原来的位置，它就会回来。

保存在哪里 0.1.0 起

通过地址导入的宠物，会作为一个文件夹保存在数据文件夹的 pets/ 里。邀请标签的通过地址导入的宠物分组里有打开文件夹按钮，可以直接打开那个文件夹。PlayPets 自带宠物和 Codex 宠物文件夹分组里也有同样的按钮。从本机选择的宠物分组没有这个按钮，而是在每张卡片上写着文件夹名。

导入的宠物的 pet.json 里会一并记录来源。邀请标签的卡片上会用一行显示站点、作者和许可，比如“Petdex · 作者 · CC BY-NC 4.0”。社区宠物是各位作者的作品，请确认许可后再使用。

不再用的宠物，删掉 pets/ 里对应的文件夹就行。用那只宠物做的伙伴会像上面说的那样，从下次启动起在乐园外等着；如果也不想要这位伙伴，请先把它送走。

自己制作

一只宠物就是一个文件夹，里面有 pet.json 和一张精灵图（PNG 或 WebP）。格式和 Codex 宠物相同，所以为 Codex 制作的宠物可以直接使用。

json

{
  "id": "white",
  "displayName": "White",
  "kind": "animal",
  "description": "A puppy.",
  "spriteVersionNumber": 2,
  "spritesheetPath": "spritesheet.webp"
}

精灵图宽 1536px，每格 192×208px，每行 8 格。v1 是 9 行（1872px），v2 是 11 行（2288px）。
v1 的 9 行依次是休息、向右走、向左走、挥手、跳跃、出错、等待、工作、完成。v2 多两行 16 方向的视线，所以在桌面上会用眼睛跟着鼠标。
description 会成为新伙伴最初的性格。

各行的动画和检查规则在开发者文档宠物文件格式里。做好的文件夹可以用从本机文件夹导入直接邀请。

导入宠物 ​

用链接一键导入 0.1.0 起 ​

导入宠物窗口 0.1.0 起 ​

支持的站点 0.1.0 起 ​

本机的文件夹 0.1.0 起 ​

保存在哪里 0.1.0 起 ​

自己制作 ​