Skip to content

Repository files navigation

maodie-pet

maodie-pet 是一款桌面宠物应用。它把 Live2D 角色放在桌面上,提供互动、状态养成、聊天、动作表情和生活场景等功能,适合作为常驻桌面的陪伴工具。

当前版本为测试版,近期暂无更新计划。

截图展示

主窗口

状态面板

设置窗口1

设置窗口2

生活中心

带装饰的主窗口

动作面板

动画编辑面板

动画编辑面板2

主要功能

  • 桌面宠物:在桌面显示 Live2D 角色,支持拖动、显示/隐藏和基础交互。
  • 状态面板:查看金币、今日收入、点击、按键、工作时长和角色状态。
  • 养成系统:包含心情、清洁、饱食度、亲密度等属性变化。
  • 桌面行为:支持鼠标追逐、散步、待机反馈等陪伴行为。
  • 动作与表情:可以触发内置动作、表情和自定义动画。
  • 聊天窗口:提供对话记录和桌面陪伴聊天入口。
  • 生活中心:物品购买、宠物装饰、互动数据查看。
  • 设置窗口:支持模型、行为、热键、工作收益和界面相关配置。
  • 系统托盘:提供快速打开、隐藏和退出等常用操作。

使用说明

主窗口与菜单

  • 鼠标悬停在桌面宠物附近会显示普通菜单,可快速打开抚摸、背包、聊天、生活中心和状态等入口。
  • 右键点击桌面宠物会打开右键菜单,可进入动作 / 表情、动画编辑、生活中心、设置,或退出应用。
  • 如果开启了桌面装扮,菜单会显示在装扮之上;右键菜单层级最高,适合在装饰较多时使用。

动画编辑

  • 从右键菜单进入“动画编辑”,窗口内分为“动作 / 表情预览”和“独立动作配置”两个页面。
  • 在“动作 / 表情预览”里可以查看当前 Live2D 模型自带的参数、动作和表情;选择动作或表情后,可在右侧修改显示名称、设置待机动作或绑定事件。
  • 参数分组支持双击改名:在参数页双击左侧分组标签,输入新名称后按 Enter 或点击别处保存,按 Esc 取消。
  • 在“独立动作配置”里,先新建分类,再在分类下新增动作;动作名称、FPS、分类、播放方式和待机设置都在右侧属性区修改。
  • 自定义分类通过分类标题右侧的“重命名”按钮改名;自定义动作可以复制、删除、批量导出或批量删除。
  • 轨道参数可以双击添加到时间轴,也可以拖拽到时间轴;时间轴上的关键帧用于控制参数随帧变化。
  • 修改完成后点击“保存动作”才会写入当前模型配置;删除动作或分类前会提示确认,部分编辑可用 Ctrl+Z 撤销。

事件绑定

  • 事件绑定用于决定“发生某个交互时播放哪个动作或表情”。例如“被点击”可以绑定一个惊讶动作,“投喂”可以绑定吃东西动作,“开心”可以绑定高兴表情。
  • 内置动作、内置表情和自定义动作都可以绑定事件;在动画编辑里选中目标后,在右侧“事件绑定”下拉框选择事件即可。
  • 一个事件同一时间只能绑定到一个目标。把事件绑定到新的动作 / 表情时,旧绑定会被排除,避免同一事件触发多个反馈。
  • 点击已经添加的事件标签可以移除绑定。
  • 常见可绑定事件包括:出现、隐藏、被点击、被拖拽、打开菜单、被摸摸、投喂、聊天、开始干活、干活中、干活结束、开始散步、停止散步、开心、难过、生气、安心、得意和疲惫。

生活中心与装扮

  • 从普通菜单或右键菜单进入“生活中心”,可以查看状态、互动数据、物品和装扮。
  • 在装扮页可以为当前模型配置背景和前后景装饰;装饰分为宠物后方和宠物前方两层。
  • 编辑装饰时可选中图层调整位置、缩放和旋转;导入背景或装饰后建议回到主窗口检查显示效果。

技术栈

  • Tauri 2
  • Vue 3
  • Vite
  • Pinia
  • Pixel UI
  • PixiJS / Live2D
  • Rust

模型素材来源

模型素材来源

本地运行

安装依赖:

yarn install

启动开发环境:

yarn tauri:dev

运行前端开发服务:

yarn dev

运行测试:

yarn test

许可证

本项目基于 MIT License 开源,详见 LICENSE

About

一个关于live2d的桌宠

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages