Skip to content

wenrou6/OneClickSkinCleaner

Repository files navigation

球球去皮 / OneClickSkinCleaner

Android CI

一个面向 球球大作战 的 Android 一键去皮工具。应用通过 Shizuku 运行用户服务,对游戏缓存中的皮肤商店配置文件进行权限屏蔽,让客户端不再读取对应皮肤配置。

主要功能

  • 一键连接 Shizuku。
  • 自动定位球球大作战缓存数据目录。
  • 仅处理 shopconfig.unity3d_u_ 前缀的皮肤商店配置缓存。
  • 不删除文件,不修改 ver.xml
  • 通过 chmod 000 屏蔽匹配文件读取权限。
  • 操作完成后返回“成功”或“失败”。

工作原理

目标缓存目录:

/storage/emulated/0/Android/data/com.ztgame.bob/files/vercache2022/android/common/data

核心流程:

  1. 使用 Shizuku 启动 UserService。
  2. 在 shell 权限下扫描目标缓存目录。
  3. 找出文件名以 shopconfig.unity3d_u_ 开头的文件。
  4. 对匹配文件执行 chmod 000
  5. 保留原文件和 ver.xml,不做删除或内容改写。

使用前准备

  1. Android 7.0 或更高版本。
  2. 已安装并启动 Shizuku。
  3. 在本应用中授予 Shizuku 权限。
  4. 设备上已安装球球大作战,并且游戏已生成对应缓存文件。

使用方法

  1. 安装 APK。
  2. 打开 Shizuku,并确保 Shizuku 已运行。
  3. 打开“球球去皮”。
  4. 点击“连接 Shizuku”。
  5. 授权成功后点击“一键去皮”。
  6. 显示“成功”即处理完成。

下载

请到本仓库的 Releases 页面下载 APK。

当前发布包使用 Android debug 签名,适合直接安装测试;如果需要正式发布版本,请自行配置 release 签名。

从源码构建

确保本机已安装:

  • Android Studio 或 Android SDK
  • JDK 17+

然后执行:

./gradlew :app:assembleDebug

Windows 也可以执行:

.\gradlew.bat :app:assembleDebug

构建产物位于模块的 Gradle 输出目录中,仓库不会提交 APK、AAB、签名密钥或本机配置文件。

测试

./gradlew test

隐私与安全说明

  • 仓库不会提交本机路径、local.properties、构建缓存、APK 产物或签名密钥。
  • 应用仅处理球球大作战缓存目录中的指定前缀文件。
  • 应用不会上传、收集或同步用户数据。

免责声明

本项目仅用于个人设备上的资源显示调整与学习研究。请遵守相关游戏服务条款和当地法律法规,风险自负。

About

Android Shizuku tool for removing Ball Battle skin shop config caches

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors