Skip to content
BranchesTags

Repository files navigation

Arcaea MoliPatch

中文 | English

中文

Arcaea 6.15.0c 私服 + MOD 补丁工具

自 v1.0 起整体改用 GPLv3 协议开源。

免责声明

本项目仅供学习研究目的，禁止用于任何商业用途。使用本项目所产生的一切后果由使用者自行承担。

MOD 功能警告

MOD 功能（Auto Play、Wallhack 等）仍在测试阶段，不建议启用。 启用可能导致游戏异常、崩溃或数据损坏。

悬浮窗权限

安装 Patch 后的 APK 后，需要手动授予悬浮窗权限：

设置 → 应用 → Arcaea → 悬浮窗权限 → 开启

如果未授予悬浮窗权限，MoliLog 浮窗将无法显示。

new ver fix.

开源声明

应用首次启动时会弹出开源声明对话框（仅显示一次），包含本项目 GitHub 链接与 GPLv3 协议说明。

服务端致谢

服务端源代码基于 Lost-MSth/Arcaea-server 改动而来，已适配支持 Arcaea 6.15.0c 最新版本（同时兼容 6.14.11c）。

v1.0 更新亮点（6.15.0c）

相较于 6.14.11c 旧版本，本次更新包含以下重大改进：

  • Android 15/16 兼容性：修复非 root 设备 SSL 验证失败、Android 16 悬浮窗 BadTokenException 崩溃
  • Native PLT Hook 框架：17 个 PLT Hook 全部成功安装（connect / getaddrinfo / SSL / GL 等）
  • 三层 SSL Pinning 绕过：Native 层（SSL_CTX_set_verify + X509_verify_cert）+ Java 层（MoliTrustManager）
  • 全域名重定向：auth.lowiro.com / arcapi-v3.lowiro.com / arcaea.lowiro.com 均重定向至私服
  • MoliLog 悬浮窗重构：可拖拽 / 可展开收起 / 日志颜色分级 / 位置自动夹取
  • Dev 工具包：内置用户管理 / 残片设置 / 曲包解锁 / ADB 操作一体化命令行工具
  • 曲包全解锁 & 残片归零：服务端原生支持
  • 自定义包名 & 图标：可通过配置替换
  • ADB 容错：非模拟器环境不再卡死

完整变更日志请参阅 CHANGELOG.md。
旧版本（6.14.11c）说明请参阅 docs/README_6.14.11c.md。

功能列表

服务端

  • 登录即注册
  • 全角色 / 歌曲 / 场景解锁
  • Web 管理后台
  • Link Play 联机支持
  • 礼物 / 兑换码系统
  • 世界模式
  • 曲包全解锁 / 残片归零

客户端 Patch

  • SSL Pinning 绕过（Native + Java 双层）
  • URL 重定向至私服（三域名全覆盖）
  • MoliLog 悬浮窗（MOD 控制 + 日志查看 + 颜色分级）
  • 自定义包名（默认 moe.moli.arc）
  • 自定义应用图标
  • 开源声明对话框（首次启动）

MOD 功能

功能 说明 状态
Billing Bypass 绕过支付验证 稳定
High FPS 高帧率模式 稳定
Keep Awake 屏幕常亮 稳定
Device Spoof 设备 ID 伪装 稳定
Version Spoof 版本号伪装 稳定
Token Copy OAuth Token 复制到剪贴板 稳定
Wallhack 透视（OpenGL Hook） 不可用
Auto Play 自动演奏 不可用

Dev 工具包

工具 说明
dev_menu.py 交互式命令行菜单
dev_inspect.py 用户 / 数据库查询
dev_modify.py 残片 / 曲包 / 密码修改
dev_adb.py ADB 设备管理 / APK 安装

快速开始

1. 部署服务端

cd server
pip install -r requirements.txt
# 复制并编辑配置文件
copy config.example.py config.py
# 编辑 config.py，设置 HOST、PORT、GAME_API_PREFIX 等
# 注意：GAME_API_PREFIX 建议设置为 '/' 以兼容所有客户端版本
python main.py

如需 HTTPS，使用 patch/gen_cert.py 生成自签名证书，并在 config.py 中配置 SSL_CERT 和 SSL_KEY。

2. Patch 客户端 APK

cd patch/release
# 复制并编辑配置文件
copy config.example.yaml config.yaml
# 编辑 config.yaml，设置服务器地址、APK 路径等
# 将原始 APK 放入指定路径
python moli_patch.py

配置说明：

  • api_host：API 服务器地址（最长 19 字节）
  • auth_host：认证服务器地址（最长 14 字节，同时用于 arcaea.lowiro.com 替换）
  • build_mode：prebuilt（使用预编译 SO）或 build（从源码编译，需 NDK）
  • 签名密钥库密码：moli123456

3. 安装并授权

adb install -r release/arcaea_6.15.0c_moli_patched.apk
# 手动授予悬浮窗权限
adb shell pm grant moe.moli.arc android.permission.SYSTEM_ALERT_WINDOW

4. 使用 Dev 工具包（可选）

cd tools
python dev_menu.py

项目结构

├── server/                 # 服务端源代码（基于 Arcaea-server）
│   ├── api/                # API 路由层
│   ├── core/               # 核心业务逻辑
│   ├── server/             # 服务器路由处理
│   ├── linkplay_server/    # Link Play 联机服务器
│   ├── web/                # Web 管理后台
│   ├── templates/          # HTML 模板
│   ├── database/           # 数据库初始化及歌曲数据
│   └── config.example.py   # 配置模板
├── patch/                  # Patch 工具和源码（一键 Patcher）
│   ├── moli_log/           # MoliLog 模块
│   │   ├── moli_log_source.zip  # SO 源码（C/Java/Makefile/Stubs）
│   │   ├── prebuilt/       # 预编译 libmoli_log.so
│   │   └── stubs/          # Java stub 源码
│   ├── release/            # Patch 脚本和配置
│   │   ├── moli_patch.py   # 一键 Patch 主脚本
│   │   └── config.example.yaml
│   ├── build-tools/        # Android 构建工具（zipalign, d8, apksigner）
│   ├── apktool.jar         # APK 反编译/重编译
│   ├── baksmali.jar        # DEX 反汇编
│   ├── gen_cert.py         # TLS 证书生成
│   └── moli_release.jks    # APK 签名密钥库
├── release/                # Patch 成品
│   ├── arcaea_6.15.0c_moli_patched.apk
│   └── arcaea_6.15.0c_moli_patched.apk.sha256
├── tools/                  # Dev 工具包
│   ├── dev_menu.py         # 交互式菜单
│   ├── dev_inspect.py      # 数据库查询
│   ├── dev_modify.py       # 数据修改
│   └── dev_adb.py          # ADB 操作
├── docs/                   # 文档
│   └── README_6.14.11c.md  # 旧版本说明
├── .github/                # Issue 模板
├── CHANGELOG.md            # 更新日志
├── LICENSE                 # GPLv3
└── README.md

贡献

License

本项目基于 GPL-3.0 协议开源。

  • Copyright (c) 2024 Lost-MSth（原始 Arcaea-server）
  • Copyright (c) 2026 Moli13337（修改、Patch 工具、MOD 功能）

English

Arcaea 6.15.0c private server + MOD patch toolkit

Starting from v1.0, the entire project is licensed under GPLv3.

Disclaimer

This project is for educational and research purposes only. Commercial use is prohibited. Users are solely responsible for any consequences arising from the use of this project.

MOD Feature Warning

MOD features (Auto Play, Wallhack, etc.) are still in testing and NOT recommended to enable. Enabling them may cause game anomalies, crashes, or data corruption.

Overlay Permission

After installing the patched APK, you must manually grant the overlay permission:

Settings → Apps → Arcaea → Display over other apps → Allow

Without this permission, the MoliLog overlay will not be visible.

new ver fix.

Open Source Declaration

An open-source declaration dialog will appear on first app launch (shown only once), containing the project GitHub link and GPLv3 license information.

Server Acknowledgement

The server source code is based on Lost-MSth/Arcaea-server, modified to support Arcaea 6.15.0c (latest version, also compatible with 6.14.11c).

v1.0 Highlights (6.15.0c)

Compared to the 6.14.11c legacy version, this update includes:

  • Android 15/16 compatibility: Fixed SSL verification failure on non-root devices, Android 16 overlay BadTokenException crash
  • Native PLT Hook framework: All 17 PLT hooks successfully installed (connect / getaddrinfo / SSL / GL, etc.)
  • Three-layer SSL Pinning bypass: Native layer (SSL_CTX_set_verify + X509_verify_cert) + Java layer (MoliTrustManager)
  • Full domain redirection: auth.lowiro.com / arcapi-v3.lowiro.com / arcaea.lowiro.com all redirected to private server
  • MoliLog overlay rebuilt: Draggable / expandable / log color grading / auto position clamping
  • Dev toolkit: Built-in user management / fragment setting / pack unlock / ADB operations CLI
  • Pack unlock & fragment zero: Native server-side support
  • Custom package name & icon: Configurable replacement
  • ADB fault tolerance: No more hangs in non-emulator environments

Full changelog: CHANGELOG.md.
Legacy version (6.14.11c) docs: docs/README_6.14.11c.md.

Features

Server

  • Auto-register on login
  • Full character / song / scenery unlock
  • Web admin panel
  • Link Play multiplayer support
  • Present / redeem code system
  • World mode
  • Pack unlock / fragment zero

Client Patch

  • SSL Pinning bypass (Native + Java dual-layer)
  • URL redirection to private server (3 domains covered)
  • MoliLog floating overlay (MOD controls + log viewer + color grading)
  • Custom package name (default: moe.moli.arc)
  • Custom app icon
  • Open-source declaration dialog (first launch)

MOD Features

Feature Description Status
Billing Bypass Bypass payment verification Stable
High FPS High frame rate mode Stable
Keep Awake Keep screen awake Stable
Device Spoof Spoof device ID Stable
Version Spoof Spoof app version Stable
Token Copy Copy OAuth token to clipboard Stable
Wallhack See-through (OpenGL Hook) Unavailable
Auto Play Auto play Unavailable

Dev Toolkit

Tool Description
dev_menu.py Interactive CLI menu
dev_inspect.py User / database inspection
dev_modify.py Fragment / pack / password modification
dev_adb.py ADB device management / APK install

Quick Start

1. Deploy Server

cd server
pip install -r requirements.txt
# Copy and edit config
copy config.example.py config.py
# Edit config.py: set HOST, PORT, GAME_API_PREFIX, etc.
# Note: GAME_API_PREFIX should be set to '/' for compatibility with all client versions
python main.py

For HTTPS, use patch/gen_cert.py to generate a self-signed certificate, and configure SSL_CERT and SSL_KEY in config.py.

2. Patch Client APK

cd patch/release
# Copy and edit config
copy config.example.yaml config.yaml
# Edit config.yaml: set server address, APK path, etc.
# Place the original APK at the specified path
python moli_patch.py

Configuration notes:

  • api_host: API server address (max 19 bytes)
  • auth_host: Auth server address (max 14 bytes, also used for arcaea.lowiro.com replacement)
  • build_mode: prebuilt (use prebuilt SO) or build (compile from source, requires NDK)
  • Signing keystore password: moli123456

3. Install and Grant Permission

adb install -r release/arcaea_6.15.0c_moli_patched.apk
# Manually grant overlay permission
adb shell pm grant moe.moli.arc android.permission.SYSTEM_ALERT_WINDOW

4. Use Dev Toolkit (Optional)

cd tools
python dev_menu.py

Project Structure

├── server/                 # Server source code (based on Arcaea-server)
│   ├── api/                # API routing layer
│   ├── core/               # Core business logic
│   ├── server/             # Server route handlers
│   ├── linkplay_server/    # Link Play multiplayer server
│   ├── web/                # Web admin panel
│   ├── templates/          # HTML templates
│   ├── database/           # Database init and song data
│   └── config.example.py   # Config template
├── patch/                  # Patch tools and source (one-click Patcher)
│   ├── moli_log/           # MoliLog module
│   │   ├── moli_log_source.zip  # SO source (C/Java/Makefile/Stubs)
│   │   ├── prebuilt/       # Prebuilt libmoli_log.so
│   │   └── stubs/          # Java stub sources
│   ├── release/            # Patch script and config
│   │   ├── moli_patch.py   # One-click patch script
│   │   └── config.example.yaml
│   ├── build-tools/        # Android build tools (zipalign, d8, apksigner)
│   ├── apktool.jar         # APK decompile/recompile
│   ├── baksmali.jar        # DEX disassembler
│   ├── gen_cert.py         # TLS certificate generator
│   └── moli_release.jks    # APK signing keystore
├── release/                # Patch release
│   ├── arcaea_6.15.0c_moli_patched.apk
│   └── arcaea_6.15.0c_moli_patched.apk.sha256
├── tools/                  # Dev toolkit
│   ├── dev_menu.py         # Interactive menu
│   ├── dev_inspect.py      # Database inspection
│   ├── dev_modify.py       # Data modification
│   └── dev_adb.py          # ADB operations
├── docs/                   # Documentation
│   └── README_6.14.11c.md  # Legacy version docs
├── .github/                # Issue templates
├── CHANGELOG.md            # Changelog
├── LICENSE                 # GPLv3
└── README.md

Contributing

License

This project is licensed under GPL-3.0.

  • Copyright (c) 2024 Lost-MSth (original Arcaea-server)
  • Copyright (c) 2026 Moli13337 (modifications, patch tools, MOD features)

About

Arcaea game private server

Topics

arcaeaarcaea-serverprivate-server

Resources

Readme
License
Activity

Stars

545 stars

Watchers

43 watching

Forks

49 forks
Report repository

Releases

Packages

Contributors

Languages