🛠Install | 📖Usage | 💡New insights | 💖Sponsor

简体中文 | English

Due to the fact that resource packs developed by the community for Minecraft cannot be encrypted like those in the Marketplace, there will always be a few unethical individuals who steal the code from our hard-developed resource packs and publish it without attribution.

We do not want this script to be used too frequently, as it goes against the spirit of collaboration and sharing within the community. If you are willing to contribute to the community, please do not release only obfuscated resource packs.

Enigmata

Enigmata is the Mythus Aeon from Honkai: Star Rail, it is a fallacy that all things can be experienced and recognized.

Enigmata is an open-source resource pack obfuscator for Minecraft Bedrock Edition. It adds markers to files and obfuscates Json key values while ensuring the game can read them correctly. Currently, it has several features, such as:

• Randomly permute and combine some visually similar characters to replace some JSON keys, values, and some file names.
• Adding specific information to the tEXt of each PNG and to the id section of each TGA.
• Merge JSON files in a folder.

Supported Resource Pack

This obfuscator has some limitations regarding the RP it supports. Most of these limitations are not difficult to resolve, but since I do not need them. Pull requests are welcome.

• NOT ADDON

• The JsonUI obfuscation feature will only obfuscate the controls in all JSON files within a specific folder. eg:

  ui/
  ├── hud_screen.json
  ├── inventory_screen.json
  └── namespace/
      ├── hud.json
      └── inventory.json
  

  It will only obfuscate the JsonUI in the namespace. If the JsonUI in the ui references controls from the former, the references will be obfuscated accordingly.

• When using the filename obfuscation feature, the obfuscated images should preferably not be in the root directory of the RP, as this may lead to unexpected results.

• When using the JsonUI and Entity series file merging features, files in subpacks are not merged. (The logic for excluding subpacks has not been tested.)

• When using the merging feature for Entity series files, filenames must comply with the standards for /.+?\.(animation_controllers|animations|renderer_controllers|geo)\.json/.

• and more?

Install

Your device needs to have Python 3.12 or higher version installed.

First, Download the source zip and unzip or using git to clone this repository:

git clone https://github.com/Eric-Joker/Enigmata.git
cd Enigmata

Next, use pip to install the dependencies:

pip install -r requirements.txt

Usage

Take a look at config_example.yaml for configuration, modify it and rename it to config.yaml.

Then, try running the following:

python main.py

All configurations in config.yaml have corresponding flags, which will take precedence over the file. Use -h to see details.

The obfuscated package will be output in the ./output, where obfuscation_reference.json will list the corresponding strings before and after obfuscation."

Under certain conditions, you may be required to update the Vanilla Data. You need to change the vanillas_path configuration to the directory containing all the vanilla RP of the latest version of Minecraft. Use -e to enter the data extraction process.

Donation

Because I am still a minor, the policies in my area make it difficult for me to get money here. 😭

Thanks

Thanks to all the contributors of this project!

Thanks for the help in finding more circle characters TangTang.