Matject v3.6.0

Last updated: Apr 16, 2025
Creators note: Some info on this page maybe a little outdated. I will update those soon.

💡 How to use? | 🔄 How to remove shaders

Features | Credits | Known issues | FAQ | Changelog

❌ DO NOT MIRROR/REUPLOAD THIS ANYWHERE! ❌

Warning

Versions including v3.5.0 and older ones have a dangerous bug that deletes all user files.
The bug has been fixed in v3.5.1.

For your safety, you should always use the latest version and avoid links from Google/YouTube.

DO NOT use old versions.
github.com/faizul726/matject is the ONLY official source for Matject.

Settings	Custom paths
matjectNEXT	Restore materials

You can also call it Matjet because it's as fast as a jet.
I know I'm exaggerating...

---

Important

DO NOT RUN MATJECT WITHOUT EXTRACTING THE ZIP FILE FIRST.

Make sure the shader you're using supports Windows and the game version.
Otherwise, you will see invisible blocks or the game will crash.

You can also enable material-updater in Matject Settings to fix invisible blocks.

• Non RenderDragon shaders (aka HAL) are not supported.
• You don't need BetterRenderDragon to use Matject.
• You don't have to open Matject every time for shaders.
• DO NOT USE Matject on debloated/optimized Windows (Atlas/Revi/Tiny/Chris Titus Tool)
• Matject ≠ Patched

✨ What's new in v3.6.0?

• Added auto version detection for material-updater
• Added new loading screen
• Added direct write mode
• Fixed full restore
• Other small technical changes
• See full changelog...

💡 Quick Guide

See Guide for Beginners for a better explanation.

1. Install IObit Unlocker

2. Download code as ZIP.
   Or use git clone https://github.com/faizul726/matject.git if you prefer.

3. Extract the ZIP file.

4. Open matject/matject.bat (with gear icon).

5. Follow on screen instructions.

See 📘 Detailed Guide

🔄 How to restore to default / uninstall shaders?

Tip

Original files are restored automatically when the game is updated.

1. Open Matject.
2. Go to [R] Shader removal/Tools.
3. Go to [1] Restore default materials
4. Select [1] Dynamic Restore or [2] Full Restore (both are same, except full restore takes a bit more time).

⭐ Features

• Easy to use: No Command Prompt/Terminal knowledge is required.
• Fully offline: Can be used offline. Internet is optionally used to enhance experience.
• Portable: All necessary files are stored in the same folder as Matject.
• Fast as jet: Takes less than 60 seconds to apply a shader.
• Preview support: Also supports Minecraft Preview backups and some settings are stored separately Preview and Release.
• Automatic backups: Backups are made automatically when game is updated.
• Restore game files: You can go back to original whenever you want.
• Automatic processing: MCPACK/ZIPs are automatically processed.
• Auto shader updater: Shaders can be updated using material-updater (also fixes invisible blocks).
• Auto updater: Can automatically update itself if you want.
• Dynamic file replacement: Keeps track of modified files and restores if needed.
• Highly customizable: Adjustments according to your needs can be made in Matject Settings.
• matjectNEXT: Applies shaders based on the first activated pack in Global Resource Packs.

🤝 Credits

• IObit Unlocker (backbone of Matject)
• @mcbegamerxx954 (for material-updater and speed improvements)
• jq (used to process JSON files for matjectNEXT)
• @jcau8 (critical bug fixes)
• @Veka0 (material compatibility checker)

Honorable Mentions
People of YSS and Newb Community for their humble support.

@TrngN0786 and @Theffyxz for helping me to fix bugs.
@Sharkitty, @FlaredRoverCodes, @BatmanBinSuparman49 and all other people who tested and gave feedback.

Need help?

Join any server below and mention me.
Bedrock Graphics In channel #matject
Or
Newb Discord server In channel #newb-support or #renderdragon
YSS Discord Server In channel #windows or #renderdragon

And, I will try to help you. I don't own any Discord server.

⚠️ Known issues

• Doesn't support long folder path and too many shader files.
• Some antivirus may prevent IObit Unlocker from working. (AVG and Norton are known to do this)
• Some shaders crash or show red sky. It's not an issue of Matject.

🤔 FAQ

Q. Is it safe?
A. Yes, it is. You're welcome to review the code.

Q. What is matjectNEXT?
A. matjectNEXT is an advanced version of Matject that replaces materials based on the pack the user has set in Global Resource Packs, with help of jq.
Inspired by Draco which is made by @mcbegamerxx954.

Q. How is this different from BetterRenderDragon?
A. BetterRenderDragon uses memory injection, all the changes are made in memory and those don't persist. You have to open BRD each time to use shaders.
It's not universal, so BRD devs have to update it for newer Minecraft versions to make it work.
Changes made by Matject will stay until Minecraft is updated or user restores default materials from Matject.
It's mostly universal, so it should work with any Minecraft version.

Q. Does it require internet to work?
A. No, internet is optionally used to enhance user experience

• To check for updates and show the changelog. Updating is optional.
• To show Matject announcements
• To get jq by itself (for matjectNEXT).
• To get material-updater by itself.

Q. I have questions/need help.
A. Ask in one of the Discord servers above

Q. What folders does it access?

A. It accesses the following folders:

READ only:

• %ProgramFiles(x86)%\IObit\IObit Unlocker\IObitUnlocker (backbone of Matject)
• Minecraft app location. Which is obtained using this PowerShell command:

(Get-AppxPackage -Name Microsoft.Minecraft*).InstallLocation

• %LOCALAPPDATA%\Packages\Microsoft.Minecraft*_8wekyb3d8bbwe\LocalState\games\com.mojang\minecraftpe\global_resource_packs.json (for matjectNEXT)
• %LOCALAPPDATA%\Packages\Microsoft.Minecraft*_8wekyb3d8bbwe\LocalState\games\com.mojang\resource_packs\* (for matjectNEXT)
• .settings Backups\* Backups (Preview)\* logs MATERIALS MCPACKS modules\* tmp
• Custom paths: Minecraft app, data, IObit Unlocker

READ and WRITE:

• %ProgramFiles%\WindowsApps (to unlock WindowsApps)
• %ProgramFiles%\WindowsApps\Microsoft.Minecraft*_*_*__8wekyb3d8bbwe\data\renderer\materials
• %LOCALAPPDATA%\Packages\Microsoft.Minecraft*_8wekyb3d8bbwe\LocalState\games\com.mojang\minecraftpe\global_resource_packs.json (to reset global packs)
• .settings Backups\* Backups (Preview)\* logs MATERIALS modules tmp
• Custom paths: Minecraft app, data

Q. মুরগি কি ধান খায়? 🐓
A. হ, খায়।

Donate

Matject is free, and it always will be.

If you genuinely like Matject, you can donate to support its development.
You can still show your support by giving a star to this project :)

🕓 Changelog

v3.6.0 - Apr 16, 2025

• Added auto version detection for material-updater [preview not supported]
• Added direct write mode: Use normal move/delete commands instead of IObit Unlocker [sideloaded installation only]
• Added new settings UI for material-updater
• Added a brand new loading screen
• Added a setting to change the number of materials processed per cycle for full restore
• Added a secret game
• Reworked full restore logic: It should work better now
• Full restore no longer empties backup folder
• A warning now will be shown if materials are ntot moved/deleted properly
• MATERIALS folder now has to be empty before using auto/manual
• Custom path toggle color will be orange if path is invalid
• matjectNEXT now supports IObit Unlocker popup reduction
• Updated about screen
• Fixed non-English text display issues in some places
• Fixed an issue with GameData location
• Lots of small UI improvements

v3.5.2 - Feb 21, 2025

• Fixed WindowsApps unlock failure
• Fixed Minecraft Preview backup handling
• Auto closing for IObit Unlocker no longer shows a separate window
• Shortcuts can now open Matject in Windows Terminal
• Added notification sound in some confirmation screens
• Added a setting to force using PowerShell for extracting ZIPs
• Added 10 new Matject tips
• Added MIT license
• Improved Matject opening behavior
• Improved admin permission detection
• Improved shortcut creation/deletion
• Minor UI improvements

v3.5.1 - Feb 02, 2025

• Fixed a CRITICAL BUG that deletes all user files.
• Added module verification to ensure reliability.
• Matject no longer runs when tried to run without extracting.
• Matject now uses more "specific" locations.
• Fixed an issue with Matject updater.
• Fixed an issue with full restore.
• Other minor changes.

v3.5.0 - Jan 15, 2025

• Added Matject updater.
• Added multiple MCPACK/ZIP support for MCPACKS folder.
• Added Matject tips.
• Added "Show announcements" setting.
• Added "Disable tips" setting.
• Added "Run Matject as admin always" setting.
• Added "Run IObit Unlocker as admin" setting to reduce admin permission requests.
• Added manifest checker for matjectNEXT.
• Added more bugs to fix later.
• Auto mode now shows last MCPACK and subpack name.
• Restore screen now shows restore date.
• ZIPs now can also be opened as MCPACK.
• IObit Unlocker messages are now automatically closed when Matject is run as admin.
• Getting Minecraft details is now faster.
• First run now asks to download material-updater.
• curl should no longer be able to execute using variables.
• Fixed a math related issue with update checker.
• Fixed a issue with how MCPACKs are processed Thanks to raden
• Cursor is now hidden where it's not needed.
• Some UI improvements.

v3.4.0 - Dec 23, 2024

• Added subpack support for auto method.
• Added zipped materials support for auto method.
• Added new settings: Don't open folder automatically.
• Added loading text (not everywhere)
• Added reset settings option.
• Added Drop to shell (needs debug mode)
• Can now make shortcuts.
• New icon if using shortcut.
• Optimized folder opening.
• Optimized update checker.
• Should no longer cause crashes when folder name contains space.
• Should no longer fully exit if something goes wrong.
• Preview mode now is automatically disabled when not installed.
• Other minor changes.

v3.3.0 - Dec 10, 2024

• Added Minecraft Preview support.
• matjectNEXT now can be used without DEBUG MODE.
• Improved matjectNEXT functionality.
• Improved extract speed by using tar.
• Improved settings functionality.
• Improved backup ZIP check.
• Fixed Dynamic Restore comparison.
• Fixed OLDVERSION variable.
• Delete Backups folder if empty.
• Other minor changes.

v3.2.2 - Dec 06, 2024

• Added custom Minecraft launcher support (thanks to @TrngN0786)
• Added custom Minecraft data path support
• Added custom IObit Unlocker path support
• Added interruption check
• Added restore confirmation
• Added an easter egg
• Update checker now shows the changelog
• Fixed colors in some texts
• Fixed RESTORELIST variable (thanks to @TrngN0786)
• Fixed Minecraft app path and Just sync and exit toggle
• Other minor bug fixes

v3.2.1 - Dec 04, 2024

• Fixed matjectNEXT unable to find pack path (once again thanks to @jcau8)
• Added compatibility check for materials (thanks to @Veka0)
• Revamped settings page with tabs
• Several small improvements to functionality
• Added development_resource_packs support (matjectNEXT)
• Improved MCPACK detection
• Added the ability to replace backup using ZIP file (Restore & Others)

v3.2.0 - Nov 26, 2024

• Added matjectNEXT.
• Fixed writing on encrypted drives. (thanks to @jcau8)
• Added curl check.
• Renamed Partial Restore to Dynamic Restore.
• Improved Dynamic Restore speed.
• Fixed some typos.
• Other minor bug fixes.

v3.1.0 - Nov 18, 2024

• Bump version.
• Fix credit names PR #4.

v3.0.3 - Nov 16, 2024

• Added update checker (thanks to @jcau8).
• Moved variables to variables.bat.
• Fixed some typos.
• Delete backup date file after full restore.
• Added GitHub link in others.
• Changed pushd to cd /d.

v3.0.2 - Nov 15, 2024

• Fixed directory changing and unlockWindowsApps (thanks to @Theffyxz).
• Added update checker module as a placeholder.
• Added credits section in README.

v3.0.1 - Nov 13, 2024

• Fixed unlockWindowsApps not saving result.
• Updated "about" details.
• Semantic Versioning (something that I still don't understand properly).

v3.0 - Nov 06, 2024

• Fixed partial restore.
• Added material-updater support.
• Added help (but not helpful).
• Added settings.
• Added date for backup.
• Added the ability to open MCPACK automatically after injection.
• Added first run message.
• Made backup mandatory.
• Improved home screen.
• Only accept *.material.bin files.
• Removed openMinecraftFolder.bat and added it as a separate option.

v2.5 - Oct 20, 2024

• Added colored texts.
• Removed settings.bat placeholder as it's not required before v3.0.

v2.0

• Much more user-friendly than before.
• Dynamically finds Minecraft location.
• Skips questions if user meets requirements.
• Prompts to delete backup if it detects a different Minecraft version.
• Restores vanilla shaders (BETA).
• Shows error if user declines UAC and asks again.
• Automatically opens MCPACK/MATERIALS folder for user to put files.
• Extracts materials from user-provided MCPACK/ZIP (still can't detect if it's an RD shader).
• Dynamically restores only modified bins from previous inject to ensure consistency among different shaders (BETA) (works only if user has made a backup before).
• Added settings.bat for tweaking options (WIP).
• Added openMinecraftFolder.bat to open the Minecraft folder.
• Simplified WindowsApps unlock procedure; now it unlocks instantly.

v1.0

• Initial release.