Skip to main content

Resource Pack Generator

Resource pack generation is a core feature of OnyxLib. Need not the worries of compiling a bunch of assets and json files into a singular resourcepack, OnyxLib does it for you!

How It Works​

  • Automatic ID Assignment: OnyxLib automatically gives every registered item a unique identifier based on its namespace and ID.
  • Texture Compilation: OnyxLib reads your code's .texture() paths to find the matching image files inside your plugin's JAR.
  • Custom Model Creation: OnyxLib uses item identifiers to generate the required custom model data JSON files.
  • Asset Validation: OnyxLib checks all referenced assets prior to generation and will notify the console of missing texture or JSON files.
  • Pack Generation: OnyxLib bundles all models, textures, and JSON files into a single resource pack.

Directory Structure​

For the generator to find your textures, place your image files in your plugin's src/main/resources/ directory following normal Minecraft conventions:

src/main/resources/
└── assets/
    └── myplugin/
        └── textures/
            ├── items/
            │   └── strawberry.png
            └── blocks/
                └── rainbow_ore.png

If you provide custom models using .model(), ensure your JSON files are placed under assets/<namespace>/models/.

Generating the Pack​

Trigger the generator from the server console or in-game as an admin (onyxlib.admin) or as an operator.

/onyx generatePack

This will run in the background. Once complete, an OnyxLib-generated.zip file will be generated inside the plugins/OnyxLib/ folder. Then use server.properties or a dedicated plugin to host the resource pack. :D