**vred’s Data-Pack Library** (vred’s DP Lib for short) is the first Data-Pack library I’ve ever made.
\nThe main scope of this project is to add useful tools for creating custom items faster and more easily.
\nThis tools is split into different sections:
\n– **Data Components**
\n– **Behaviour Components**
\n– **Function Tags**
\n– **Misc**<\/p>\n
> **Data Components** **string**<\/p>\n This one doesn’t really do anything important, just defines the **Example:**<\/p>\n ## **string**<\/p>\n This one very important, as it’s required for upcoming components. **Example:**<\/p>\n ## **string**<\/p>\n This one is also very important, as it’s required for upcoming components too. **Example:**<\/p>\n ## > **Behaviour Components** **boolean**<\/p>\n This will run a command on hit. “` **Example:**<\/p>\n ### give @s arrow When hitting an entity (either arrow or hand) it will give an arrow to the player.<\/p>\n<\/details>\n **boolean**<\/p>\n This will run a command when recieving a hit. “` **Example:**<\/p>\n ### “` While holding the shield in offhand, recieving a hit from an entity will push it away by 2 blocks.<\/p>\n<\/details>\n **boolean**<\/p>\n This will run a command when kiling an entity. “` **Example:**<\/p>\n ### “` effect give @s strength 10 1 true After killing an entity, the user will get strength 2 for a few seconds.<\/p>\n<\/details>\n **boolean**<\/p>\n This will run a command when pressing the sneak button twice in a small amount of time. “` **Example:**<\/p>\n ### effect give @s speed 2 2 This will make the stick give speed 3 when tapping the sneak button twice in quick succession(while holding the item in either hand).<\/p>\n<\/details>\n **boolean**<\/p>\n This will run a command when sneaking once (tapping). “` **Example:**<\/p>\n ### “` This will make the boots give jump boost and emit particles when tapping sneak.<\/p>\n<\/details>\n **string**<\/p>\n This component will spawn an interaction entity in front of the player while the player is holding the item in the main hand. The interaction entity can be used for both right and left click and the functions will be ran like this: If it’s “interaction:no_shift”, the interaction entity will always be there. **Example:**<\/p>\n ### say left click say right click **boolean**<\/p>\n This will run a command while holding right click. It requires the food component: “` **Example: (needs to be changed)**<\/p>\n ### “` **string**<\/p>\n This will create a custom item like a bow that doesn’t require arrows. To make the effect look better, use matching custom model data between base item and bow. It can run a function when shooting the \"arrow\":<\/p>\n ``` **Example:**<\/p>\n ### ``` If the bow-like item has been in use more than 21 ticks, it will summon a tnt 5 blocks foward. **This will only work in the main hand**.<\/p>\n<\/details>\n **boolean**<\/p>\n When dropping the item from the main hand, it reference an item modifier based on the ``` **Example:**<\/p>\n ### ``` # data\/example\/item_modifier\/page\/multitool\/2.json # data\/example\/item_modifier\/page\/multitool\/2.json # data\/example\/item_modifier\/page\/multitool\/3.json # data\/example\/item_modifier\/page\/multitool\/4.json The example is a pretty simple multitool, where each \"page\" switches the multitool to a different item. An important thing to mention is that each item modifier changes the > **Function Tags** Works identically to normal Tick function only for entity, excluding the player. Tick function only for player. > **Misc** This predicate includes entities that shouldn't be targeted. - Display entities; Simple You can use a predicate to check if the player has the same ID as the specified ID (stored in a fake player on a scoreboard). This score will be used for different mod compats. The mod name is stored with acronym. The main and only example at the moment is **Iron's Spells and Spellbooks**.<\/p>\n To check if the mod is present, check the The compatibilies will be expanded in the future with more mods, be sure to send some suggestions! This tag checks if the player has at least 1 free inventory and hotbar slot. If it has one, the player will have the tag. You can add custom projectiles. These projectiles are very barebones and don't even have gravity (will changed in the future).<\/p>\n To add a custom projectile, The Later then use You can add custom particles. These particles are very barebones and are just fancy item displays that move. ```# data\/example\/function\/particle_load.json # data\/example\/function\/particle\/load.mcfunction In order to summon it: Back to our example: A data-pack “library” makes the creation of custom weapons easier.<\/p>\n","protected":false},"featured_media":167898,"template":"","meta":{"_minecraft_slug":"vreds-dp-lib","_minecraft_project_id":"n0NYEIzQ","_minecraft_author":"vred_","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":339,"_minecraft_follows":0,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"vreds-dp-lib.zip","_minecraft_size_bytes":219476,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:35:15.358454Z","_minecraft_date_created":"2026-03-16T06:30:32.388679Z","_minecraft_date_modified":"2026-03-12T16:03:36.322613Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vreds-dp-lib","_minecraft_icon_attachment_id":167898,"_minecraft_imported_at":"2026-06-09T19:20:06+00:00","_minecraft_import_hash":"1d116e5f862a6c1f6914f8f46190b29b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,88,97,104,873,158,98,92],"mod_loader":[86,99,106,160,100],"minecraft_version":[62,37],"class_list":["post-167897","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-equipment","mod_category-fabric","mod_category-forge","mod_category-library","mod_category-neoforge","mod_category-quilt","mod_category-utility","mod_loader-datapack","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","mod_loader-quilt","minecraft_version-1-21","minecraft_version-1-21-1"],"yoast_head":"\n
\nThese define information about the item. Which will be quite important!
\n## As general rule, every vred’s DP lib component goes in the “…” part
\n## custom_data={vred_lib:{...}}<\/code><\/p>\nComponent:
id<\/code><\/summary>\nid<\/code> of an item.<\/p>\ngive @s stick[custom_data={vred_lib:{id:\"example:cool_stick\"}}]<\/code>
\n<\/details>\nComponent:
weapon_id<\/code><\/summary>\nid<\/code> contains 2 parts, one of these is the weapon_id<\/code>, which is the part after the “:”.
\nIt requires a folder named from weapon_id<\/code> in the current datapack. As for the namespace, it will be taken from the next component, namespace<\/code>.<\/p>\ngive @s stick[custom_data={vred_lib:{id:\"example:cooler_stick\",weapon_id:cooler_stick}}]<\/code>
\nThis item won’t do anything yet.
\n<\/details>\nComponent:
namespace<\/code><\/summary>\nid<\/code> contains 2 parts, one of these is the namespace<\/code>, which is the part before the “:”.
\nIt requires a folder named from namespace<\/code> in the current datapack. <\/p>\ngive @s stick[custom_data={vred_lib:{id:\"example:very_cool_stick\",weapon_id:very_cool_stick,namespace:example}}]<\/code>
\nThis item won’t do anything yet.
\n<\/details>\n
\nThese will run functions in a specific condition.
\nThese require a certain slot to work with:<\/p>\nmainhand:{...}<\/code> in mainhand.<\/p>\noffhand:{...}<\/code> in offhand.<\/p>\nhead:{...}<\/code> head slot.<\/p>\nchest:{...}<\/code> chest slot.<\/p>\nlegs:{...}<\/code> legs slot.<\/p>\nfeet:{...}<\/code> feet slot.<\/p>\nall:{...}<\/code> all the previous slots.<\/p>\nhand:{...}<\/code> either hand.<\/p>\narmor:{...}<\/code> any armor slot.<\/p>\nComponent:
on_hit_effect<\/code><\/summary>\n
\nThe function that will be run is this:<\/p>\n
\ndata\/
\n“`<\/p>\ngive @s bow[custom_data={vred_lib:{id:\"example:fast_bow\",weapon_id:fast_bow,namespace:example,hand:{on_hit_effect:true}}}]<\/code><\/p>\n
\n# data\/example\/function\/fast_bow\/on_hit.mcfunction<\/p>\n
\nsay I hit an entity!
\n<\/code><\/p>\nComponent:
entity_hit_effect<\/code><\/summary>\n
\nThe function that will be run is this:<\/p>\n
\ndata\/
\n“`<\/p>\ngive @s stick[custom_data={vred_lib:{id:\"example:strong_shield\",weapon_id:strong_shield,namespace:example,offhand:{entity_hit_effect:true}}}]<\/code><\/p>\n
\n# data\/example\/function\/strong_shield\/entity_hit.mcfunction
\neffect give @s resistance 4 1 true
\nexecute rotated as @s on attacker run tp @s ^ ^ ^2
\n“`<\/p>\nComponent:
on_kill<\/code><\/summary>\n
\nThe function that will be run is this:<\/p>\n
\ndata\/
\n“`<\/p>\ngive @s iron_sword[custom_data={vred_lib:{id:\"example:bloodlust\",weapon_id:bloodlust,namespace:example,mainhand:{on_kill_effect:true}}}]<\/code><\/p>\n
\n# data\/example\/function\/bloodlust\/on_kill.mcfunction<\/p>\n
\n“`<\/p>\nComponent:
double_sneak_effect<\/code><\/summary>\n
\nThe command will be run as such:<\/p>\n
\ndata\/
\n“`<\/p>\ngive @s stick[custom_data={vred_lib:{id:\"example:very_cool_stick\",weapon_id:very_cool_stick,namespace:example,hand:{double_sneak:true}}}]<\/code><\/p>\n
\n# data\/example\/function\/very_cool_stick\/double_sneak.mcfunction<\/p>\n
\n<\/code><\/p>\nComponent:
tap_sneak_effect<\/code><\/summary>\n
\nThe command will be run as such:<\/p>\n
\ndata\/
\n“`<\/p>\ngive @s diamond_boots[custom_data={vred_lib:{id:\"example:jumping_boots\",weapon_id:jumping_boots,namespace:example,feet:{tap_sneak:true}}}]<\/code><\/p>\n
\n# data\/example\/function\/jumping_boots\/tap_sneak.mcfunction
\neffect give @s jump_boost 3 1
\nparticle cloud ^ ^ ^ 0 0 0 0.2 30
\n“`<\/p>\nComponent:
interaction<\/code><\/summary>\n
\n“`
\ndata\/
\ndata\/
\n“`<\/p>\n
\nIf it’s “interaction:shift”, the interaction entity will only appear while the player is shifting.<\/p>\ngive @s netherite_shovel[custom_data={vred_lib:{id:\"example:offbrand_spear\",weapon_id:offbrand_spear,interaction:no_shift}}]<\/code><\/p>\n
\n# data\/example\/function\/offbrand_spear\/left_click.mcfunction<\/p>\n
\n<\/code><\/p>\n
\n# data\/example\/function\/offbrand_spear\/right_click.mcfunction<\/p>\n
\n<\/code><\/p>\n<\/details>\nComponent:
no_interaction_right_click<\/code><\/summary>\nminecraft:food={nutrition:0,saturation:0,can_always_eat:1b,eat_seconds:1000000}<\/code>
\nThe function will be ran constantly while holding right click.<\/p>\n
\ndata\/
\n“`<\/p>\ngive @s blaze_rod[custom_data={vred_lib:{id:\"example:hot_rod\",weapon_id:hot_rod,namespace:example,no_interaction_right_click:1b}},food={nutrition:0,saturation:0,can_always_eat:1b,eat_seconds:1000000}]<\/code><\/p>\n
\n# data\/example\/function\/hot_rod\/right_click.mcfunction
\nexecute anchored eyes run particle flame ^ ^ ^1
\nexecute anchored eyes run particle flame ^ ^ ^2
\nexecute anchored eyes run particle flame ^ ^ ^3
\n“`<\/p>\n<\/details>\nComponent:
weapon_type:bow<\/code><\/summary>\n
\nThe component requires the food component: minecraft:food={nutrition:0,saturation:0,can_always_eat:1b,eat_seconds:1000000}<\/code>
\nAnd will require a base item: {vred_lib:{base_item:\"
\ndata\/
\n```<\/p>\ngive @s breeze_rod[custom_data={vred_lib:{id:\"example:tnt_wand\",weapon_id:tnt_wand,namespace:example,weapon_type:bow,base_item:\"minecraft:breeze_rod\"}}]<\/code><\/p>\n
\n# data\/example\/function\/tnt_wand\/shot.mcfunction
\nexecute if score @s component.bow.timer matches 21.. run summon tnt ^ ^ ^5 {Fuse:0s}
\n```<\/p>\nComponent:
scrollable<\/code><\/summary>\nmap_id<\/code> component.
\nThis is a brand new system I made for displaying item descriptions, as each item modifier can reference a different lore page and change the map_id<\/code> to go on the next page.<\/p>\n
\ndata\/
\n```<\/p>\ngive @s diamond_sword[custom_data={vred_lib:{id:\"example:multitool\",weapon_id:multitool,namespace:example,scrollable:1b}},map_id=1,unbreakable={}]<\/code><\/p>\n
\n# data\/example\/item_modifier\/page\/multitool\/1.json (you can't have comments in json)
\n[{function:\"set_item\",item:\"minecraft:netherite_axe\"},{function:\"set_components\",components:{map_id:2}}]<\/p>\n
\n[{function:\"set_item\",item:\"minecraft:diamond_pickaxe\"},{function:\"set_components\",components:{map_id:3}}]<\/p>\n
\n[{function:\"set_item\",item:\"minecraft:diamond_pickaxe\"},{function:\"set_components\",components:{map_id:3}}]<\/p>\n
\n[{function:\"set_item\",item:\"minecraft:diamond_shovel\"},{function:\"set_components\",components:{map_id:4}}]<\/p>\n
\n[{function:\"set_item\",item:\"minecraft:diamond_hoe\"},{function:\"set_components\",components:{map_id:1}}]
\n```<\/p>\nmap_id<\/code> for next item modifier to use.<\/p>\n<\/details>\n
\nVarious function tags I use. Why not use the vanilla ones? I don't know.<\/p>\n#vred_lib:load<\/summary>\n
#minecraft:load<\/code> function. No idea why I made it.<\/p>\n<\/details>\n#vred_lib:entity<\/code><\/summary>\n
\n<\/details>\n#vred_lib:entity<\/code><\/summary>\n
\n<\/details>\n
\nContains various miscellaneous, but useful stuff.<\/p>\nPredicate:
vred_lib:stuff<\/code><\/summary>\n
\nIt includes:<\/p>\n
\n- Entities being ridden;
\n- Dropped items;
\n- Arrows.<\/p>\n<\/details>\nPredicate:
vred_lib:id_check<\/code><\/summary>\nid<\/code> system. Each player gets a vred_lib.id<\/code> score. <\/p>\n
\nIn this case, this predicate will only trigger if the player\u2019s vred_lib.id<\/code> score is equal to the vred_lib.id<\/code> score of the fake player (#temp). <\/p>\n<\/details>\nScore:
vred_lib.config<\/code><\/summary>\nvred_lib.config<\/code> score of the fake player #iss_compat<\/code>.
\nIf the score is 1, that means the mod is present. **The detection works by using a command from the mod.**
\nThere's also the vred_lib.iss.mana<\/code> score, which can be used to check the amount of mana of the player.<\/p>\n
\n<\/details>\ntag:
1slot_tag<\/code><\/summary>\n
\n<\/details>\nCustom Projectiles<\/summary>\n
\n```
\nscoreboard players operation #test vred_lib.id = @s vred_lib.id
\nexecute rotated as @s anchored eyes positioned ~ ~-1 ~ run function vred_lib:projectile\/summon {id:\"
\nfunction vred_lib:projectile\/throw {id:\"
\n```
\nThis will spawn the projectile with the
\nTo change the behaviour and data of said projectile, target it back in the tick function. It has a built-in timer, called rayAge<\/code>.<\/p>\nthrow<\/code> function will save a copy of the item and reduce the amount of the item in the main hand.<\/p>\nfunction vred_lib:projectile\/return {id:\"Custom Particles<\/summary>\n
\nTo spawn a custom projectile you first need to add the data function in this tag: #vred_lib:particle_load<\/p>\n
\n{
\n \"replace\": false,
\n \"values\": [
\n \"example:particle\/load\"
\n ]
\n }<\/p>\n
\n## beetroot particle, hell yeah
\nitem replace entity @s[tag=
\n```<\/p>\n
\n```
\nfunction vred_lib:particle_system\/test\/1 {id:
\nspeed:
\nowner_id:
\n```
\n`
\n`
\n`
\nactual speed = (
\nMaximum
\n`
\n`
\n```
\nfunction vred_lib:particle_system\/test\/1 {id:
\n```<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":"