把喜欢的角色放到桌面上:DyberPet 免费开源桌宠框架
【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet
深夜十一点,你在任务面板按下"开始专注时间",桌面上的小猫换成专注姿势,头顶浮出番茄钟倒计时;结束的那一刻,金币从它身边抛物线掉落。这是 DyberPet——一个基于 PySide6 的免费开源桌宠框架,把角色动画、养成、任务、商店装进桌面,而不是一张 GIF。动画、存档、模组全部开源,改一个 JSON 就能做出自己的宠物。
项目速览:PySide6 搭出来的桌宠系统
一句话定位:它把桌宠做成了一套带数值、经济系统和任务线的完整框架,你既可以直接玩,也可以照着它做自己的角色。
- 技术栈:Python 3.9+ / PySide6 6.5.2 / PySide6-Fluent-Widgets 1.5.4
- 平台:Windows 有打包 EXE,macOS、Linux 可源码运行
- 许可证:GPL v3(见 LICENSE)
- 版本:EXE 已到 v0.8.5,源码当前开源至 v0.6.7(见 README.md)
- 内置内容:Kitty、ChrisKitty 两个角色,派蒙迷你宠物,以及汉堡、薯条等 4 种默认物品
🐾 跑起来:双击 EXE 或跑一条命令
Windows 用户最省事:从 Release 下载 v0.8.5 的 EXE,双击即可运行,不碰任何命令行。
想读源码或改配置,就 clone 下来跑入口脚本 run_DyberPet.py:
git clone https://gitcode.com/GitHub_Trending/dy/DyberPet cd DyberPet pip install pyside6==6.5.2 PySide6-Fluent-Widgets==1.5.4 apscheduler pynput tendo python run_DyberPet.py建议按 README 用 conda 建一个 Python 3.9.18 的独立环境再装依赖。
启动后出现两个面板:右键角色可打开系统面板(角色管理、基本设置、存档管理),另有一个任务面板,含状态、背包、商店、日常任务、动画管理五个页签。
图注:桌面角色与系统面板、任务面板的布局,背包、商店、任务页签都在右侧面板内
核心功能拆解:喂食、番茄钟、和自制宠物
养成系统:饱食度与好感度
替谁解决什么:让"挂着玩"变成"每天惦记它一下"。
怎么操作:单击角色触发拍拍动作,从背包给角色喂食。
操作后看到什么:饱食度按 0/50/80/100 分成饿昏、饥饿、正常、活力四档,每 2 分钟衰减一次;角色状态直接改变动画池——活力高时大概率走动,饿昏后只播放睡觉动作。好感度上限 200 级,每级需 120 点,动作和物品随等级解锁,升级时右键菜单和角色面板会出现星星、月亮、太阳、皇冠四种徽章。
番茄钟与专注时间
替谁解决什么:把"提醒我休息"包装成宠物行为。
怎么操作:在任务面板的 Focus Session 里设定时长或开番茄钟,角色会自动切到focus专注动画。
操作后看到什么:专注结束或勾选一条待办获得 200 金币,每累计 5 条任务再额外结算 1500 金币,任务完成还会触发物品掉落动画。番茄钟和专注时间各有 6 种开始/结束/取消的独立通知。
MOD 生态:一个文件夹就是一只新宠物
替谁解决什么:想用自己喜欢的角色,不用改一行代码。
怎么操作:把角色文件夹放进res/role/,或在 App 里导入下载的模组。
操作后看到什么:docs/collection.md 收录了社区 12 个角色(纳西妲、魈、流萤等)、6 只迷你宠物和 4 个物品包;迷你宠物会自动排队跟随主角色,可单独开关跟随和掉落。物品支持 buff,例如默认物品里汉堡让饱食度 5 分钟不降、薯条每 30 秒产出 5 金币。
谁适合用:三个具体时段
- 长时间写代码时:开番茄钟,角色切专注姿势,你被"它在等你回来"的机制盯着休息,而不是被弹窗骂。
- 备考刷题时:用专注时间 + 每日目标面板,完成目标按连续天数加发金币,正向反馈直接挂在桌面上。
- 深夜加班时:角色支持昼夜作息,默认 08:00 入夜、23:00 起白天,夜晚自动播睡觉循环,你拍它一下还能触发"被吵醒"反应动画。
🔧 设计亮点:文件夹即模组,配置即内容
关键决策只有一个:所有角色、动作、物品都由 JSON 描述,程序只负责按配置播放。以角色动作为例,res/role/PETNAME/pet_conf.json里这样写:
"random_act": [ {"name": "站立", "act_list": ["stand"], "act_prob": 1.0, "act_type": [2, 0]}, {"name": "睡觉", "act_list": ["sleep"], "act_prob": 1.0, "act_type": [0, 0]} ]收益很直接:美术只需要画带前缀编号的 PNG 帧(如stand_0.png、stand_1.png),写两段 JSON 就能上架一个新角色,docs/art_dev.md 把帧命名、anchor 对齐、昼夜动画等规则都写成了 checklist;程序侧则把动画播放独立成线程,你拖拽、点角色时动画模块自动让位,窗口不会卡死。另一处小设计同样实在:程序用单实例锁禁止多开,从根上避免两个进程抢写同一份存档。
上手建议:备份路径与两个常见坑
- 性能:官方更新日志给出的存档写入耗时约 0.43ms,且程序在退出前会主动存储一次数据,不用手动"存盘"。
- 备份:养成数据都在
data/目录(Windows 在程序目录旁,Linux 在~/.config/DyberPet/),里面有settings.json、pet_data.json、task_data.json等文件;想跨机迁移用面板里的存档导出/导入,导出目录是Documents/DyberPet/Exports,另有 6 个格子的快速存档位于Documents/DyberPet/Saves。 - 坑一:模组文件请用英文命名——官方文档明确记录了繁体中文路径解压后会导致乱码和程序崩溃。
- 坑二:源码版落后于 EXE(v0.6.7 vs v0.8.5),追新功能认准 Release 的 EXE;本地已开着一个 DyberPet 时再启动第二份会静默退出,这是单实例锁的设计行为,不是坏了。
LLM 对话模块仍在开发、暂未完全开源,方向是接大模型让桌宠真正陪你聊。想立刻体验:下载 v0.8.5 的 Windows EXE 双击即可;想造自己的角色,先通读 docs/art_dev.md。
长尾关键词:桌宠养成系统、PySide6 桌面宠物、开源桌宠 MOD 开发、桌面番茄钟专注工具、二次元角色桌面互动框架
【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考