readme: clean up
Signed-off-by: Cuynu <cuynu@proton.me>
This commit is contained in:
parent
3df3e0c5cd
commit
943d51d77f
1 changed files with 24 additions and 50 deletions
74
README.md
74
README.md
|
|
@ -13,6 +13,14 @@ Lightweight **AI-free, human-written** open source CLI tool for patching MB Bank
|
|||
- Project FAQ : [Read here](/mbcp/info_en/wiki/faq)
|
||||
- Licensed as MIT License.
|
||||
|
||||
> [!IMPORTANT]
|
||||
> As of new State of Bank regulations, this project now targets with the aim to gain back freedom for power users and developers who wanted to use rooted device as main device but still want to use the MB normally.
|
||||
>
|
||||
>
|
||||
> We spend efforts and times for finding the method and make this project. Of course, it's not for scammer, it's for **power users and developers only**.
|
||||
>
|
||||
> Older releases (v6.4.90 or older) has mismatch commit ID with this new repo, for reference to the exactly same commit, look at `MBCP_VersionReference.md` in repository.
|
||||
|
||||
## Introduction
|
||||
- Note : "MBCP" / "MBCPApp" = "MBBank CorePatch"
|
||||
- MBCP is inspired from [CorePatch](https://github.com/LSPosed/CorePatch) project. Now it can works with [PMPatch](https://github.com/vova7878-modules/PMPatch) too
|
||||
|
|
@ -30,14 +38,14 @@ Lightweight **AI-free, human-written** open source CLI tool for patching MB Bank
|
|||
</details>
|
||||
|
||||
## DISCLAIMER
|
||||
- I'm not responsible if someone abuse this patch to do illegal things, since it's originally made for technical or well-known users only.
|
||||
- I'm not responsible if someone abuse this patch to do illegal things, since it's originally made for power users and developers only.
|
||||
|
||||
## Documentation
|
||||
|
||||
- [MBCPApp Patcher Documentation](/mbcp/mbbpatch/src/branch/mbflutter/docs)
|
||||
|
||||
## Requirements & Usage & How-to use patcher
|
||||
- Follow usage docs here : [Patcher Usage](/mbcp/mbbpatch/wiki/patcher-usage.-)
|
||||
- Follow usage docs here : [Patcher Usage](/mbcp/mbbpatch/src/branch/dev/docs/patcher-usage.-.md)
|
||||
|
||||
## Patches list :
|
||||
|
||||
|
|
@ -46,7 +54,7 @@ Lightweight **AI-free, human-written** open source CLI tool for patching MB Bank
|
|||
<details>
|
||||
|
||||
> [!IMPORTANT]
|
||||
> These patches can be applied for current/newer app version, but the app will refuse to login with `GW934` error :
|
||||
> Following patches can be applied for current/newer app version, but the app will refuse to login with `GW934` error :
|
||||
> - Remove invoke to mbshield
|
||||
>
|
||||
> - Block adjust volume on sEKYC
|
||||
|
|
@ -61,7 +69,7 @@ Lightweight **AI-free, human-written** open source CLI tool for patching MB Bank
|
|||
>
|
||||
> At the current situation, the workaround for it is still unknown :(
|
||||
>
|
||||
> Except for testing, those mentioned patches shouldn't be used for any normal use cases. So for now, avoid it when patching app.
|
||||
> Except for testing, mentioned patches shouldn't be used for any normal use cases. So for now, avoid it when patching app.
|
||||
>
|
||||
|
||||
</details>
|
||||
|
|
@ -130,7 +138,7 @@ Lightweight **AI-free, human-written** open source CLI tool for patching MB Bank
|
|||
|
||||
|
||||
## Legacy patches
|
||||
- These patches are not implemented or outdated, which is used for discontinued MB app version.
|
||||
- Following patches are not implemented or outdated, which is used for discontinued MB app version.
|
||||
### [📦 `MB Bank : com.mbmobile`](https://t.me/embeeapks)
|
||||
<details>
|
||||
|
||||
|
|
@ -143,7 +151,7 @@ Lightweight **AI-free, human-written** open source CLI tool for patching MB Bank
|
|||
|
||||
## Proprietary code
|
||||
> [!WARNING]
|
||||
> This project contains some proprietary code extracted from MB's app that has been modified to bypass something in the app, but the modified proprietary code is completely public and open source, it will be used for some patches.
|
||||
> This project contains some proprietary code extracted from MB's app that has been modified to bypass things in the app, but the modified proprietary code is completely public and open source, it will be used for some patches.
|
||||
|
||||
- Proprietary code exists in following folder :
|
||||
|
||||
|
|
@ -158,34 +166,9 @@ Lightweight **AI-free, human-written** open source CLI tool for patching MB Bank
|
|||
- Under `mbsig` directory, it contains original signature from original MB's app, which is necessary to make app works after patching process because the app doesn't work with different APK signature.
|
||||
- Everything including that listed above code are all licensed under MIT license, it can be considered as reverse engineered code :>
|
||||
|
||||
## Usage
|
||||
- Go to home directory, then clone repository first
|
||||
```
|
||||
cd ~
|
||||
git clone https://git.disroot.org/mbcp/mbbpatch.git
|
||||
cd ~/mbbpatch/MBCPApp
|
||||
```
|
||||
|
||||
- Since MB Bank are now using split APK (*.apks) since `v5.3 (135)` so you have to convert it to regular APK first
|
||||
- Grab MB Bank apks from [eMBee APKs](https://t.me/embeeapks) or [Lotus Chat](https://lotuschat.vn/w/+anSH1BbDbAYn54JC9nIC9A) if you don't have access to Telegram and copy it to `~/mbbpatch/MBCPApp/mbapk`
|
||||
|
||||
- Run bash `mbcpapp.sh` script
|
||||
```
|
||||
cd ~/mbbpatch/MBCPApp
|
||||
./mbcpapp.sh
|
||||
```
|
||||
- Download necessary tools first with `Download tools` function (otherwise other functions are unlikely to work!)
|
||||
- Convert apks to apk first using `Convert apks to apk` function
|
||||
- Unpack apk with `Unpack apk` function
|
||||
- Use `Patch App` function and select the patches you want to apply to unpacked app except [Bypss GW934 checksum] patch
|
||||
- When done, apply the [Bypass GW934 checksum] patch, then use `Repack APK` function to recompile patched app
|
||||
- Patched app will be `MBCP_Flutter_SelfPatched.apk` on `~/mbbpatch/MBCPApp/mbcpapp_apk/`
|
||||
- Install it to your device (requires [MBCP Helper](https://git.disroot.org/mbcp/mbcp-helper/releases) / [CorePatch](https://github.com/lsposed/corepatch/releases) ) with enabled "Disable digest verify" option.
|
||||
- Profit :)
|
||||
|
||||
## TODO
|
||||
|
||||
- [ ] Bypass the new dex & libraries checksum for MB v6.4.67+ (hardcore challenge, would be extremely excited if this is achieved)
|
||||
- [ ] Bypass the new dex & libraries checksum for MB v6.4.67+
|
||||
|
||||
- [ ] Crash fixes for `Hide VTAP root detection activity & dialog` patch (OEM ROMs)
|
||||
|
||||
|
|
@ -197,25 +180,18 @@ cd ~/mbbpatch/MBCPApp
|
|||
|
||||
- [x] Adapt new v6.4.68 trungthu theme
|
||||
|
||||
## Contribute to project
|
||||
## Contributing | AI/LLM code or NOT ?
|
||||
|
||||
- Short answer : PRs are welcome. Just no Generative AI at all, all the code and assets (except from MB itself) must be made/written by yourself with no assistance from Generative AI.
|
||||
- Never, not even auto-complete LLM-powered suggestions. PR is currently closed for some personal reasons.
|
||||
|
||||
- Long answer : PRs are welcome, but you are NOT allowed to use any AI-tools for creating PRs with AI-generated/AI-assisted code to this project, even if it's manually reviewed by human. please use your brain and search engine & read documentation for that !
|
||||
<details>
|
||||
- Even though this project is NOT vibe-coded or AI/LLM-assisted, another dependencies that the project heavily rely on (APKEditor, coreutils, etc) may contains AI/LLM-generated code or assisted by AI/LLM. While I'm straightly disagree it, theres no escape for that in big 2026 (and also in few next years) so we have to accept the truth that some of dependencies the project relies on can contains AI/LLM code, but that doesn't mean I will code or put AI/LLM-assisted (or generated) code in this project at all.
|
||||
|
||||
- Even though this project is NOT AI-powered or assisted, another dependencies that the project heavily rely on (APKEditor, coreutils, etc) may have been filled up with AI-generated code or assisted by AI. While I'm straightly disagree it, theres no escape for that in big 2025 (and also in few next years) so we have to live with that AI-generated & AI-assisted code inside the dependencies, but that doesn't mean I will code or allows AI-generated & AI-assisted code in this project at all.
|
||||
- Remember : Projects may rely on dependencies that can contains AI/LLM code, but is written by a human and NOT LLM (or so calld Generative AI) doesn't mean the project contains AI/LLM code. Every single line of code is done by contributors and me (@cuynu) without any AI/LLM assistance at all.
|
||||
|
||||
- Remember : Projects that rely on dependencies that is already filled up with AI-generated & AI-assisted code or bulit on top of it but written by human and NOT Generative AI doesn't means the project is AI-powered or AI-generated project.
|
||||
|
||||
- If you wish to use Generative AI-tools for contributing, please go ahead and find for another project instead.
|
||||
|
||||
</details>
|
||||
- If you want to use Generative AI-tools / LLMs for contributing, please fork and do it yourself. We do not accept AI/LLM code in this project at all.
|
||||
|
||||
## Project history
|
||||
|
||||
- This project was made (and still maintained) by [@cuynu](/cuynu) with some help from other contributors, but in reality, I am not currently have enough skills with coding and project development yet and is still stupid. So some most of my commits is just minimal changes. **You can say me as a Developer/Dev and I'll embrace it because this project is not that easy to made, it's not what average person can even think as open source**. Maybe someday you'll see me ship more c/cpp code in this project :)
|
||||
|
||||
<details>
|
||||
|
||||
- 05/2023 : MB Bank MOD APK ANDROID project created on Telegram (@mbbmod), providing modified MB Bank APKs since v5.8 with lots of features such as bypassing accessibility check and show a guide to hide root instead of show rooted screen then close the app.
|
||||
|
|
@ -234,9 +210,7 @@ cd ~/mbbpatch/MBCPApp
|
|||
|
||||
- 10/2025 : MB discontinued `v6.4.66`, the last version with almost all patches working (except `bypass_accessibility_applist`) with `GW525` error when logging in
|
||||
|
||||
- 11/2025 : After multiple times lying myself and always said that I'm not a developer, **I embraced and claim myself as a MBCP developer** and still having skill issues, but atleast, I made this project, and solved the issues that MB's development team created to the MB Bank app by writing code to bypass them.
|
||||
|
||||
- 11/2025 (2) : MB released `v6.4.74` with AI-crap button that replaces legacy search button. I created a patch that force replace it back to old search icon.
|
||||
- 11/2025 : MB released `v6.4.74` with AI-crap button that replaces legacy search button. I created a patch that force replace it back to old search icon.
|
||||
|
||||
- 02/2025 : MB released `v6.4.85` with enhanced Singalarity eKYC detection (detects `data/adb/modules` and `com.rifsxd.ksunext`), so I created a patch that nuked the check.
|
||||
|
||||
|
|
@ -252,8 +226,8 @@ cd ~/mbbpatch/MBCPApp
|
|||
- [FlatIcon](https://flaticon.com) for some icons, including search icon, verified badge
|
||||
|
||||
## Contributors
|
||||
- [Cuynu](/cuynu) - (dev)
|
||||
- [fukiame](/fukiame) - refactor & other improvements (contributor)
|
||||
- [Ngankbakaa](https://github.com/miyukocutee) - (contributor)
|
||||
- [Cuynu](/cuynu) - developer (also [youtuber](https://youtube.com/@cuynu))
|
||||
- [fukiame](/fukiame) - refactor & other improvements - contributor
|
||||
- [Ngankbakaa](https://github.com/miyukocutee) - contributor
|
||||
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue