Vita3K-Quick-Guide
驱动安装及卸载
针对Android且Qualcomm Adreno GPU的设备，安装Mesa Turnip GPU驱动可以改善某些游戏的图形问题（并非所有），在此处下载Adreno Mesa Turnip GPU驱动，仅适用于Qualcomm Adreno 6xx/7xx GPU的安装步骤，当前安装驱动有两种方式：
- 安装
- 解压
Android建议是安装/更新至更高的版本（至少为Android 11），搭配Mesa Turnip GPU驱动以获取更好的游玩体验。
注意
- 低于Qualcomm Adreno 6xx GPU无可用的GPU驱动。
- 对于Qualcomm Adreno 6xx GPU且Android 10，需要使用turnip-v12-adpkg的GPU驱动（该驱动存在易卡死以及闪退问题，无法长时间游玩，建议更新系统版本）。此外该GPU不支持Mesa Turnip GPU驱动25.x.x后的版本，使用后会导致崩溃闪退，最高仅能使用24.x.x包括之前版本的GPU驱动。
- 对于Qualcomm Adreno 8xx GPU暂时无可用的GPU驱动，需耐心等待后续适配。
- 该内容仅适用于Qualcomm Adreno GPU，不支持其他GPU的安装。
安装
常规
常规安装自定义驱动步骤，基于K11MCH1的Vita3K驱动安装步骤：
- 下载对应您设备的GPU型号的驱动，打开Vita3K；
- 在顶部选项栏点击
配置->设置，点击GPU选项卡； - 点击
Add custom driver（添加自定义驱动），然后选择驱动zip文件； - 在
设置对话框的GPU选项卡中，在GPU的Default更换为已安装的新驱动。
解压（进阶）
在此之前您需要将您的设备解锁Bootloader，并使用apatch/KernelSU/Magisk为您的设备获取Root权限，另外安装MT管理器，才能进行下列步骤。
- 强烈提醒：未了解相关知识不建议使用该步骤，它可能会永久破坏您的设备数据。
- 下载对应您设备的GPU型号的驱动，打开MT管理器，并授权Root权限；
- 转到设备根目录（即/），找到/data/data/org.vita3k.emulator/files/driver路径；
- 解压驱动到该目录，新建txt文件，并命名为
driver_name.txt，文件中填写驱动so文件[driver].so后保存（例如turnip-23.2.0-A7XX.adpkg_R3驱动对应的驱动so文件是vulkan.ad07XX.so）; - 将所有文件属性更改为600权限、u0_aXXX（Vita3K）所有者和用户组（例如我设备中显示Vita3K的应用ID是10295，即u0_a295，其他设备的应用ID均有不同），若不更改则导致无法进入Vita3K；
- 设置完成后打开Vita3K，在顶部选项栏点击
配置->设置，点击GPU选项卡，在GPU中将Default更换为新驱动。
卸载
常规
常规卸载自定义驱动步骤：
- 打开Vita3K，在顶部选项栏点击
配置->设置，点击GPU选项卡； - 点击
Remove custom driver（移除自定义驱动）。
修改
如果使用错误的GPU驱动无法打开Vita3K，解决步骤如下：
- 使用原生文件管理器或MT管理器;
- 在/Android/data/org.vita3k.emulator/files找到config.yml使用文本文档将其打开；
- 将
custom-driver-name: [driver_name]更改为custom-driver-name: ""，将gpu-idx: 1更改为gpu-idx: 0，编辑完后保存，令其使用默认的GPU驱动； - 打开Vita3K，在顶部选项栏点击
配置->设置，点击GPU选项卡； - 切换不支持的驱动，点击
Remove custom driver（移除自定义驱动）。
特殊（PC）
仅针对PC版本，如果出现无法游玩以及闪退的情况，建议在显卡官方网站获取，下载并安装最新版本的显卡驱动，再尝试在Vita3K运行游玩。如果更新显卡驱动至最新版本，但仍低于OpenGL 4.4或Vulkan 1.0，且依旧无法游玩的情况下，请更换PC硬件配置或者新设备。