Wi-Fi · 自定义宠物

让喜欢的角色,
住进你的桌面。

一张序列图,一份小小的配置。
把你画的角色,变成每天陪伴你的桌面伙伴。

开始制作 从一个文件夹开始
01

准备一个新朋友

一个宠物就是一个文件夹。文件夹的名字,也是它在宠物菜单里的名字。准备好下面两份文件,就可以开始了。

  1. 1

    画好每一帧

    把动作按顺序排成序列图,每帧大小一致,推荐使用透明背景。

  2. 2

    写一份配置

    用 config.json 告诉 Wi-Fi 每帧多大、动作在哪一行、播放多快。

  3. 3

    放入并选择

    放进自定义宠物目录,重新打开宠物菜单,选择你的角色。

02

用 AI 制作宠物

还没有序列图?OpenAI 的 hatch-pet skill 可以帮你生成角色、制作九行动画,再检查画面和动作。本页提供完整 skill 下载,以及适合 Wi-Fi 的配置。

这套流程在支持 imagegen 图像生成的 Codex 环境中使用,还需要 Python、Pillow 和 jq。安装 skill 后,先让 Codex 检查依赖;普通聊天窗口不一定能执行这些步骤。
  1. 下载 skill,准备一个工作文件夹

    下载 ZIP 并解压,把完整的 hatch-pet 文件夹放进一个在 Codex 中打开的工作目录。保留里面的脚本和参考文件。

  2. 请 Codex 安装并检查

    在这个工作目录的对话里,复制下面这句话。Codex 会按 skill 的说明确认安装位置和依赖。

    安装提示词
    请将当前工作目录里的 hatch-pet 文件夹安装到我的用户级 Codex skill 目录,保留完整的 SKILL.md、scripts 和 references。请按 SKILL.md 的路径约定确认脚本位置,并检查 imagegen、Python(含 Pillow)和 jq 是否可用。
  3. 说说你想要的桌面伙伴

    安装后,在新一轮对话中用 $hatch-pet 开始。可以附上自己的参考图,描述角色、风格和动作;下面以雪豹为例。

    雪豹示例 · 按你的想法修改
    $hatch-pet 帮我制作一只可爱的雪豹桌面宠物,毛茸茸、尾巴蓬松,动作轻松有趣。如有我附上的参考图,请保持角色外观一致。使用透明背景,制作完整的九行动画,单帧 192×208 像素,按 8 列×9 行排列。请检查每帧位置、动作连贯性和未使用格子的透明度,给我看预览,并交付最终的 spritesheet.webp。我会搭配 Wi-Fi 的 config.json 使用。

    跟随 Codex 确认角色和动画预览,完成后取用最终的 spritesheet.webp。本页提供的 skill 输出为 1536×1872 像素,无需为 Wi-Fi 重新裁切。

  4. 带它来到 Wi-Fi 桌面

    下载配套 config.json,与最终的 spritesheet.webp 一起放入当前账号的 pets/custom/我的雪豹/。重新打开宠物菜单,选择“我的雪豹”即可。完整账号路径见下一节。

    我的雪豹文件夹
    我的雪豹/
    ├── spritesheet.webp
    └── config.json

    pet.json 是 Codex 的宠物说明文件,不能改名替代 Wi-Fi 的 config.json。游戏需要的是上面这两份文件。

九行动画怎样对应 Wi-Fi?

hatch-pet 的行号从 0 开始,Wi-Fi 的 row 从 1 开始。下载的配置已接好待机、鼠标经过和左右拖动等动作;想自行调整时,可对照下表。

hatch-pet 与 Wi-Fi 动画行对应
Wi-Fi 行号hatch-pet 行号动作帧数
10待机6
21向右跑8
32向左跑8
43挥手4
54跳跃5
65失败或沮丧8
76等待6
87忙碌工作6
98查看、思考6

Wi-Fi 按配置的 fps 播放整行动画,不读取 Codex 的逐帧时长。每行只填写实际帧数,避免把未使用的透明格也播放出来。

了解更多:OpenAI hatch-pet 上游 ↗ · Codex skills 官方说明 ↗

03

给它一个小家

在当前账号的 pets/custom/ 目录里,新建一个以宠物名字命名的文件夹。

macOS

~/Library/Application Support/com.wangyifang.Wi-Fi/<账号>/pets/custom/

Windows

%LOCALAPPDATA%\com.wangyifang.Wi-Fi\<账号>\pets\custom\

<账号> 指当前 Steam 账号的数字目录;未连接 Steam 时为 local。macOS 可在访达按 ⌘ ⇧ G 前往路径,Windows 可在文件资源管理器地址栏输入路径。

文件夹里放这两份文件
我的宠物/
├── spritesheet.png
└── config.json
序列图支持 PNG、WebP、GIF、JPG 和 JPEG。透明 PNG 或 WebP 更适合桌面宠物;图片文件名需要与配置中的 spritesheet 一致。
04

让角色动起来

先从一行动画开始:下面的企鹅有 6 帧,每帧 192×208 像素,所以整张序列图是 1152×208 像素。

同一只红围巾像素企鹅的六帧动作,从左到右排列
把一连串小动作,排成一张图。每一格保持相同尺寸,角色在格子里的位置也尽量一致。

将下面的内容保存为 config.json,和对应的序列图放在一起。换成自己的素材时,记得修改帧尺寸和帧数。

config.json · 一行六帧示例
{
  "spritesheet": "spritesheet.png",
  "frame": { "width": 192, "height": 208 },
  "scale": 0.5,
  "fps": 6,
  "animations": {
    "default": { "row": 1, "frames": 6, "fps": 6, "mode": "once" }
  }
}
配置字段说明
frame单帧宽高,不是整张序列图的宽高。
scale桌面显示比例。0.5 表示按单帧尺寸的一半显示。
row / frames动画所在行与这一行使用的帧数。行号从 1 开始。
fps / mode每秒播放多少帧。once 播放一次;loop 循环到状态切换。

多一些动作

在序列图增加新的一行,就可以为 hover、dragLeft、dragRight 配置不同动作。上面的最小示例中,未单独配置的状态也会使用这一行动画。

换好后,再打开菜单

保存文件后,重新打开宠物菜单,让 Wi-Fi 重新扫描,再选择你的宠物。每次修改都可以这样预览。

05

遇到一点小问题

菜单里没有出现我的宠物?

先确认放在了当前账号的 pets/custom/我的宠物/ 中,再检查图片文件名与配置是否一致、JSON 是否有效。最后重新打开宠物菜单。

角色被切开,或者动作跳来跳去?

检查 frame.width、frame.height 是否为单帧尺寸,row、frames 是否与序列图对应。每一帧中的角色位置也应保持一致。

可以省略 config.json 吗?

只有素材恰好符合内置默认布局时才适用。制作自己的角色时,建议保留配置,明确填写帧尺寸和动画布局。

为什么有一块背景,或者鼠标命中区域不合适?

导出图片时保留透明通道,不要把棋盘格画进图片。需要更精细的鼠标命中范围时,可在配置中用 interaction.hitMaskRow 指定专用命中行。

继续翻一页也为游戏画一枚准星