Skip to content

Commit

Permalink
docs: update user docs
Browse files Browse the repository at this point in the history
  • Loading branch information
isHarryh committed Nov 19, 2024
1 parent 7af58f0 commit d90a511
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 28 deletions.
28 changes: 14 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,13 +49,13 @@ ArkStudio 是正在开发阶段的,功能更加强大的《明日方舟》游
## 使用方法 <sub>Usage</sub>

### 1.资源准备
无论您是想要使用我们的发行版本还是源代码来解包明日方舟的游戏资源,您都需要先获取到明日方舟的资源文件。明日方舟是基于Unity开发的游戏,它的游戏资源会全部打包到一种 **AssetBundle文件**(后缀名 `.ab`,下简称“AB文件”)中。
无论您是想要使用我们的发行版本还是源代码来解包明日方舟的游戏资源,您都需要先获取到明日方舟的资源文件。明日方舟是基于Unity开发的游戏,它的游戏资源会全部打包到一种 **AssetBundle文件**(后缀名 `.ab`,下简称“AB文件”,但少数情况下后缀名是 `.bin`)中。

下面将以 **Android 安卓系统** 为例讲述**如何获取到明日方舟的 AB 文件**。明日方舟的游戏资源有 **2 个部分**
- 一部分是通过**安装包**`.apk`)提供的,从明日方舟[**官网**](https://ak.hypergryph.com)将其下载到本地后,使用压缩文件查看工具打开(后缀名改成 `.zip` 后打开),然后把里面的 `assets\AB\Android` 文件夹解压出来;
- 另一部分是通过**热更新**提供的,首先确保您的安卓手机上的明日方舟更新到了最新版本,然后(推荐使用 USB 数据线)将手机存储的 `Android\data\com.hypergryph.arknights\files\AB\Android` 文件夹(一般情况下是这个路径)复制到电脑上(重命名为 `Android(2)`)。至此,我们的目录结构大致如下:
> **你的目录**
> ├─Android
> **你的目录**
> ├─Android
> └─Android(2)
最后,将 `Android(2)` 文件夹里的内容复制到 `Android` 中,并**覆盖**同名文件,就能得到完整的游戏资源。在这之后,您就可以使用我们的程序来解包其中的游戏资源了。
Expand All @@ -74,20 +74,20 @@ ArkStudio 是正在开发阶段的,功能更加强大的《明日方舟》游

### 4.示例用法
首先,将需要解包的文件夹(可以是多个)放到与 exe 相同的目录下,至此,我们的目录结构大致如下:
> **你的目录**
> ├─Android (解包整个目录需要很久)
> ├─charpack (可以选择解包部分文件夹)
> **你的目录**
> ├─Android (解包整个目录需要很久)
> ├─charpack (可以选择解包部分文件夹)
> └─ArkUnpacker.exe
然后运行 exe,弹出交互式命令行界面如下,依据其提示操作即可:
> 欢迎使用ArkUnpacker
> 模式选择:
> 1: 一键执行
> 2: 自定义资源解包
> 3: 自定义图片合并
> 4: 自定义文本资源解码
> 5: ArkModels提取与分拣工具
> 0: 退出
> 欢迎使用ArkUnpacker
> 模式选择:
> 1: 一键执行
> 2: 自定义资源解包
> 3: 自定义图片合并
> 4: 自定义文本资源解码
> 5: ArkModels提取与分拣工具
> 0: 退出
> 输入序号后按回车即可,如果您不清楚以上功能的含义,强烈建议您先阅读使用手册(README)
各模式的功能概述如下:
Expand Down
24 changes: 10 additions & 14 deletions docs/AssetsGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,17 @@ ArkUnpacker附加说明文档

> **注意:**
> - 请在合理范围内使用本程序。根据BSD3许可证,对于非法使用本程序解包出来的资源造成的侵权行为,作者不承担相应责任。
> - 以下内容是基于 **Android `v2.3.81`** 的《明日方舟》编制的,不同版本客户端的特定资源的具体位置可能存在较大差异。
> - 以下内容是基于 **Android `v2.4.01`** 的《明日方舟》编制的,不同版本客户端的特定资源的具体位置可能存在较大差异。
> - 此文档内的所有内容均为作者独立整理,仅供参考,如需转载请注明出处。

## 资源导览
各个子目录储存的资源的内容:

**Android**
├─[activity](#activity) / 活动
├─[arts](#arts) / 图片
├─[activity](#activity) / 活动
├─anon / 匿名数据
├─[arts](#arts) / 美术图片
├─[audio](#audio) / 音频
├─[avg](#avg) / 剧情图
├─[battle](#battle) / 战斗相关
Expand All @@ -22,10 +23,8 @@ ArkUnpacker附加说明文档
├─climbtowerseasons / 保全派驻
├─config / 配置
├─crisisv2longterm / 新版危机合约
├─gamedata / 游戏数据
├─cutin / 角色插入
├─graphics / 图形渲染
├─[hotupdate](#hotupdate) / 热更新相关
├─[i18n](#i18n) / 多语言(国际化)
├─npcpack / NPC
├─[prefabs](#perfabs) / 预设文件
├─raw / 未打包文件(例如视频)
Expand All @@ -36,9 +35,12 @@ ArkUnpacker附加说明文档
├─[spritepack](#spritepack) / 图标
└─[ui](#ui) / 用户界面

> **提示**
> **重要变更**
> 1. 在明日方舟`v1.8.01`及之前版本中,干员默认皮肤的立绘、基建小人和战斗小人全都位于`charpack`中。而在之后的版本中,立绘和基建小人被转移到了`chararts`中存放。
> 2. 解包只是解包AB文件。这意味着像`raw/video/`里的部分非AB文件不会放到解包后文件夹中,所以请在原始文件中查找它们。
> 2. 在明日方舟`v2.3.81`及之前版本中,游戏数据文件位于`gamedata`目录,热更新开屏素材位于`hotupdate`目录,国际化数据位于`i18n`目录。而在之后的版本中,这些数据都被转移到了`anon`中作为匿名文件存放,并且后缀名被更改为`.bin`
> **提示:**
> 解包只是解包AB文件。这意味着像`raw/video/`里的部分非AB文件不会放到解包后文件夹中,所以请在原始文件中查找它们。

## 常用资源定位
Expand Down Expand Up @@ -97,12 +99,6 @@ ArkUnpacker附加说明文档
- `building/ui/[uc]diy.ab` 基建房间装扮模式UI
- `building/vault/[uc]arts.ab` 基建功能室Sprite

### Hotupdate
- `hotupdate/[uc]worldtips.ab` 热更新时背景图(开屏图)

### I18n
- `i18n/string_map.ab` 字符串映射表

### Perfabs
- `prefabs/shop/shopkeeper/` 可露希尔
- `prefabs/gacha/` 干员寻访相关
Expand Down

0 comments on commit d90a511

Please sign in to comment.