Raphael/SCHALE.GameServer
Raphael
/
SCHALE.GameServer
Archived
2
6
Fork 3
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update and translate all Readme 

Update and translate all Readme
This commit is contained in:
北野樱奈 2025-01-22 18:58:53 +08:00
parent c3f628b094
commit 9cb8561b1b
4 changed files with 291 additions and 165 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

187
Command_EN.md Normal file
View File

@ -0,0 +1,187 @@
# 💻 Blue Archive Command Manual
*📝 Author: Ge Zhu*
*📝 Translate: Kitano Sakura*
---
## 📑 Table of Contents
- [🏰 Cafe Commands (Cafe)](#cafe-commands-cafe)
- [👥 Character Commands (Character)](#character-commands-character)
- [💎 Currency Commands (Currency)](#currency-commands-currency)
- [❓ Help Commands (Help)](#help-commands-help)
- [📦 Inventory Commands (Inventory)](#inventory-commands-inventory)
- [💾 Load Data Commands (LoadData)](#load-data-commands-loaddata)
- [⚙️ Set Account Commands (SetAccount)](#set-account-commands-setaccount)
- [🔓 Unlock All Commands (UnlockAll)](#unlock-all-commands-unlockall)
---
# 🏰 Cafe Commands (Cafe)
> Build your ideal cafe and create a unique relaxation space
## ⌨️ Command Format
```
/cafe <character|furniture> <add|addall|removeall> [id/amount]
```
## 🎯 Function Description
This command allows you to manage the in-game Cafe system, enabling you to freely arrange characters and furniture.
## 📋 Available Subcommands
### 👥 Character Management (character)
#### 1. ➕ Add a Single Character
```
/cafe character add <CharacterID>
```
- 💫 Function: Adds a specified character ID to the Cafe
- 📝 Example: `/cafe character add 123`
- ℹ️ Note: Adding a duplicate character will prompt a message
#### 2. ✨ Batch Add Characters
```
/cafe character addall [amount]
```
- 💫 Function: Adds multiple eligible characters to the Cafe
- 📝 Examples:
- `/cafe character addall` (Adds 50 characters)
- `/cafe character addall 100` (Adds 100 characters)
- ℹ️ Conditions for addition:
- ✅ Playable characters only
- ✅ Non-NPC characters
- ✅ Officially released characters
#### 3. 🗑️ Remove All Characters
```
/cafe character removeall
```
- 💫 Function: Clears all characters from the Cafe
- ⚠️ Warning: This action is irreversible
## ⚡ Notes
1. 🔄 All commands automatically save changes
2. 📝 Commands are case-insensitive
3. ℹ️ Duplicate characters cannot be added
4. 🚧 Furniture functionality is under development
---
# 👥 Character Commands (Character)
> Manage your character system and build the perfect combat team
## ⌨️ Command Format
```
/character <add|clear> [all|characterId]
```
## 🎯 Function Description
This command manages the player’s character system, supporting the addition and clearing of characters.
## 📋 Available Subcommands
### ✨ Add Characters (add)
#### 1. 🌟 Add All Characters
```
/character add all
```
- 💫 Function: Adds all available characters
- ✨ Features: Characters are added in their strongest state:
- ✅ Max level
- ✅ Fully developed
- ✅ Skills maxed out
#### 2. ➕ Add a Specific Character
```
/character add <CharacterID>
```
- 💫 Function: Adds a specific character by ID
- 📝 Example: `/character add 1`
- ℹ️ Note: Characters are added in their strongest state
### 🗑️ Clear All Characters (clear)
```
/character clear
```
- 💫 Function: Clears all characters
- ⚠️ Warning: This action is irreversible
## ⚡ Notes
1. 🔄 Operations save automatically
2. 📝 Commands are case-insensitive
3. ℹ️ Duplicate additions prompt a message
4. ⚠️ Use clear commands with caution
---
# 💎 Currency Commands (Currency)
> Freely adjust the amount of various currencies for a better gaming experience
## ⌨️ Command Format
```
/currency <currencyType> <amount>
```
## 🎯 Function Description
This command modifies the amounts of various currencies in your account.
## 💰 Available Currency Types
### 💫 Basic Currencies
- `Gold` - 💰 Gold
- `Gem` - 💎 Pyroxene (total)
- `GemPaid` - 💳 Paid Pyroxene
- `GemBonus` - 🎁 Bonus Pyroxene
### 🎫 Stamina Tickets
- `ActionPoint` - ⚡ Stamina
- `AcademyTicket` - 📚 Academy Tickets
- `ArenaTicket` - ⚔️ Arena Tickets
- `RaidTicket` - 🎯 Raid Tickets
### 🗺️ Weekly Dungeon Tickets
- `WeekDungeonChaserATicket` - 🏃‍♂️ Chase Battle A Ticket
- `WeekDungeonChaserBTicket` - 🏃‍♀️ Chase Battle B Ticket
- `WeekDungeonChaserCTicket` - 🏃 Chase Battle C Ticket
- `WeekDungeonFindGiftTicket` - 🎁 Treasure Hunt Ticket
- `WeekDungeonBloodTicket` - 🗡️ Blood Battle Ticket
- `ChaserTotalTicket` - 🎯 Total Chase Battle Ticket
### 🏫 Academy Dungeon Tickets
- `SchoolDungeonATicket` - 📘 Academy Dungeon A Ticket
- `SchoolDungeonBTicket` - 📗 Academy Dungeon B Ticket
- `SchoolDungeonCTicket` - 📙 Academy Dungeon C Ticket
- `SchoolDungeonTotalTicket` - 📚 Total Academy Dungeon Ticket
### 🌟 Special Dungeon Tickets
- `TimeAttackDungeonTicket` - ⏱️ Time Attack Dungeon Ticket
- `WorldRaidTicketA` - 🌍 World Raid A Ticket
- `WorldRaidTicketB` - 🌎 World Raid B Ticket
- `WorldRaidTicketC` - 🌏 World Raid C Ticket
### ⚔️ Elimination Tickets
- `EliminateTicketA` - 🗡️ Elimination A Ticket
- `EliminateTicketB` - ⚔️ Elimination B Ticket
- `EliminateTicketC` - 🛡️ Elimination C Ticket
- `EliminateTicketD` - 🔰 Elimination D Ticket
### 🏆 Others
- `MasterCoin` - 🎖️ Master Coin
## 📝 Usage Examples
```
/currency Gem 99999 # Set Pyroxene to 99999
/currency ActionPoint 9999 # Set Stamina to 9999
/currency Gold 99999999 # Set Gold to 99999999
```
## ⚡ Notes
1. 📝 Currency types are case-sensitive
2. 🔢 Amounts must be integers
3. 🔄 Changes are effective immediately
4. ⚠️ Invalid inputs will prompt an error
5. 💡 Use responsibly
---
(Translation continued upon request!)

124
Mitmproxy_Readme_EN.md
View File

@ -1,132 +1,128 @@
## Mitmproxy Usage Guide
(By 北野樱奈)
---
## Prerequisites
1. [Download mitmproxy](https://mitmproxy.org/) and install it.
2. Basic knowledge of WireGuard and Python scripting.
3. A client device (e.g., Android emulator or smartphone) and a host machine running `mitmproxy`.
# 🌐 **Mitmproxy Usage Guide**
* (By Kitano Sakura)*
### Installation Steps
- **Linux/Mac**
```markdown
---
## 🛠️ **Prerequisites**
- Download and install [**Mitmproxy**](https://mitmproxy.org/).
- Basic knowledge of **WireGuard** and **Python scripting**.
- Required devices:
- A host machine to run **Mitmproxy**.
- A client device (e.g., Android emulator or smartphone).
---
## 📥 **Step 1: Install Mitmproxy**
### 📂 Installation
#### Linux / macOS
```bash
# Ubuntu/Debian
sudo apt update
sudo apt install mitmproxy
# macOS
brew install mitmproxy
```
- **Windows**: Download the `.exe` installer from [mitmproxy.org](https://mitmproxy.org/) and follow the instructions to complete the installation.
### Verify Installation
Run the following command to verify the installation:
#### Windows
Download the `.exe` installer from [**mitmproxy.org**](https://mitmproxy.org/) and follow the setup instructions.
### ✅ Verify Installation
Run the following command to confirm successful installation:
```bash
mitmproxy --version
```
---
## Step 2: Install CA Certificates on Client and Server
## 🔑 **Step 2: Install the CA Certificate**
To decrypt HTTPS traffic, the client needs to trust the `mitmproxy` CA certificate.
### 📜 Steps
### Steps
1. Start `mitmproxy` to generate the certificate:
1. Start `mitmproxy` to generate the CA certificate:
```bash
mitmdump
```
2. On the PC, navigate to `C:\Users\YourUser\.mitmproxy` to locate the certificate file (mitmproxy-ca.p12).
3. In the `mitmproxy` directory, locate `mitmproxy-ca-cert.crt`.
4. Rename `mitmproxy-ca-cert.crt` to `c8750f0d.0`.
5. Install the certificate as a system CA.
---
### For Android Devices
1. Move the certificate to the system CA directory:
2. Locate the generated certificate:
- Certificate path:
- `C:\Users\<Username>\.mitmproxy\mitmproxy-ca-cert.crt` (Windows)
- `~/.mitmproxy/` (Linux / macOS)
3. Rename `mitmproxy-ca-cert.crt` to `c8750f0d.0`.
4. Move the certificate to the system CA directory and set permissions:
```bash
adb root
adb remount
adb shell mv /sdcard/c8750f0d.0 /system/etc/security/cacerts/
```
2. Set the correct permissions:
```bash
adb shell chmod 644 /system/etc/security/cacerts/c8750f0d.0
```
3. Reboot the device:
```bash
adb reboot
```
---
## Step 3: Download the Redirect Script
## 🔧 **Step 3: Configure the Redirect Script**
Download the script from the repository.
Download `redirect_server.py` from the repository and modify the `SERVER_HOST` field:
### Note: **Make sure to modify the IP address in `redirect_server.py`.**
```python
import gzip
import json
from mitmproxy import http
SERVER_HOST = 'Replace this with your IP'
SERVER_HOST = 'Update here' # Replace with your server IP
SERVER_PORT = 80
REWRITE_HOST_LIST = [
'ba-jp-sdk.bluearchive.jp',
'prod-gateway.bluearchiveyostar.com',
'prod-game.bluearchiveyostar.com',
# 'prod-notice.bluearchiveyostar.com',
# 'prod-logcollector.bluearchiveyostar.com',
]
```
---
## Step 4: Launch mitmproxy and Load the Script
## 🚀 **Step 4: Start Mitmproxy**
Run the following command to start `mitmproxy` with the redirect script:
Run the following command to launch Mitmproxy with the redirect script:
```bash
mitmweb -m wireguard --no-http2 -s redirect_server.py --set termlog_verbosity=warn --ignore Your IP
mitmweb -m wireguard --no-http2 -s redirect_server.py --set termlog_verbosity=warn --ignore <your IP address>
```
### Parameter Explanation:
### 📝 Parameter Explanation:
- `-m wireguard`: Use WireGuard as the network layer.
- `--no-http2`: Disable HTTP/2 to improve compatibility.
- `--no-http2`: Disable HTTP/2 for better compatibility.
- `-s redirect_server.py`: Load the redirect script.
- `--set termlog_verbosity=warn`: Set log level to warnings only.
- `--set termlog_verbosity=warn`: Show warnings only in logs.
You can monitor traffic through the `mitmweb` interface at `http://localhost:8081`.
Access the Mitmproxy web interface at `http://localhost:8081` to monitor traffic.
---
## Step 5: Install and Configure WireGuard
## 🔄 **Step 5: Install WireGuard**
Use WireGuard to route client traffic to `mitmproxy`.
### 📥 Installation
- **Android**: Download from [**Google Play**](https://play.google.com/store/apps/details?id=com.wireguard.android).
- **Other Platforms**: Refer to the [**official WireGuard installation guide**](https://www.wireguard.com/install/).
### Installation Steps
- **Android**: [Download WireGuard](https://play.google.com/store/apps/details?id=com.wireguard.android).
- **Other Platforms**: Refer to the [official WireGuard installation guide](https://www.wireguard.com/install/).
### Configuration Steps
1. Open the WireGuard client, click the `+` button in the bottom left corner, and select **Scan QR Code**.
2. The emulator will display a scanner window. Select **Real-time Screenshot**.
3. Position the screenshot over the QR code in the Mitmproxy browser page (accessible via settings).
4. Enable the configuration.
### ⚙️ Configuration
1. Open the WireGuard client and scan the QR code provided by Mitmproxy.
2. Apply the configuration to route all traffic through Mitmproxy.
---
## Troubleshooting
## 🛠️ **Troubleshooting**
### Error: Client TLS handshake failed. The client does not trust the proxy's certificate for yostar-oversea-netsdk-logging.ap-southeast-1.log.aliyuncs.com (OpenSSL Error([('SSL routines', '', 'ssl/tls alert certificate unknown')]))
- Ensure that both the PC and client have the same Mitmproxy certificate installed.
- Verify that the Mitmproxy certificate is properly installed on both ends.
### ❌ Error: Client TLS handshake failed
- Ensure the same CA certificate is installed on both the host and client devices.
- Verify that the CA certificate is installed as a system certificate.
### Android Certificate Disappears After Installation
- Use the MT Manager to grant SU (superuser) permissions.
- Navigate to `/system/etc/security/cacerts/`.
- Locate `c8750f0d.0` and set the permissions to 664. The user group should be set to root.
### ❌ Certificate disappears on Android
- Use MT Manager to grant SU permissions.
- Manually navigate to `/system/etc/security/cacerts/` and reset permissions to `644`.
---
🎉 **Done!**

6
Mitmproxy_Readme_ZH.md
View File

@ -6,9 +6,9 @@
---
## 🛠️ **前置要求**
1. 下载并安装 [**Mitmproxy**](https://mitmproxy.org/)。
2. 熟悉 **WireGuard** 和 **Python 脚本**的基本操作。
3. 准备以下设备：
- 下载并安装 [**Mitmproxy**](https://mitmproxy.org/)。
- 熟悉 **WireGuard** 和 **Python 脚本**的基本操作。
- 准备以下设备：
- 一台运行 **Mitmproxy** 的主机。
- 一台客户端设备（如 Android 模拟器或手机）。

87
README_zh.md
View File

@ -1,9 +1,18 @@
# SCHALE.GameServer
**本文基于[https://github.com/rafi1212122/SCHALE.GameServer](https://github.com/rafi1212122/SCHALE.GameServer)及个人操作经验编写，资源配置文件请到以上链接获取，若有任何疑问请到Discord社群询问**
# 🌌 **SCHALE.GameServer** 🌟
### [Mitmproxy方案使用教程](Mitmproxy_Readme_ZH.md) (by 北野樱奈)
# 📚 项目文档目录
## 📌 目录
- [🔧 环境安装](#环境安装)
- [🚀 命令列表](Command.md)
- [📦 Mitmproxy方案](Mitmproxy_Readme_ZH.md)
- [📞 DISCORD](#DISCORD)
---
## 🔧 环境安装
## 安装准备阶段
### 1.安装[SQL Server Express 2022](https://go.microsoft.com/fwlink/p/?linkid=2216019&clcid=0x804&culture=zh-cn&country=cn)
* 打开你下载的安装程序
* 选择“基础”
@ -21,72 +30,6 @@
* 选择自定义安装，其余默认
* 选择安装路径
* 安装，等待完成
### 6.安装Frida
* win+R打开运行，键入cmd
* 在cmd中输入`pip install frida`回车
* 等待下载安装完成
* 再输入`pip install frida-tools`回车
* 等待下载安装完成（时间可能较长）
### 7.推送Frida-server至模拟器
* 下载[frida-server-16.x.x-android-x86_64.xz](https://github.com/frida/frida/releases/download/16.3.1/frida-server-16.3.1-android-x86_64.xz)并解压
* 把frida-server-16.x.x-android-x86_64放入`\leidian\LDPlayer9`路径下
* 打开模拟器并在设置中打开ADB调试和ROOT权限
* 在（你安装时的盘）:\leidian\LDPlayer9路径下的导航栏中输入cmd并回车
* 输入`adb push frida-server-16.x.x-android-x86_64 /data/local/tmp`
* 等待传输完成
## 资源配置阶段
* 打开并解压所下载的SCHALE.GameServer-master.zip
* 使用Microsoft Visual Studio 2022打开包中的SCHALE.GameServer.sln
* 选择顶部菜单栏“视图”下拉“终端”
* 若在`...\SCHALE.GameServer-master>`下，请输入`cd SCHALE.GameServer`转到以下路径
* 在`\SCHALE.GameServer-master\SCHALE.GameServer`路径下输入：
`dotnet publish -a x64 --use-current-runtime --self-contained false -p:InvariantGlobalization=false`
* ~~找到并在`\SCHALE.GameServer-master\SCHALE.GameServer\bin\Release\net8.0\win-x64`路径下创建Resources文件夹，再在其下创建excel文件夹，将Excel.zip解压至此文件夹~~（最新版该步骤已集成于`SCHALE.GameServer.exe`）
* 打开SSMS，默认连接（注意勾选信任服务器证书）
* 运行`\SCHALE.GameServer-master\SCHALE.GameServer\bin\Release\net8.0\win-x64\SCHALE.GameServer.exe` （后台挂起）（首次运行请允许通过防火墙）
* 找到ba.js文件使用记事本打开，修改第5行`REPLACE THIS WITH YOUR LOCAL IP`为你此时的IPV4地址（网络和Internet设置中可查看）
## 启动游戏阶段
*建议把ba.js放入\leidian\LDPlayer9路径下*
**以下操作每次启动都要执行！**
* 打开雷电模拟器
* 启动frida
* 在（你安装时的盘）:\leidian\LDPlayer9路径下的导航栏中输入cmd并回车
* 在所打开的cmd中键入:
```
adb shell
su //超级管理员
cd /data/local/tmp //转到此路径下
chmod 755 frida-server-16.x.x-android-x86_64
./frida-server-16.x.x-android-x86_64 //启动frida
```
**！！！注意此步骤完成后不要关闭该cmd！！！**
* （PC）重新打开一个路径相同的cmd
* （模拟器）启动游戏 ブルアカ
* 在出现Yostar徽标时键入并回车：
`frida -U "ブルアカ" -l ba.js --realm=emulated`（后台挂起）
* 出现`Attatching...`并且SCHALE.GameServer.exe出现Ping时基本成功
**###进入私服前需要先连接官服下载资源并通过新手教程###**
**###首次登录设置完名称和发音档时会抛出错误，此时重启`SCHALE.GameServer.exe`、关闭游戏，从“启动游戏ブルアカ”步骤再次开始即可正常进入###**
## 注意事项
* 此项目还处于初期阶段，存在大量不可使用选项，出现问题请尝试重新登录或重启
* 若出现`SCHALE.GameServer.exe`没有Ping的情况，请检查ba.js中的IPV4地址与你当前地址是否一致
* 若已成功安装SQL Server Express，请不要轻易自行尝试卸载或删除它，否则可能无法再次成功安装
* 如果很不幸，你的电脑上已经多次无法成功安装SQL Server Express且不愿意重装系统，以下提供一个平替方案：
*需要较高性能的电脑和足够的硬盘存储*
* 安装[VMware Workstation Pro](https://blog.csdn.net/weixin_74195551/article/details/127288338)
* 网络搜索许可证密钥填入
* 前往Windows官网或其他正规渠道获取Windows 10/11镜像
* 创建并安装Windows虚拟机
参阅[VMware中安装win10教程_vmware安装win10-CSDN博客](https://blog.csdn.net/lvlheike/article/details/120398259)
* 创建完虚拟机需设置：
* 你的电脑：设置-系统-屏幕-显示卡-默认图形设置，启用“硬件加速GPU计划”
* （虚拟机设置）处理器：勾选虚拟化Intel VT-x/EPT或AMD-V/RVI(V)
* （虚拟机设置）显示器：勾选“加速3D图形”，选择“指定监视器设置”，监视器数量为1个，图形内存改为所给**内存**的一半
* 启动虚拟机
* 使用[KMS](https://github.com/zbezj/HEU_KMS_Activator/releases/tag/42.0.4)激活Windows
* 完成后即可开始安装
## 📞 DISCORD
- [Discord](https://discord.gg/URaXJpS5gd)