MORE NBT DOCUMENTATION
Version: 1.2.0

Index

Other Tags
moreNBT
damage_tool
animation
throwable

Back to top

Other Item Tags

These tags are used directly inside the items nbt example '/give @p paper{moreNBT:{nbt_format:1}}'

Parameters

Name	Type	Default Value	Description
moreNBT	JSON OBJECT		This tag is required for all items that use More NBT Tags Datapack. Get the latest format in-game by doing '/function more_nbt:get_current_nbt_format'. Name Type Description nbt_format Integer The format of More NBT Datapack Tags.
damage_tool	JSON OBJECT		Will deal damage to the tool when used. Only on minecraft:carrot_on_a_stick Name Type Description remove Integer How much damage to remove from the tool break_sound Boolean Use the break sound then the item has been consumed/broken. (May add more customizeabiliy to this.) disappears Boolean Make the item disappear/turn into air when broken. (May add more customizeabiliy to this.)
animation (W.I.P)	JSON OBJECT		Animated customModelData when held. Name Type Description looping Boolean Make the animation run year round. run Integer The amount of times to run the animation. only if looping=false frametime Integer The speed that it will flip through the models. frames Integer Array The CustomModelData integer to apply at that frame.
throwable (W.I.P)	JSON OBJECT		Throwable item component. Throwable items, such as a snow ball. Right now the entity will only go in the south direction, does not use players direction. This is planed to change. Only on minecraft:carrot_on_a_stick Name Type Description ammunition JSON OBJECT Throwable item component. Throwable items, such as a snowball. Name Type Description entity String The item/entity to throw. nbt Array (Optional) nbt that the entity has.

Back to top

---

MORE NBT DOCUMENTATION
Version: 1.2.0

Index

onUse
add_mob_effect
remove_mob_effect
die
transform_item
replaceitem
merge_data
show_text
decrement_stack
play_sound
score
damage
reload
random
summon

Back to top

Item onUse Tags

OnUse will run the contents when the player clicks while holding the item. You can find all these parameters below. Right now it only works on minecraft:carrot_on_a_stick item. In the future you will be able to use any/all items.

Parameters

Name	Type	Default Value	Description
add_mob_effect	JSON OBJECT		Will give the target the selected effect(s). Name Type Default Value Description target String The target context to execute against. effect String The minecraft effect. showIcon Boolean TRUE Show particles/icon.
remove_mob_effect	JSON OBJECT		Will remove the target the selected effect(s). Name Type Description target String The target context to execute against. effect String The minecraft effect.
die	JSON OBJECT		Will kill the target. Name Type Description target String The target context to execute against.
transform_item	JSON OBJECT		replace the curent holding item with the new determined item. Name Type Description transform String The item that will be replaced with.
replaceitem	JSON OBJECT		This will copy and move the item to the new selected Slot. Name Type Default Value Description slot String This is the slot the item will end up in. replace Boolean TRUE If false it will check to see if their already is an item in that slot.
merge_data	JSON OBJECT		Will apply the data. Name Type Description CustomModelData JSON OBJECT Replaces CustomModelData tag with value. Name Type Description value Integer Value it will replace. Damage JSON OBJECT Replaces Damage tag with value. Name Type Description value Integer Value it will replace. HideFlags JSON OBJECT Replaces HideFlags tag with value. Name Type Description value Integer Value it will replace. Unbreakable JSON OBJECT Replaces Unbreakable tag with value. Name Type Description value Integer Value it will replace.
show_text	JSON OBJECT		text releated objects. Name Type Description clear JSON OBJECT clears title, subtitle, and actionbar. Name Type Description target String The target context to execute against. say JSON OBJECT clears title, subtitle, and actionbar. Name Type Description text String The message to display. tellraw JSON OBJECT clears title, subtitle, and actionbar. Name Type Description target String The target context to execute against. raw_text String The JSON Formatted text to show. title JSON OBJECT clears title, subtitle, and actionbar. Name Type Description target String The target context to execute against. raw_text String The JSON Formatted text to show. subtitle JSON OBJECT clears title, subtitle, and actionbar. Name Type Description target String The target context to execute against. raw_text String The JSON Formatted text to show. actionbar JSON OBJECT clears title, subtitle, and actionbar. Name Type Description target String The target context to execute against. raw_text String The JSON Formatted text to show.
decrement_stack	JSON OBJECT		Will remove the selected item/weapon.main hand. Name Type Description gamemode Array A list of gamemodes that will remove the item. Put "all" for all gamemodes.
play_sound	JSON OBJECT		Will play the sound when the item is used. Name Type Description target String The target context to execute against. sound String The sound to play. Only some are currently supported
score	JSON OBJECT		add, remove, set scores on a scoreboard. Name Type Description add JSON OBJECT adds score. Name Type Description name String The target context to execute against. objective String Objective. Must be "score.test#" 0-9. amount Integer How much to add to score. set JSON OBJECT sets score. Name Type Description name String The target context to execute against. objective String Objective. Must be "score.test#" 0-9. amount Integer What to set the score to remove JSON OBJECT removes score. Name Type Description name String The target context to execute against. objective String Objective. Must be "score.test#" 0-9. amount Integer How much to remove from the score.
damage	JSON OBJECT		Will damage the target. Name Type Description target String The target context to execute against. type String The way to apply the damage: "EFFECT", "ARROW". amount Integer How many half hearts to apply to target.
reload	JSON OBJECT		Will reload the server. If it is a modded server (Spigot, Bukkit, Paper) it will run /reload confirm. Name Type Default Value Description confirm Boolean FALSE Must be set to true for it to reload server.
random	JSON OBJECT		Will output a random number from the min and max numbers. Name Type Description min Integer The minium number to use. Must be less than max. max Integer The maxium number to use. Must be more than min. result Integer This is the output. (SelectedItem.tag.onUse.random.result)
summon	JSON OBJECT		Summon an entity with optional nbt data. Name Type Description placement String How to place the entity. This may change. Valid strings: "ON_PLAYER","ON_BLOCK" entity String The entity to summon. nbt Array (Optional) nbt that the entity has.

Back to top

---

MORE NBT DOCUMENTATION
Version: 1.2.0

Examples:

When you click the item it will change the custom model data from 100 to 200.

/give @p carrot_on_a_stick{CustomModelData:100,onUse:{merge_data:{CustomModelData:{value:200}}}}

This will show a title, subtitle, and actionbar text when you click the item.

/give @p carrot_on_a_stick{onUse:{show_text:{title:{target:"this",raw_text:'{"text":"Hello From"}'},subtitle:{target:"this",raw_text:'{"text":"the other"}'},actionbar:{target:"this",raw_text:'{"text":"side"}'}},decrement_stack:{gamemode:["all"]}}}

This will use your name and add the text when you click on the item. If you are in survival it will remove the item.

/give @p carrot_on_a_stick{onUse:{show_text:{say:{text:"Want to play Minecraft?"}},decrement_stack:{gamemode:["survival"]}}}

When you click on the item it will place the item on your head. It will replace whatever is on your head.

/give @p carrot_on_a_stick{onUse:{replaceitem:{slot:"armor.head",replace:0b}}}

This carrot on a stick will shoot 16 carrot items at a time. It will also tell you how many uses you have left.

/give @p carrot_on_a_stick{display:{Name:'{"text":"Carrot Thrower","italic":false}',Lore:['{"text":"Right click to shoot stacks of carrots.","italic":false}']},moreNBT:{nbt_format:1},damage_tool:{amount:1,break_sound:1b,disappears:1b},throwable:{ammunition:{entity:"minecraft:item",nbt:[{Item:{Count:16b,id:"minecraft:carrot"}}]}},onUse:{show_text:{actionbar:{target:"this",raw_text:'[{"entity":"@p","nbt":"SelectedItem.tag.Damage"},{"text":"/24 Shots"}]'}},play_sound:{target:"this",sound:"minecraft:entity.snowball.throw"}}}