diff --git a/.gitignore b/.gitignore index 8131947..72b5abf 100644 --- a/.gitignore +++ b/.gitignore @@ -3,4 +3,5 @@ node_modules/ # vitepress-cache .vitepress/cache -.vitepress/dist \ No newline at end of file +.vitepress/dist +.idea \ No newline at end of file diff --git a/.vitepress/config.mts b/.vitepress/config.mts index 18bfc17..7498fd5 100644 --- a/.vitepress/config.mts +++ b/.vitepress/config.mts @@ -16,6 +16,13 @@ export default defineConfig({ { text: '游戏用户指南', items: [ + { + text: '安装', + items: [ + { text: 'IOS', link: '/docs/user_guide/installation/ios' }, + { text: 'Android', link: '/docs/user_guide/installation/android' }, + ], + }, { text: '游戏内使用说明', link: '/docs/user_guide/client_docs' }, { text: 'WebUI使用说明', link: '/docs/user_guide/user_webui' }, { text: '游戏相关信息', link: '/docs/user_guide/game_info' }, @@ -36,10 +43,8 @@ export default defineConfig({ ], }, { text: 'WebUI', link: '/docs/dev_guide/WebUI' }, - { text: '获取和安装预打补丁的游戏安装包', link: '/docs/dev_guide/patch_client' }, { text: '游戏资源服务器配置', link: '/docs/dev_guide/assets_docs' }, { text: '环境变量和命令行参数', link: '/docs/dev_guide/variable-argument' }, - ] } ] diff --git a/docs/dev_guide/WebUI.md b/docs/dev_guide/WebUI.md index 1a81f1c..4a446e5 100644 --- a/docs/dev_guide/WebUI.md +++ b/docs/dev_guide/WebUI.md @@ -118,5 +118,5 @@ docker run -d \ 1. 使用命令行参数`--global-android `、`--japan-android `、`--global-ios `、`--japan-ios `或环境变量`ANDROID_GLOABL`、`ANDROID_JAPAN`、`IOS_GLOBAL`、`IOS_JAPAN`设置帮助界面中的应用下载地址。 2. 使用命令行参数`--assets-url `或环境变量`ASSET_URL`设置帮助页面中显示的“Assets URL”。 ![帮助页面注意事项](../image/webui_help_info.png) -3. 如何获取预打补丁的apk安装包和ios安装包，请参考[获取和安装预打补丁的游戏安装包](./patch_client#patch) +3. 如何获取预打补丁的apk安装包和ios安装包，请参考[获取和安装预打补丁的游戏安装包](patch_client.md#patch) ::: \ No newline at end of file diff --git a/docs/dev_guide/assets_docs.md b/docs/dev_guide/assets_docs.md index 1d95a23..9a47183 100644 --- a/docs/dev_guide/assets_docs.md +++ b/docs/dev_guide/assets_docs.md @@ -11,10 +11,16 @@ outline: deep 一个启动游戏资源服务器的典型命令为： - Windows +::: warning 注意 +需要先下载[ew](./installation/windows.md)二进制文件 +::: ``` ew.exe --enable-asset-server --port 8080 --path ./data/ --asset-port 8000 --asset-path ./asset/ --max_time 1736076211 ``` - Linux +::: warning 注意 +需要先下载[ew](./installation/linux.md)二进制文件 +::: ``` ./ew --enable-asset-server --port 8080 --path ./data/ --asset-port 8000 --asset-path ./asset/ --max_time 1736076211 ``` diff --git a/docs/image/30.png b/docs/image/30.png new file mode 100644 index 0000000..641c76d Binary files /dev/null and b/docs/image/30.png differ diff --git a/docs/image/31.png b/docs/image/31.png new file mode 100644 index 0000000..ed16ca3 Binary files /dev/null and b/docs/image/31.png differ diff --git a/docs/image/32.png b/docs/image/32.png new file mode 100644 index 0000000..48c6e5d Binary files /dev/null and b/docs/image/32.png differ diff --git a/docs/image/33.png b/docs/image/33.png new file mode 100644 index 0000000..76e0f5d Binary files /dev/null and b/docs/image/33.png differ diff --git a/docs/image/assets_error.png b/docs/image/assets_error.png new file mode 100644 index 0000000..8cc3ccb Binary files /dev/null and b/docs/image/assets_error.png differ diff --git a/docs/user_guide/client_docs.md b/docs/user_guide/client_docs.md index a23a5d3..812871c 100644 --- a/docs/user_guide/client_docs.md +++ b/docs/user_guide/client_docs.md @@ -7,15 +7,34 @@ outline: deep 安装应用后需要进行一定的设置才可以进入游戏。 1. 打开手机设置，下滑找到APP。 -![设置](../image/10.png) +
+ 设置 +
2. 进入APP，下滑找到スクフェス２。 -![APP](../image/11.png) +
+ APP +
3. 进入スクフェス２，下滑找到Server URL和Assets URL。 -![スクフェス２](../image/12.png) +
+ スクフェス２ +
4. 填入服务器网址和资源服务器网址。 +::: danger 警告 +图片中的Server URL仅作为示例，使用时请咨询你的服主具体怎么填写 +::: + ## 通用操作 {#general-use} +### 下载资源包时发生异常 {#assets-error} +![资源异常](../image/assets_error.png) +因为Assets URL是国外CDN，中国大陆地区的访问链接不是很好 +- 有条件的话，可以通过科学上网的方式 +- 使用[本地搭建资源服务器](../dev_guide/assets_docs.md)的方式 +::: danger 警告 +方法2中，由于游戏内资源是动态加载的，所以切歌等一系列操作如果在非本地环境下仍然会出现此问题 +::: + ### 查看Sif2 ID {#sif2-id} 1. 在游戏主界面，点击右上角的菜单。 ![主界面](../image/1.png) diff --git a/docs/dev_guide/patch_client.md b/docs/user_guide/installation/android.md similarity index 58% rename from docs/dev_guide/patch_client.md rename to docs/user_guide/installation/android.md index 9715bb5..f527b98 100644 --- a/docs/dev_guide/patch_client.md +++ b/docs/user_guide/installation/android.md @@ -1,15 +1,8 @@ --- outline: deep --- -# 获取和安装预打补丁的游戏安装包 {#patch} - -## iOS -得益于Discord的Triangle，你只需下载对应的ipa文件即可。然后将该ipa文件侧载安装手机上即可。 -- [国际服](https://arasfon.ru/direct/lovelive/sif2/patched-clients/ios/sif2_gl.ipa) -- [日服](https://arasfon.ru/direct/lovelive/sif2/patched-clients/ios/sif2_jp.ipa) - -## Android -获取Android的预打补丁的游戏安装包较为麻烦，下面将详细介绍如何获取游戏安装包。 +# Android +本节介绍如何在Android上安装sif2。 ### 获取原版游戏安装包(可选) @@ -18,18 +11,33 @@ outline: deep - [日服](https://arasfon.ru/direct/lovelive/sif2/server-patcher/base-apks/sif2_jp_base_hlow.apk) ### 给原版安装包打补丁 - 1. 打开[LLSIF2 Server Patcher](https://arasfon.ru/sif2/patcher/)。 2. 打开使用自定义apk，将apk拖入上传框中。（可选） -3. 将服务器URL输入到API URL中。 +3. 将Server URL输入到API URL中。 4. 将资源服务器URL输入到Assets URL中，一个可选的资源服务器为https://sif2.sif.moe 。 5. 选择游戏版本。 6. 更改头部格式（Header format）为Lowercase。 7. 点击修补（Patch）。 8. 下载修补好的安装包文件。 - -![patch](../image/27.png) + +:::tip 注意 +Server URL的获取请咨询服主 +::: + +![patch](../../image/27.png) ### 给修补好的安装包文件签名 -使用[uber-apk-signer](https://github.com/patrickfav/uber-apk-signer?tab=readme-ov-file)给安装包签名。具体操作可参考uber-apk-signer项目说明。 \ No newline at end of file +使用[uber-apk-signer](https://github.com/patrickfav/uber-apk-signer/releases/download/v1.3.0/uber-apk-signer-1.3.0.jar)给安装包签名。 +1. 安装[JDK8+](https://adoptium.net/temurin/releases/) +![JDK](../../image/32.png) +```shell +java -jar uber-apk-signer-1.3.0.jar --apks sif2_patched.apk +``` +:::tip 注意 +jar和apk路径位置请根据自己的情况修改 +::: +![打包](../../image/33.png) + +### 传入手机安装 +基本操作，不展开说明 \ No newline at end of file diff --git a/docs/user_guide/installation/ios.md b/docs/user_guide/installation/ios.md new file mode 100644 index 0000000..c81bec7 --- /dev/null +++ b/docs/user_guide/installation/ios.md @@ -0,0 +1,43 @@ +--- +outline: deep +--- +# iOS +本节介绍如何在iOS上安装sif2。 + +:::tip 注意 +使用自己的id自签，每7天需要重新签名安装。 + +当提示APP不可用时，切忌删除APP，一旦误删则数据丢失产生的后果由用户自己承担。 + +服主当前提供开发者超级签服务，每个设备10rmb，可一年内免复签操作，需要加QQ群：765206475。 +::: + +### 安装包下载 +得益于Discord的Triangle，你只需下载对应的ipa文件即可。然后将该ipa文件侧载安装手机上即可。 +- [国际服](https://arasfon.ru/direct/lovelive/sif2/patched-clients/ios/sif2_gl.ipa) +- [日服](https://arasfon.ru/direct/lovelive/sif2/patched-clients/ios/sif2_jp.ipa) +:::tip 注意 +下面的安装以日服为例 +::: + +### 使用Sideloadly（IOS17+使用——7天需电脑重新签名） 推荐 +[下载地址](https://sideloadly.io/) +1. 按照电脑平台选择下载链接。 +![Sideloadly URL](../../image/30.png) +2. 打开Sideloadly +![安装](../../image/31.png) +- Step1：拖入准备好的ipa文件。 +- Step2：使用USB连接苹果设备。 +- Step3：输入你的苹果ID。 +- Step4：打开高级选项（可选）。 +- Step5：如果设备中存在官服Sif2 APP，这里需要填写一个与官服包名相异的字符串，这里推荐使用。 +```markdown +com.bushiroad.lovelive.sif2 +``` +- Step6：点击Start执行安装。 + +### 使用巨魔商店（IOS17-使用） 推荐 +待补充 + +### 使用SideStore（IOS17+使用——7天手机自动续签） +目前SideStore部分手机不可用，bug较多，暂不对应教程，可自行研究。 \ No newline at end of file diff --git a/package-lock.json b/package-lock.json index 93e7fd0..331e84e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,5 +1,5 @@ { - "name": "sif2doc", + "name": "sif2-vitepress", "lockfileVersion": 3, "requires": true, "packages": {