How to add custom icons - Revision history

Ashy at 05:26, 7 September 2026

2026-09-07T05:26:15Z

← Older revision		Revision as of 05:26, 7 September 2026
Line 29:		Line 29:

	To initialize the process, run this once:		To initialize the process, run this once:
	* /scriptevent ~~leaf:~~leaficon:add_icon_pack {"ns":"custom_icons","name":"My custom icon pack!","version":1}		* /scriptevent leaficon:add_icon_pack {"ns":"custom_icons","name":"My custom icon pack!","version":1}

	remember to replace ns and name!!!!!		remember to replace ns and name!!!!!

Ashy at 05:21, 7 September 2026

2026-09-07T05:21:14Z

← Older revision		Revision as of 05:21, 7 September 2026
Line 37:		Line 37:
	=== Adding icons ===		=== Adding icons ===

	* /scriptevent leaficon:add_icon_to_pack {"["pack":"your_namespace","name":"my_icon","texture_path":"textures/custom_icons/icon"}		* /scriptevent leaficon:add_icon_to_pack {"pack":"your_namespace","name":"my_icon","texture_path":"textures/custom_icons/icon"}

	=== Registering the icon pack into leaf ===		=== Registering the icon pack into leaf ===

Ashy at 05:20, 7 September 2026

2026-09-07T05:20:24Z

← Older revision		Revision as of 05:20, 7 September 2026
Line 32:		Line 32:

	remember to replace ns and name!!!!!		remember to replace ns and name!!!!!

			"ns" refers to the namespace of the icon pack, that is the part before the / in the icon ID, example: custom_icons/my_icon

	=== Adding icons ===		=== Adding icons ===

	* /scriptevent leaficon:add_icon_to_pack {"name":"my_icon","texture_path":"textures/custom_icons/icon"}		* /scriptevent leaficon:add_icon_to_pack {"["pack":"your_namespace","name":"my_icon","texture_path":"textures/custom_icons/icon"}

	=== Registering the icon pack into leaf ===		=== Registering the icon pack into leaf ===

Ashy: Created page with "== Creating a resource pack == We recommend reading the [https://learn.microsoft.com/en-us/minecraft/creator/documents/resourcepack?view=minecraft-bedrock-stable Introduction to ResourcePacks] to create the base of the resource pack Put your texture in a subfolder under the "textures" folder of your resource pack. For this example, we'll have a custom icon named icon.png in a folder named custom_icons (both the folder and any images inside it can be named anything; we..."

2026-08-31T10:21:26Z

Created page with "== Creating a resource pack == We recommend reading the [https://learn.microsoft.com/en-us/minecraft/creator/documents/resourcepack?view=minecraft-bedrock-stable Introduction to ResourcePacks] to create the base of the resource pack Put your texture in a subfolder under the "textures" folder of your resource pack. For this example, we'll have a custom icon named icon.png in a folder named custom_icons (both the folder and any images inside it can be named anything; we..."

New page

== Creating a resource pack ==

We recommend reading the [https://learn.microsoft.com/en-us/minecraft/creator/documents/resourcepack?view=minecraft-bedrock-stable Introduction to ResourcePacks] to create the base of the resource pack

Put your texture in a subfolder under the "textures" folder of your resource pack. For this example, we'll have a custom icon named icon.png in a folder named custom_icons (both the folder and any images inside it can be named anything; we highly recommend all lowercase and underscores if needed though) '''THIS IS REQUIRED TO BE A PNG!!'''

== Using the icon ==

This icon wont appear in icon viewer, so to use it, you need to click the button at the bottom of icon viewer with an icon that looks like a button with the "a" in it, this should allow you to manually type Icon ID. since it isn't mapped, we'll need need to add a ^ to the start to treat everything after the ^ as a raw path

Example: '''^textures/custom_icons/icon''' (the png extension isnt required)

== Adding it to icon viewer ==

This IS possible, but slightly janky, since its an old unupdated featrure. Given enough uses of it, I may update it. But it does work.

'''THIS USES COMMANDS, BUT MAKE SURE IT ONLY RUNS WHEN LEAF IS LOADED'''

For behavior packs:
* You can make an initialize event in leaf to run an mcfunction (recommended if you dont know scripting)
* Run the commands in a event as soon as it sees leaf_ess_api:recv1. the message will always be empty

For no behavior pack:
* Just use the initialize event in leafs [[Customizer]] utility

RUN THESE COMMANDS IN ORDER!

=== Initializing the pack ===

To initialize the process, run this once:
* /scriptevent leaf:leaficon:add_icon_pack {"ns":"custom_icons","name":"My custom icon pack!","version":1}

remember to replace ns and name!!!!!

=== Adding icons ===

* /scriptevent leaficon:add_icon_to_pack {"name":"my_icon","texture_path":"textures/custom_icons/icon"}

=== Registering the icon pack into leaf ===

* /scriptevent leaficon:push_icon_pack_to_registry custom_icons

'''REMEMBER TO REPLACE "custom_icons" WITH YOUR PACKS NAMESPACE'''