Skip to content

Edit Supported Items

Tschipcraft edited this page Jan 21, 2025 · 5 revisions

This project supports editing light levels and water sensitivity for any item in the game.

Since Mojang decided to rename the registries for Minecraft 1.21, there are two locations for light levels and water sensitivity:

Minecraft 1.17x-1.20.6 Minecraft 1.21+
Light Level /data/dynamiclights/tags/items/light_level/ /data/dynamiclights/tags/item/light_level/
Water Sensitivity /data/dynamiclights/tags/items/water_sensitive/ /data/dynamiclights/tags/item/water_sensitive/

Data Pack version

Light Level

  1. To edit the light level of an item, unzip the data pack and navigate to the light level directory.
    Here you will find the files 3.json, 6.json, 9.json, 12.json and 15.json, each corresponding to the desired light level.

  2. Simply add the item ID to the correct file. Make sure that the item is only mentioned once in any of the files and that the file is properly formatted according to the JSON specifications.

  3. Re-zip the data pack if needed.

Take a look at the files here on GitHub.

Water Sensitivity

  1. To edit the water sensitivity of an item, unzip the data pack and navigate to the water sensitivity directory.
    Here you will find the files turn_off.json and turn_on.json. Items specified in turn_off.json will turn off in water, and items specified in turn_on.json will turn on in water.

  2. Add the item ID to the correct file. Please make sure that the specified item also has an assigned light level as mentioned above, and that the edited file is properly formatted according to the JSON specifications.

  3. Re-zip the data pack if needed.

Take a look at the files here on GitHub.

Tip

If you want to add a failsafe (e.g. when adding modded or version dependent items), wrap the entries inside a {"id": "<id>", "required": false} block.

Mod version

Light Level

  1. To edit the light level of an item, unzip the mod using tools like 7-zip (or forks of it like NanaZip) and navigate to the light level directory.
    Here you will find the files 3.json, 6.json, 9.json, 12.json and 15.json, each corresponding to the desired light level.

  2. Simply add the item ID to the correct file. Make sure that the item is only mentioned once in any of the files and that the file is properly formatted according to the JSON specifications.

  3. Re-zip the mod and change the file extension back to .jar.

Take a look at the files here on GitHub.

Water Sensitivity

  1. To edit the water sensitivity of an item, unzip the mod and navigate to the water sensitivity directory.
    Here you will find the files turn_off.json and turn_on.json. Items specified in turn_off.json will turn off in water, and items specified in turn_on.json will turn on in water.

  2. Add the item ID to the correct file. Please make sure that the specified item also has an assigned light level as mentioned above, and that the edited file is properly formatted according to the JSON specifications.

  3. Re-zip the mod and change the file extension back to .jar.

Take a look at the files here on GitHub.

Tip

If you want to add a failsafe (e.g. when adding modded or version dependent items), wrap the entries inside a {"id": "<id>", "required": false} block.

As an alternative to installing third-party tools for unpacking the mod version, you can also build the project from source.

For Mod Developers

If you want to add item support for Tschipcraft's Dynamic Lights to your mod, add the folders /data/dynamiclights/tags/item(s)/mod_support/<light_level/water_sensitive>/ to the data folder inside your mod and add the entries for your custom items there like I did here with some convention tags.
Note that this format will most likely change in the future, as I'm not completely happy with it yet.


If you have any questions, need help or want to suggest changes, feel free to open an issue here on GitHub.