The most common use of Patch.tjs is to override existing engine methods. For example, if the game uses a function MessageWindow.drawText() , you can write a new version in Patch.tjs that adds logging, changes fonts, or skips rendering entirely.
This guide will explain exactly what these files are, how they work, and how to use them to get your favorite visual novels up and running on Android.
a specific title, the effectiveness of these scripts depends entirely on the specific version of the KiriKiri Z or KAG3 engine the game uses. write a custom filter for a specific game, or are you trying to bypass a specific error related to these files? Patch.tjs Xp3filter.tjs
When the game starts, the engine looks for Xp3filter.tjs to understand the mathematical "key" needed to unlock the data blocks within the archives.
Think of patch.tjs as a pre-loader or a configuration script. It's executed before the game even starts, allowing you to inject important instructions or modifications that the game needs to function correctly in the Android environment. The most common use of Patch
By default, the Kirikiri engine reads files in a specific order of priority. If a file named patch.tjs exists in the game’s root directory, the executable will typically load and execute it during the initialization phase. Modders use patch.tjs for several critical functions:
function XP3Filter(archive, filename) for (var pattern in overrideMap) if (filename.match(wildcardToRegex(pattern))) var newPath = overrideMap[pattern] + filename; if (Storages.isExistentStorage(newPath)) return newPath; // redirect to patch file a specific title, the effectiveness of these scripts
This is where patch.tjs shines. A clever modder can write a custom patch.tjs script that intercepts the file-loading sequence. It tells the engine: "If you are looking for script X, completely ignore the encrypted filter and read this unencrypted text file from the local folder instead." Troubleshooting Common Issues
: The most critical step is to find the correct patch.tjs and xp3filter.tjs files for your specific game. These are not universal; using the wrong file can cause the game to malfunction, crash, or fail to start. You can often find these files on fan forums, dedicated game pages, or in the game's own community patches.
The patch.tjs might be improperly configured, or necessary plugin files ( .dll on PC) need to be converted to .int files. Conclusion
Documentation on how to create an xp3filter · Issue #67 - GitHub