Guide
Creating your first armor
To create your first armor, you can use this template:
Right-click and
Save Link As...this armor.bbmodel to download a copy
You should see this in blockbench :
{width=900 height=483}
This template includes all the required bones and pivot points needed for your armor to work correctly. Be sure not to modify the pivot points or rename any of the bones. If you need to use a different bone name, choose one from the list below.
| Limbs | Aliases |
|---|---|
| Head | head, helmet, hat |
| Body | body, chest, torso |
| Left Arm | left_arm, leftarm, arm_l, l_arm |
| Right Arm | right_arm, rightarm, arm_r, r_arm |
| Waist | waist, hips |
| Left Leg | left_leg, leftleg, leg_l, l_leg |
| Right Leg | right_leg, rightleg, leg_r, r_leg |
| Left Foot | left_foot, leftfoot, foot_l, l_foot, left_boot, boot_l, left_feet, leftfeet, feet_l, l_feet |
| Right Foot | right_foot, rightfoot, foot_r, r_foot, right_boot, boot_r, right_feet, rightfeet, feet_r, r_feet |
Modify the cubes contained in each appropriate bone part to create the shaping of your armor.
The head bone is optional and is not in the template. Add a group named head and your set gains a helmet as well. A model that only has a head bone is fine too, so you can make a hat on its own.
Once complete, save your .bbmodel file (if asked, the separate texture file save is not needed and can be skipped) and place it in a Pack Source Folder such as plugins/MythicArmors/models or plugins/MythicMobs/armors/.
{width=800 height=450}
{width=800 height=450}
Finally, execute /ma reload - the Resource Pack should now generate as plugins/MythicArmor/pack.zip, and/or merge into a Pack Manager if configured to do so.
Once you have the resource pack equipped, either manually or distributed by the server, run the command /ma give [player] [armor_name] [helmet/chestplate/leggings/boots] to get your armor_name.bbmodel onto an armor piece and
And voilà! You can now try out your new armor!
{width=800 height=450}
Add it using Minecraft, MythicCrucible or Nexo
Vanilla Support
To give yourself the armor using vanilla commands:
/give @s minecraft:leather_helmet[minecraft:item_model="mythicarmor:name_of_your_armor_head_piece",minecraft:equippable={slot:head}]
/give @s minecraft:leather_chestplate[minecraft:equippable={slot:chest,asset_id:"mythicarmor:name_of_your_armor_chest_piece"}]
/give @s minecraft:leather_leggings[minecraft:equippable={slot:legs,asset_id:"mythicarmor:name_of_your_armor_legs_piece"}]
/give @s minecraft:leather_boots[minecraft:equippable={slot:feet,asset_id:"mythicarmor:name_of_your_armor_feet_piece"}]
Mythic Item/Crucible Support:
To create a custom Mythic Item that features your 3D Mythic Armor:
name_of_your_armor_head_piece:
Material: LEATHER_HELMET
Display: Name of your cool armor
Equippable:
Slot: HEAD
Options:
ItemModel: mythicarmor:name_of_your_armor_head_piece
name_of_your_armor_chest_piece:
Material: LEATHER_CHESTPLATE
Display: Name of your cool armor
Equippable:
Model: mythicarmor:name_of_your_armor_chest_piece
Slot: CHEST
name_of_your_armor_legs_piece:
Material: LEATHER_LEGGINGS
Display: Name of your cool armor
Equippable:
Model: mythicarmor:name_of_your_armor_legs_piece
Slot: LEGS
name_of_your_armor_feet_piece:
Material: LEATHER_BOOTS
Display: Name of your cool armor
Equippable:
Model: mythicarmor:name_of_your_armor_feet_piece
Slot: FEET
Nexo Item Support
To create a Nexo item featuring your Mythic Armor:
example_head_piece:
itemname: Example Hat
material: LEATHER_HELMET
Components:
item_model: mythicarmor:example_head_piece
equippable:
slot: HEAD
example_chest_piece:
itemname: Example Chestpiece
material: LEATHER_CHESTPLATE
Components:
equippable:
slot: CHEST
asset_id: mythicarmor:example_chest_piece
Custom icons
There are two ways to give armor its own inventory icons: put them in the .bbmodel, or ship them in your own resource pack.
Icons from your model
When your .bbmodel contains icons (see Icons), the items MythicArmors gives and generates for Nexo, MythicMobs/MythicCrucible and ItemsAdder already use them. Helmets you write yourself need nothing extra either: their usual item model, mythicarmor:name_of_your_armor_head_piece, then shows the 3D helmet on the head and the icon everywhere else. A chestplate, leggings or boots needs the item model mythicarmor:name_of_your_armor_chest_piece (_legs_piece, _feet_piece), the same name as its equipment model. Only add it to pieces that have an icon in the model.
name_of_your_armor_chest_piece:
Material: LEATHER_CHESTPLATE
Display: Name of your cool armor
Equippable:
Model: mythicarmor:name_of_your_armor_chest_piece
Slot: CHEST
Options:
ItemModel: mythicarmor:name_of_your_armor_chest_piece
/give @s minecraft:leather_chestplate[minecraft:item_model="mythicarmor:name_of_your_armor_chest_piece",minecraft:equippable={slot:chest,asset_id:"mythicarmor:name_of_your_armor_chest_piece"}]
In Nexo:
example_chest:
itemname: Example Chestpiece
material: LEATHER_CHESTPLATE
Components:
item_model: mythicarmor:example_chest_piece
equippable:
slot: CHEST
asset_id: mythicarmor:example_chest_piece
Leggings and boots work the same way, with their _legs_piece/_feet_piece model and LEGS/FEET slot.
Icons from your resource pack
By default the chestplate, leggings and boots show their base item's icon in the inventory (a leather tunic, pants or boots), and the helmet shows its 3D model. To show your own icon, give the item an item model (ItemModel in Mythic/Crucible, item_model in vanilla and Nexo) from a resource pack that is merged into the one your players get (with Nexo, under plugins/Nexo/pack/assets/). The examples use an icon texture at assets/mypack/textures/item/name_of_your_icon.png with this model, assets/mypack/models/item/name_of_your_icon.json (replace mypack with your own namespace):
{
"parent": "minecraft:item/generated",
"textures": {
"layer0": "mypack:item/name_of_your_icon"
}
}
Chestplate, leggings and boots
These get their 3D armor from Model/asset_id, so the item model only changes the icon. Point it at an item model that shows the icon, assets/mypack/items/name_of_your_icon.json:
{
"model": {
"type": "minecraft:model",
"model": "mypack:item/name_of_your_icon"
}
}
name_of_your_armor_chest_piece:
Material: LEATHER_CHESTPLATE
Display: Name of your cool armor
Equippable:
Model: mythicarmor:name_of_your_armor_chest_piece
Slot: CHEST
Options:
ItemModel: mypack:name_of_your_icon
/give @s minecraft:leather_chestplate[minecraft:item_model="mypack:name_of_your_icon",minecraft:equippable={slot:chest,asset_id:"mythicarmor:name_of_your_armor_chest_piece"}]
Leggings and boots work the same way, with their _legs_piece/_feet_piece model and LEGS/FEET slot.
Any other item model works too, such as a Nexo icon item's nexo:<item id>. In Nexo itself, a Pack texture next to the equipment model is enough:
example_chest:
itemname: Example Chestpiece
material: LEATHER_CHESTPLATE
Components:
equippable:
slot: CHEST
asset_id: mythicarmor:example_chest_piece
Pack:
texture: mypack:item/example_chest_icon
Helmets
Helmets are different: the 3D helmet is the item model itself (mythicarmor:name_of_your_armor_head_piece), and the game draws a helmet's item model on the head. Never give a helmet Equippable: Model (Mythic/Crucible) or asset_id (vanilla and Nexo). With one set, the game draws that equipment model on the head instead of the item model, and since MythicArmors makes no equipment model for heads, nothing shows.
The helmet's item model is therefore both its icon and its 3D model, so use an item model that switches on where the item is drawn: the 3D head piece on the head, your icon everywhere else.
assets/mypack/items/name_of_your_armor_helmet.json:
{
"model": {
"type": "minecraft:select",
"property": "minecraft:display_context",
"cases": [
{
"when": "head",
"model": {
"type": "minecraft:model",
"model": "mythicarmor:item/name_of_your_armor_head_piece"
}
}
],
"fallback": {
"type": "minecraft:model",
"model": "mypack:item/name_of_your_icon"
}
}
}
Then use mypack:name_of_your_armor_helmet as the helmet's item model:
name_of_your_armor_head_piece:
Material: LEATHER_HELMET
Display: Name of your cool armor
Equippable:
Slot: HEAD
Options:
ItemModel: mypack:name_of_your_armor_helmet
/give @s minecraft:leather_helmet[minecraft:item_model="mypack:name_of_your_armor_helmet",minecraft:equippable={slot:head}]
Keep Equippable: Slot: HEAD on Mythic items: without it a LEATHER_HELMET keeps the vanilla leather cap, which is drawn instead of your helmet.
On Nexo 1.27.0 or newer, the item's ItemModel section can build the switch for you. texture takes your icon texture, written as you would under Pack: texture (Nexo 1.20.1 to 1.26 need model: with an icon model like the one above instead):
example_hat:
itemname: Example Hat
material: LEATHER_HELMET
Components:
equippable:
slot: HEAD
ItemModel:
type: minecraft:select
property: minecraft:display_context
cases:
- when: head
model:
type: minecraft:model
model: mythicarmor:item/example_head_piece
fallback:
type: minecraft:model
texture: mypack:item/example_hat_icon
Nexo registers this as nexo:example_hat, so a Mythic item can point at it too with Options: ItemModel: nexo:example_hat.
Troubleshooting
Pack Applications
Ensure your resource pack is equipped and loaded properly - this can require configuration of your server, or manually downloading and loading the pack.zip the plugin generates in its plugin folder.
Entity Shaders
MythicArmors are incompatible with external core entity shaders. If you are using ModelEngine, ensure the plugins/ModelEngine/config.yml has create-shader set to false to disable this conflicting feature.
Helmet not showing on the head
Remove Equippable: Model (Mythic/Crucible) or asset_id (vanilla and Nexo) from the helmet, see Helmets. If a LEATHER_HELMET shows a plain leather cap instead, the Mythic item is missing Equippable: Slot: HEAD.