Custom Weapons
experimental
PLEASE READ
This page will be part of a rewrite to accomodate for the removal of the Holiday Creator Feature experimental toggle. Expect this page to be rewritten or removed when this happens.
Making a custom weapon is pretty simple since the 1.16.100 changes, as these allow you to simply define an item entry for it in your BP/items folder and provide a corresponding texture in the RP/textures/items folder with a bit of config and you have a fully working weapon that you can customize however you see fit.
Custom Sword Item
Like with the other item tutorials we will start by making a simple custom sword like so.
{
"format_version": "1.16.100",
"minecraft:item": {
"description": {
"identifier": "wiki:my_sword",
// Notice we give it the equipment category
"category": "equipment"
},
"components": {
// This allows us to have the sword in the creative category of swords
"minecraft:creative_category": {
"parent": "itemGroup.name.sword"
},
"minecraft:max_stack_size": 1,
// This is a new change as we want it to be equippable in the hand
"minecraft:hand_equipped": true,
"minecraft:durability": {
"max_durability": 600
},
// Give it however much damage you want
"minecraft:damage": 10,
// We also let it be enchantable in the "sword" slot
"minecraft:enchantable": {
"value": 10,
"slot": "sword"
},
// This texture is used for both inventory and the hand model
"minecraft:icon": {
"texture": "my_sword"
},
"minecraft:display_name": {
"value": "My Custom Sword"
},
// Allow the sword to be repaired with sticks
"minecraft:repairable": {
"repair_items": [
{
"items": ["minecraft:stick"],
"repair_amount": "context.other->q.remaining_durability + 0.05 * context.other->q.max_durability"
}
]
}
}
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
So at a bare minimum that is enough to get a sword put into the game, we still need to register the icon with the RP but thats not a massive issue as all we need to do is go to our RP folder and enter it in like so.
{
"resource_pack_name": "vanilla",
"texture_name": "atlas.items",
"texture_data": {
"my_sword": {
// Make sure you have put an icon texture called my_sword.png here
"textures": "textures/items/my_sword"
}
}
}
2
3
4
5
6
7
8
9
10
Here is an example texture if you do not have your own to use, just Save As and plop it in the RP/textures/items directory.
In-game
So now we have a BP containing our items json data and an RP containing the texture, we can make a new level, and make sure we include our BP/RP, however we also need to enable the Holiday Creator Features under experimental gameplay.
Once you have done all the above, go into creative mode and you should be able to find your sword by its name, or under the sword category as shown.
Then if you put it in your hands you should see it in the game like this.
Now that wasn't too hard was it! and you can make as many custom swords as you want now, however there is far more fun stuff you can do from here if you feel up for it.
Tool-like Functionality
You can also mix and match other components like minecraft:digger to allow you to go through web or bamboo quicker like this:
"minecraft:digger": {
"use_efficiency": true,
"destroy_speeds": [
{
"block": "minecraft:web",
"speed": 15
},
{
"block": "minecraft:bamboo",
"speed": 10
}
],
"on_dig":{
"event": "wiki:my_sword.on_dig_damage"
//Needed to change sword durability
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Also add an event:
"events": {
"wiki:my_sword.on_dig_damage": {
"damage":{
//This part of event will make sword take damage when it was used to dig block
"type":"durability",
"target":"self",
//By using "self" you define item as target to take damage
"amount":1
}
}
}
2
3
4
5
6
7
8
9
10
11
You can also give it a default mining speed by adding "minecraft:mining_speed": 1.5, which would give it a generic mining speed letting you use your weapon like a pickaxe. (It is currently broken)
Damage Tooltip
The above was a bare bones approach, but you probably want to be able to show the damage a sword does when the user hovers over it.
To do this you need to add the "minecraft:weapon": {} component, even if its just empty this is enough to MC to know internally to treat your popup like a weapon popup when mouse over-ing.
So if you add the above component to your item json file when you mouse over your sword you will now see +10 Attack Damage listed in its tooltip.
You may be thinking "why didn't you just add this above?" and the answer is because we will build off this component to add more cool stuff in the next section, so I wanted to keep it separate.
Unique ability & durability
At this point you could call it a day, but what if you wanted to make a sword that could inflict status effects, or teleport an enemy when they attacked you?
Assuming you wanted to do something like this we will need to build off the minecraft:weapon component and raise an event when the weapon hits an entity.
"minecraft:weapon": {
"on_hurt_entity": {
"event": "wiki:my_sword.hurt_entity"
}
}
2
3
4
5
Once we add that then every time you hurt an entity it will raise the event wiki:my_sword.hurt_entity. You can name this whatever you want, but if you end up with lots of events its recommended to have some level of namespacing, so in this scenario example is my main namespace, my_sword is the item I want it to apply on and hurt_entity is the related event on that item.
I could just as easily call the event "space-noodle" and it would work fine, but you want it to be easily searchable and self explaining, so keep that in mind
Now that we have an event being raised we can do what we want with it. In this example I am going to do 3 things:
- Teleport the player with 25% chance.
- Output a message letting the player know that something happened.
- Damage the sword.
So if you go back into your my_sword.json and after your components section add a new section like so.
"events": {
"wiki:my_sword.hurt_entity": {
"sequence":[
//Sequence is needed to run two or more parts of event
{
"randomize": [
{
// Weights are relative, so this has 1
"weight": 1,
// Teleport the HOLDER (you) within an 8x8x8 range
"teleport": {
"target": "holder",
"max_range": [8,8,8]
},
// Then tell some green text
"run_command":{
"command":[
"tellraw @s{\"rawtext\":[{\"text\":\"§aYour Sword Glows§r\"}]}"
]
}
},
{
// We have another dummy random element here which contains the max weight
"weight": 3
}
]
},
{
// I think you haven't forgot what this do
"damage":{
"type":"durability",
"target":"self",
"amount":1
}
}
]
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
That was a bit to bite off, but as explained above this lets us randomly 1/4 of the time trigger a teleportation of the sword holder and show a text command when it happens.
You can do whatever you want here and get super creative, set enemies on fire, or spawn enemies or blocks etc. There is so much you can do with this basic approach to creating weapons!
It's worth noting here that the dummy element is needed to scale the weightings, so we have one element with a weight of 1 and a 2nd one with a weight of 4 so this gives us the 1 in 4 chance of it proccing. If we were to have gone with the dummy element having a weight of 100 then we would have a 1 in 100 chance of proccing. If we didn't have a 2nd dummy element then the first weight would be ignored and it would happen 100% of the time.
Anything Else?
You should probably make a recipe for it, which is covered in previous chapters, as there isn't anything really new in there, but incase you are unsure here is an example one to make the sword with ender eyes and ender pearls.
{
"format_version": "1.12.0",
"minecraft:recipe_shaped": {
"description": {
"identifier": "wiki:my_sword"
},
"tags": ["crafting_table"],
"pattern": ["e", "E", "#"],
"key": {
"#": {
"item": "minecraft:stick"
},
"E": {
"item": "minecraft:ender_eye"
},
"e": {
"item": "minecraft:ender_pearl"
}
},
"result": {
"item": "wiki:my_sword"
}
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
If you whack that in then you can now craft your sword in the game and hopefully go off and make any other custom swords you fancy or even bows or tridents.
Contributors
