🚀 WHAT IS VULKANIZED POJAV?

This modpack was put together for Android users that want to use OR try the Vulkan Mod with the proper libraries it needs to actually work. Please make sure to pay close attention to the implementation tips and check the important information section below.

Note: Vulkan Mod is an ongoing community development project. It might be more performant on some devices but not on others, as the underlying architecture was originally made with PC platforms in mind.

---

🛑 TIPS & IMPORTANT INFO

Before launching the game, you MUST follow these critical configuration guidelines to avoid layout or driver crashes:

• 🛠️ System Driver Activation: You need to enable the "Use system Vulkan driver" toggle in the launcher you choose for this modpack to work properly. This will automatically allow the Vulkan rendering pipeline to initialize.
• ❌ Shaders Incompatibility: Post-processing shaders DO NOT work currently under the active Vulkan mobile pipeline translation layers. Keep them disabled to avoid rendering exceptions.
• 📦 External Modifications: Adding other external mods may cause runtime errors, as there is a documented list of incompatible modifications with the Vulkan path.
• ⚙️ Manual Optimization: Tinkering with individual in-game video settings profiles CAN still help you secure even more FPS on mobile hardware.
• 📚 Library Architecture: The bundled Vulkan libraries have 2 distinct versions. Version 1.21.11 only works with V1 of the libraries, whereas V2 libraries are required to work with the other version expansions shared in the project ecosystem.

---

⚙️ UNDER THE HOOD (How We Engine-Boost Your FPS)

Instead of adding heavy content or bloated modifications, this pack applies a surgical engine-level overhaul to streamline graphic processing and thread management:

• ⚡ Graphics Pipeline Redirection: By routing game data through low-overhead modern graphic interfaces, it bypasses heavy driver overhead, resulting in immediate frame rate multiplier drops and zero stuttering.
• 🧵 Asynchronous Multi-Threading: Forces code tasks that usually choke a single CPU core to split up across all available mobile cores. World data generation and chunk loading run on independent threads, letting you move at high speed without micro-freezes.
• 📦 Zero-Waste Memory Architecture: Implements a strict memory cleanup routine that slashes baseline garbage collection cycles, keeping your limited RAM pool optimized and immune to late-game lag accumulation.
• 👁️ Proactive Occlusion Culling: Blocks the hardware from processing or rendering complex geometry, entities, and particles hidden behind structural walls or underground layout paths, instantly reclaiming wasted GPU bandwidth.

---

📱 LAUNCHER CONFIGURATION & SYSTEM REQUIREMENTS

Specification	🟢 Minimum Profile (v1.21.10 / v1.21.11 Baseline)	🔴 Ultimate Profile (v26.1+ Expansion)
SOC Chipset & GPU	Supports ALL Android chipsets (MediaTek/Mali, Exynos, Unisoc, Low-End Snapdragon).	Hardcoded exclusively for Qualcomm Snapdragon (Adreno 600/700 Series Only).
Verified Hardware	Verified stable on Anbernic RG556 (Unisoc T618 // MaliG57 GPU) & Anbernic RG557 (Poco X6/X7 Pro D8300/D8400 equivalents).	Verified stable on Redmagic 10 Pro & Redmagic 11 Pro flagship architectures.
Vulkan API Path	Supports Vulkan 1.2+ architectures (known to work on Vulkan 1.0+ but not guaranteed).	Strictly requires native driver support for the VK_KHR_dynamic_rendering extension.
RAM Allocation	2.5GB RAM minimum runtime configuration.	3.5GB - 4GB RAM allocated engine buffer.
Launcher Paths	Works on ANY Pojav-based launcher profile (PojavLauncher, Mojo, Zalith, Amethyst).	Must be launched via Amethyst Launcher or Zalith Launcher profiles only.
Renderer Engine	Standard default launcher rendering paths or GL4ES hooks.	Must be set specifically to MobileGlues renderer framework.

---

❓ FREQUENTLY ASKED QUESTIONS

Q: Why is the file size so incredibly small?

A: That is 100% by design! This is a core performance baseline. We excluded heavy UI tweaks, shaders, and gameplay mods so you have a perfectly clean, ultra-fast environment to test your hardware's raw limits.

Q: My game force-closed immediately after launching. What happened?

A: First, ensure you properly enabled the "Use system Vulkan driver" toggle in launcher settings. Second, if you downloaded Version 26.1+ on a non-Snapdragon device (like MediaTek), it will crash—use Version 1.21.10 or below instead. Third, for 26.1+, make sure you are using the Amethyst/Zalith Launcher with the MobileGlues renderer selected.

Q: What is the "Failed to find queue family" crash error on version 26.1+?

A: This error means your device's internal GPU driver does not support or has locked the VK_KHR_dynamic_rendering extension. Since modern Vulkan optimizations strictly require this extension, the game will force-close. Please play Version 1.21.10 or below instead.

---

🤝 CREDITS & ACKNOWLEDGEMENTS

👑 Project Lead & Compiler

• Tio (Vulkanized Pojav Lead Developer) — Project compilation, configuration baseline tuning, and optimization structure management.

🌐 Mobile Porting Community Credits

• PojavLauncher, Amethyst, and Zalith Teams — For breaking barriers and making full-scale desktop engine execution flawless on the Android platform.
• MobileGlues Developers & Modders — For engineering state-of-the-art custom graphic driver hooks and translation patches that push hardware capabilities to their absolute extreme.