3 步跑通开源桌面宠物框架 DyberPet:养成、番茄钟与模组
2026/8/24 14:07:11 网站建设 项目流程

3 步跑通开源桌面宠物框架 DyberPet:养成、番茄钟与模组

【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet

在电脑前坐一整天,桌面上除了图标和静态壁纸没什么活物。DyberPet 是一个基于 PySide6 的开源桌面宠物框架,让你喜欢的角色住进桌面:可以拍、可以喂、还能陪你计时干活。

DyberPet 桌面宠物框架主界面:角色管理与状态面板

它能替你解决什么

  • 活着的桌面:点一下启动,角色就出现在屏幕底部,会走动、会拍、会按状态切换动作。
  • 不干扰的专注计时:内置番茄钟与专注时间,结束时有物品掉落和通知,计时过程不弹窗口打断你。
  • 可继承的养成进度:饱食度、好感度随时间累积,按角色独立存档,关机重启不丢。
  • 不用写代码的模组入口:角色、物品、音效都是 JSON 配置加 PNG 序列帧,照着目录放文件即可被识别。

最短路径跑起来

第 1 步,拿到程序。Windows 用户直接取项目 Release 里的打包版,双击 EXE 就能运行;想改配置或扩展功能再走源码路线:

git clone https://gitcode.com/GitHub_Trending/dy/DyberPet

第 2 步,装好依赖再启动。建议用 conda 建一个独立环境,装 PySide6 6.5.2 和配套依赖库;入口文件是根目录的 run_DyberPet.py:

pip install PySide6==6.5.2 PySide6-Fluent-Widgets==1.5.4 apscheduler pynput tendo

第 3 步,第一次互动。启动后角色停在任务栏上方:左键单击触发拍拍动画,按住拖拽把它挪到你喜欢的位置,右键打开菜单,可以换角色、开面板、调大小。

DyberPet 桌面宠物与用户的实时互动过程

核心功能逐个拆解

养成系统:数值决定角色行为

你能得到一个状态实时影响行为的角色。饱食度随时间缓慢下降,掉到零时角色进入饿昏状态、动作明显变少;喂食恢复数值并触发进食动画。好感度则按每次互动累积,升级会解锁新的动作和气泡台词,等级徽章显示在右键菜单与角色面板上。

番茄钟与专注时间:角色陪你干活

你能得到一套不打断专注的计时器。在任务面板里启动番茄钟或专注时间,进度条挂在角色头顶;专注时角色切换为 focus 动作,拍它会出现专属气泡。完成或取消都会按已进行时长结算奖励,锁屏期间数值暂停变化,不白扣饱食度。

背包与商店:格子化管理物品

你能得到一个可拖拽交换格子的背包。角色互动掉落的物品按格存放:食物喂给角色恢复饱食度与好感度,收藏品播放查看动画,多余的去商店卖出换金币。角色可对每种食物设置喜爱或讨厌,喂食后的反应动画和好感倍率都不一样。

对话气泡:角色会主动开口

你能得到一个角色主动说话、流程可以自己设计的对话系统。喂食、升级、频繁点击等事件触发头顶气泡,图标与音效都可配置。想要多分支对话时,按节点把分支条件连起来即可,素材开发文档里附了完整示例:

DyberPet 对话系统的多分支对话设计示例

迷你宠物:加一个跟班

你能得到一个跟着主角色走的小跟班。在同伴菜单召唤迷你宠物,多只会自动排队跟随,可单独调大小、单独收起。被拖开或走出屏幕后它会自动回到角色身边。

进阶玩法:自定义与扩展

新建角色要准备哪些文件

res/role/下放一个角色文件夹,程序启动时会自动扫描并识别:

你的角色名/ ├── pet_conf.json # 角色属性与动作映射 ├── act_conf.json # 帧间隔、循环次数、移动参数 └── action/ # 同前缀按 0、1、2 编号的 PNG 序列帧

pet_conf.json里最少要定义 default(待机)、drag(拖拽)、fall(下落)三个动作,缺的动作会用待机帧自动补齐;走路类动画在act_conf.json里加上方向与每帧位移参数就行。

新增一个物品只要几行配置

编辑res/items/Default/items_config.json,一个物品只需声明数值效果和图片:

"魔法汉堡": { "effect_HP": 10, "effect_FV": 3, "image": "15_burger.png" }

改数值控制恢复量,加 buff 字段还能让物品附带限时效果,比如暂停饱食度下降或定时掉金币。

现成模组去哪里找

素材合集按角色、迷你宠物、物品包三类列出了社区已发布的模组,下载后按面板里的指南导入即可使用。

常见问题速查

问题对应解法
角色不显示检查角色文件夹是否齐了 pet_conf.json、act_conf.json 与动作帧前缀
互动无响应确认只运行了一个实例,程序禁止多开以防存档写坏
素材解压后乱码文件名统一改成英文,部分中文环境解压会导致路径异常
角色悬浮在任务栏上方给对应动作在 act_conf.json 里补 anchor 参数做位置偏移
换角色后进度没了存档按角色独立,到系统面板分别导出、导入即可

下一步做什么

  1. 先用打包版喂几天内置角色,熟悉数值下降的节奏。
  2. 源码运行后打开 Kitty 的 act_conf.json,把某动作的帧间隔改一次,看播放速度变化。
  3. 按 art_dev.md 的目录结构,为你的第一个原创角色放好序列帧和两个配置文件。

框架基于 PySide6,Windows 与 macOS 均已验证可用,Linux 从源码运行即可。

【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询