# HMWBTE’s Cosmetics<\/p>\n
<\/p>\n
This datapack lets you customize your survival experience without needing cheats \/ commands. With this datapack, you can give items custom names and lore, custom models, or even create a hologram of text!<\/p>\n
This datapack is a work in progress, so please report any issues or inconveniences you find!<\/p>\n
## Credits<\/p>\n
Some ideas and code were adapted from Vanilla Tweaks’ *Armor Statues* Datapack, in compliance with their terms & conditions.
\nThe original datapack can be found on the Vanilla Tweaks website<\/p>\n
## How to install<\/p>\n
First, add the datapack in the create world menu, or by placing it in the `datapacks` folder of an existing world.<\/p>\n
If you want to use custom models, you need a resource pack. It is recommended to base that resource pack off the template here, to ensure the models get used properly.<\/p>\n
I might make a tool for generating a resource pack later, but no promises.<\/p>\n
If you are adding the datapack to a server and want to disable features, then you can use any of the following commands:<\/p>\n
“`mcfunction
\ndata modify storage permissions:config hat set value false<\/p>\n
data modify storage permissions:config sit set value false<\/p>\n
data modify storage permissions:config custom_text set value false<\/p>\n
data modify storage permissions:config custom_models set value false<\/p>\n
data modify storage permissions:config holograms set value false
\n“`<\/p>\n
## How to use<\/p>\n
### Holograms<\/p>\n
To create a hologram, write a book (it does not have to be signed) then rename it *HOLOGRAM* using an anvil. Placing this book on a lectern will automatically summon the hologram. See [below](#formatting-guide) for a guide on how to format the hologram.<\/p>\n
To edit the contents of the hologram, just remove the book from the lectern, make the changes you want, and replace it.<\/p>\n
To adjust the position, rotation, size, etc. of the hologram you can use the Configurator book. This book can be obtained by signing a book “Holograms” (case sensitive), or by running the following command:
\n“`
\nfunction hologram:give_book
\n“`<\/p>\n
### Custom Names \/ Lore<\/p>\n
To give an item a custom name, write a book and rename it *NAME*. Next, hold the book in your offhand and the item you want to modify in your mainhand. Then run this command:
\n“`
\ntrigger custom_name
\n“`<\/p>\n
The process is almost identical for custom lore, but instead you rename the book *LORE* and run this command:
\n“`
\ntrigger custom_lore
\n“`<\/p>\n
For a guide on how to format names \/ lore, see [below](#formatting-guide).<\/p>\n
### Formatting Guide<\/p>\n
Several utilities use a written \/ writable book to generate formatted text. The contents of such books follow a simple markup pattern, with the following commands:<\/p>\n
Command | Result
\n-|-
\n`%bold%` | Turns bold on or off
\n`%italic%` | Turns italics on or off
\n`%obfuscate%` | Turns obfuscation (the glitchy random text) on or off
\n`%underline%` | Turns underlining on or off
\n`%strikethrough%` | Turns strikethrough (line through the text) on or off<\/p>\n
There are also commands for color, which more or less follow the naming convention of colors in game (e.g. concrete). Here a list of all of them in no particular order:
\n“`
\n%black% %blue% %cyan% %green% %lightblue% %orange% %pink% %brown% %red% %magenta% %purple% %lime% %yellow% %gray% %lightgray% %white% %aqua% %darkred% %gold%
\n“`<\/p>\n
### Formatting Example<\/p>\n
The following written book:
\n“`
\n%bold%%yellow%Title
\n%bold%%white%Lorem ipsum dolor sit amet
\n“`
\nWill produce the following formatted output (image shows a formatted hologram):<\/p>\n
<\/p>\n
### Actions<\/p>\n
This datapack also provides some simple actions to allow a player to sit on a stair\/slab, or to equip an item as a hat.<\/p>\n
The triggers for both are, respectively:
\n“`
\ntrigger hat<\/p>\n
triggger sit
\n“`<\/p>\n
Please note that the player must be standing on the block they wish to sit on.<\/p>\n
### Custom Models<\/p>\n
⚠ This feature may be changed or replaced in the future! ⚠<\/p>\n
To give an item a custom model, you should first make sure it exists in a resource pack. This means that the desired item model should be specified in the `shared:custom` resource location.<\/p>\n
For example, if I wanted to have a custom model named “witherbuster”, I would need to make sure the file `.\/assets\/shared\/items\/custom.json` looked something like this:
\n“`jsonc
\n{
\n “model”: {
\n “type”: “minecraft:select”,
\n “property”: “minecraft:custom_model_data”,
\n “cases”: [
\n {
\n \/\/ If the “witherbuster” string is present, give
\n \/\/ the item the witherbuster model
\n “when”: “witherbuster”,
\n “model”: {
\n “type”: “minecraft:model”,<\/p>\n
\/\/ Example location
\n “model”: “location:item\/witherbuster”
\n }
\n }
\n ]
\n }
\n}
\n“`
\nThis datapack always assumes that `shared:custom` is a “select” type, and so only provides string values for the `minecraft:custom_model_data` property. <\/p>\n
To set the custom model data, hold a named paper in your offhand and run the following command:
\n“`
\ntrigger custom_model
\n“`
\nThis will set model string of the mainhanded item to the name of the paper, which should match a string in the resource pack.<\/p>\n
To remove a custom model, hold the item in your mainhand and run
\n“`
\ntrigger remove_model
\n“`
\nThis should revert the items model to its id. Currently, additional testing is needed for reliability.<\/p>\n","protected":false},"excerpt":{"rendered":"
A datapack that brings custom text displays (and more) into survival!<\/p>\n","protected":false},"featured_media":81396,"template":"","meta":{"_minecraft_slug":"hmwbte-cosmetics","_minecraft_project_id":"mb4mEre5","_minecraft_author":"HMWBTE","_minecraft_license":"MIT","_minecraft_downloads":35,"_minecraft_follows":1,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hmwbte-cosmetics.zip","_minecraft_size_bytes":52276,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T23:44:39.217040Z","_minecraft_date_created":"2025-06-12T05:49:17.143974Z","_minecraft_date_modified":"2025-06-12T20:15:28.550936Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hmwbte-cosmetics","_minecraft_icon_attachment_id":81396,"_minecraft_imported_at":"2026-06-04T16:24:12+00:00","_minecraft_import_hash":"6ee6ca80686031bbee92b62a358e5f54","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,156,88,89,873,126,867,92],"mod_loader":[86],"minecraft_version":[78],"class_list":["post-81395","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-decoration","mod_category-equipment","mod_category-game-mechanics","mod_category-library","mod_category-management","mod_category-social","mod_category-utility","mod_loader-datapack","minecraft_version-1-21-5"],"yoast_head":"\n