Skip to content

Repository files navigation

Ark-Pets

ArkPets icon

Arknights Desktop Pets | 明日方舟桌宠 (ArkPets)

GitHub Latest Release GitHub Stars


GitHub Top Language GitHub License Code Factor Grade GitHub Workflow Status

🔗官方网站 | Official Website

This project only supports Chinese docs. If you are an English user, feel free to contact us.

介 绍 Intro

实现的功能

  1. 支持将《明日方舟》角色模型作为桌宠启动。
    查看详情 现已支持的模型类型包括:
    1. 干员基建小人(含时装);
    2. 干员动态立绘(含时装);
    3. 敌方战斗小人。
  2. 启动器提供图形用户界面以便浏览模型和调整各种设置。
    查看详情
    1. 可以按名称、拼音、时装品牌搜索,或按类别筛选以查找模型;
    2. 可以从互联网中下载由社区维护的模型库;
    3. 可以自定义桌宠的动作交互、部署位置和物理参数等行为设置;
    4. 可以自定义桌宠的图像缩放、最大帧率和窗口边界等显示设置。
  3. 支持模拟游戏内干员基建小人的行为。
    查看详情
    1. 支持行走、坐下和躺下的动作;
    2. 能够被鼠标交互以执行戳一戳动作;
    3. 拥有特殊基建动作的干员,有概率触发这类动作。
  4. 支持模拟游戏内敌方小人的行为。
    查看详情
    1. 拥有行走动作的敌人能够行走;
    2. 拥有攻击动作的敌人能够被鼠标交互。
  5. 实现了模拟平面重力场
    查看详情
    1. 桌宠支持自由落体等物理现象;
    2. 桌宠可以被拖拽到扩展显示屏上;
    3. 桌宠可以站立在打开的窗口的边缘上。
  6. 实现了系统托盘的菜单
    查看详情
    1. 右键托盘图标或者桌宠本体均可弹出菜单;
    2. 菜单可用于开启手动模式和启用透明模式;
    3. 菜单可用于切换多形态角色的形态;
    4. 菜单可用于退出启动器或单个桌宠;
    5. 启动器运行时,已启动的桌宠将被整合到一个托盘中;
    6. 启动器若没有运行,每个桌宠将分别创建自己的托盘。
  7. 支持开机自启动等更多特性

效果预览图

demo1 demo2 demo3

下一步计划

以下内容可能在遥远的将来被实现:

  • 国际化与响应布局
  • 支持按需下载资源
  • 支持干员语音功能
  • 全面更新依赖库的版本
  • 支持透明模式等配置的记忆

常用文档

使用方法 Usage

目前仅支持 Windows 7 及以上的图形操作系统。

快速上手

  1. 前往此页面下载最新的 ArkPets-Setup.exe 安装包。
  2. 运行安装包并进行软件的安装。安装完成后,打开 ArkPets 启动器。
  3. 首次使用时需要下载模型文件。请在启动器 “模型” 页面中的 “模型库管理” 面板点击 “下载模型” 按钮。
  4. 在启动器 “模型” 页面中检索并选中想要作为桌宠启动的角色,最后点击左下角 “启动” 按钮即可生成桌宠。

提示:

  • 如需关闭已启动的桌宠,请右键单击桌宠或系统托盘中的 ArkPets 图标,然后选择 “退出”。
  • 若无法在软件内下载模型,可以访问 ArkModels 模型仓库 页面,手动下载模型压缩包后,在 “模型库管理” 面板点击 “导入压缩包” 按钮后导入模型。
  • 如需将软件从 v2.x 或 v3.x 更新到更高版本,无需预先手动卸载,直接运行新版安装包即可。

更多特性

以下列出了 ArkPets 的一些精彩特性,更多内容请在启动器中自行探索。

桌宠相关

  • 开机自启动 :在启动器 “选项” 中可以设置开机自启动,设置后下一次电脑开机会自动生成最后一次启动的桌宠。
  • 手动模式 :托盘菜单中可以开启 “手动模式”,允许用户使用左右方向键来控制桌宠移动,或使用上下方向键来切换桌宠的动作。
  • 透明模式 :为防止用户在游戏、观看视频等情景下误触到桌宠,只需在托盘菜单中打开 “透明模式”,即可屏蔽桌宠和鼠标的一切交互(鼠标操作将穿透到下层窗口)。
  • 下边界距离 :桌宠在部分用户的电脑上无法正常检测任务栏位置(桌宠会沉入任务栏),此时您可以在 “行为” 页面手动设置任务栏高度。
  • 高亮描边与阴影 :高亮描边效果旨在复现游戏中基建系统的角色选中特效,阴影效果则提供了更加立体的视觉体验。在启动器 “选项” 中禁用这两种渲染特效可以降低性能消耗。

启动器相关

  • 公告栏 :点击侧边栏中的 “公告” 按钮即可打开公告栏,用于显示更新日志等帮助信息。每次启动器启动时,如果发现有未读的重要公告,公告栏会自动弹出。
  • 模型库联网下载与更新 :在启动器 “模型” - “模型库管理” 面板中,您可以下载模型库和检查模型库更新。
  • 软件更新 :在启动器 “选项” 页面中,您可以检查软件更新并安装更新。
  • Mirror 酱接入 :我们从 v3.9 版本开始接入了 Mirror 酱,以提供高速的内容下载体验。

高级用法

快速上手中介绍的是最简单和普遍的使用方法。除此之外:

  • 您还可以下载 zip 版的程序压缩包解压,实现免安装使用。
  • 如果您的电脑上存在 JDK17Java 运行环境,您还可以下载 jar 版的程序文件直接运行(但无法使用开机自启动功能)。
  • 如果您想用命令行启动桌宠,点击查看说明。
  • 如果您想添加自定义的模型,点击查看说明。
  • 如果您想使用直播流软件捕捉桌宠窗口,可以在启动器 “选项” 页面禁用 “桌宠作为后台程序启动”。

目前本程序不支持在其他操作系统运行。好消息是,对于 MacOS 和 Linux 的支持已处于开发阶段,敬请期待。

关 于 About

鸣谢

感谢所有曾经为 ArkPets 的开发提供过各种形式的帮助的个人和组织。

许可证

本项目基于 GPL3协议。任何人都可以自由地使用和修改项目内的源代码,前提是要在源代码或版权声明中保留作者说明和原有协议,且使用相同的许可证进行开源。

参与贡献

您可以通过提交 Issues 等各种方式参与本项目的贡献。 提交 Issues 前,请确认您的议题与已有的议题不重复。提交 Issues 时,请您完整地填写议题模板。

友情链接

以下项目是 ArkPets 的关联或衍生项目:


GitHub Star History

Star History Chart

About

Arknights Desktop Pets | 明日方舟桌宠 (ArkPets)

Topics

Resources

Stars

1.1k stars

Watchers

2 watching

Forks

Releases

Used by

Contributors

Languages