Ark-Pets 明日方舟桌宠：5 分钟让干员住进你的桌面-开发者社区

Ark-Pets 明日方舟桌宠：5 分钟让干员住进你的桌面

【免费下载链接】Ark-PetsArknights Desktop Pets | 明日方舟桌宠 (ArkPets)项目地址: https://gitcode.com/gh_mirrors/ar/Ark-Pets

Ark-Pets 是一款开源的明日方舟桌宠软件，它把游戏里的基建小人、动态立绘和敌方单位带上桌面，让干员能走动、坐下、被你戳一下。项目用 Java 开发、OpenGL 渲染，运行在 Windows 上，官方安装包自带运行环境，不用单独装 JDK。适合想让喜欢的干员在工作学习时一直待在身边的明日方舟玩家。

🚀 跑起来：装安装包、下模型库、启动桌宠

普通用户的路径就四步：

从项目 Releases 页面下载最新的ArkPets-Setup.exe安装包，双击安装；
首次打开启动器，进入"模型"页面，在"模型库管理"面板点击"下载模型"，把社区维护的模型库（2000 多个模型）拉到本地；
按名字、拼音或标签搜索干员，选中后点左下角"启动"；
角色出现在桌面上。想关掉就右键桌宠或托盘图标，选"退出"。

如果你手上已有 JDK17 开发环境，也可以直接拉源码跑起来：

git clone https://gitcode.com/gh_mirrors/ar/Ark-Pets cd Ark-Pets ./gradlew run

它平时会干什么：闲置休息、双屏走动、全屏隐身

你长时间没动鼠标，它自己休息。每只桌宠有独立的行为状态机，会根据你的活跃程度决定下一步动作：你忙它偶尔溜达，你离开一会儿它乖乖坐下。用鼠标点一下桌宠会播放"戳一戳"动画，带特殊基建动作的干员还有概率触发专属动作。

双屏办公时，它会走到另一块屏幕。开启多显示器支持后，桌宠可以被拖到第二块屏，并识别每块屏的边界，不会走出屏幕；它还会站在打开的窗口边缘上，干员立在文档窗口标题栏上方的样子挺有意思。

打游戏全屏时，它自动隐身。托盘菜单里打开"透明模式"，桌宠就和鼠标完全断开交互，点击直接穿透到下层游戏窗口，不会再误戳到干员。

怎么调成喜欢的样子：最常改的 5 个参数

平时最常用到的是启动器"行为"和"选项"两页里的这几个：

参数	位置	作用
允许行走 / 坐下 / 躺下	行为	决定基础动作哪些可用
动作活跃度（1～10 级）	行为	控制桌宠多爱动
行走速度	行为	走多快
多显示屏	行为	能否跨屏活动
高亮描边与阴影	选项	关掉可省性能

重力、摩擦、速度上限这类物理量，以及渲染后端切换，都写在配置文件assets/ArkPetsConfigDefault.json里，默认值一般够用，不用动。

效果长这样：桌宠和桌面融合起来什么样

桌宠窗口是透明且置顶的，叠在桌面上就是"干员坐在你的窗口上"的效果，脚下一点阴影让它看起来站在屏幕里，高亮描边则复现了游戏基建系统的选中特效，一眼能看出哪只刚被你点过。

踩坑与自救：3 个高频问题各一步解决

桌宠窗口背景是黑的：N 卡上高发。到"选项"页渲染设置勾选"Angle 原生渲染"，重启桌宠。
桌宠悬空或卡在桌面上：多半是桌面壁纸、桌面整理类软件干扰了窗口检测，关掉它们；桌宠沉进任务栏的话，在"行为"页手动设置任务栏高度。
模型出现缝合线或异常色块：模型库和软件版本对不上。把 Ark-Pets 和模型库一起更新到最新版。

更多排查可以导出日志：在"选项"页点"导出日志"，程序目录下也有 logs 文件夹存放运行日志。

项目怎么搭的：两个模块加一组着色器

Ark-Pets 拆得比较清楚：core/是核心引擎，管行为状态机、Spine 动画播放、物理模拟和渲染；desktop/是 JavaFX 写的启动器界面和模型下载任务；渲染着色器放在assets/shaders/。Windows 的系统操作被抽象成接口层，macOS 和 Linux 的支持还在开发中。