How to customize your item appearance?
Unlike most other plugins that allow you to create custom items, oraxen supports the creation of a texture pack: that is, you can define directly in the configuration what you want your items to look like and it will take care of generating the pack. For minecraft, the appearance of each item is managed by a json file called the model. Most of the items have a very simple model that simply displays a two-dimensional texture. To avoid having to write this json file (which is repetitive and boring), you can ask Oraxen to generate it itself.
This folder (./plugins/Oraxen/pack) contains your pack. It works like a normal minecraft texture pack but simpler. You can drag your textures into the textures folder and your models into your models folder. You can also create sub-folders inside these folders to make it cleaner but it's not necessary. When the plugin generates the resource pack it appears in this folder under the name pack.zip.
Put the textures that you need in the textures directory of the pack folder. You can then ask Oraxen to generate the model by superposing the textures :
- example_image1.png #png extension is not needed
The parent_model field is required by minecraft. In fact this will allow your item to inherit the rendering properties of an item template from minecraft. You can look at the minecraft default models in order to find new ones but I personnaly use item/handheld for weapons like swords and item/generated for simple items or gems like amethysts.
Creating a json model can be time consuming but it allows you to create really cool things (like 3d items). It is really easy to integrate a json model with Oraxen : put your textures in your textures directory and your model in your models directory (inside Oraxen/pack folder). Then you can ask Oraxen to put this model on one of your items:
model: example_model.json #json extension is not mandatory
Usually the templates you get place the textures in a folder, to make sure, open the json file and look at the first few lines, you should find something similar:
"__comment": "Designed by HighBridRed for Oraxen",
As you can see, the path to the texture is custom/bonesword_palette, that means minecraft will be looking for a texture called bonesword_palette.png in the folder "custom", so you need to create this folder inside "Oraxen/pack/textures". You can also remove "custom/" and keep the texture name only, so you just have to drag and drop it inside the textures folder without creating a subfolder.
If you want to use a custom model for a shield, you need to specific the blocking model which will be used when a user right click using your shield, hopefully this is easy with Oraxen. Here is what it can look like:
model: example_shield.json #json extension is not mandatory
blocking_model: example_shield_blocking.json #json extension is not mandatory
If you want to use a custom model for a shield, you need to specific the pulling model which will be used when a user right click using your bow, hopefully this is easy with Oraxen. Here is what it can look like:
firework_model: default/custom_bow_charged #not so necessary