Differences

This shows you the differences between two versions of the page.

--- tutorial:colorprovider [2024/08/26 08:08] – [Block Color Provider] solidblock
+++ tutorial:colorprovider [2025/04/01 12:10] (current) – solidblock
@@ Line 18: / Line 18: @@
 ===== Block Color Provider =====
-To register a block to the block color provider, you'll need to use Fabric's ''ColorProviderRegistry''. There is an instance of the ''BLOCK'' and ''ITEM'' provider inside this class, which you can call register on. The register method takes an instance of your color provider and a varargs of every block you want to color with the provider.
+To register a block to the block color provider, you'll need to use Fabric's ''ColorProviderRegistry''. There is an instance of the ''BLOCK'' and ''ITEM'' provider inside this class, which you can call ''register'' on. The ''register'' method takes an instance of your color provider and a varargs of every block you want to color with the provider.
 At first, we create the block in ''TutorialBlocks'' class. For how to create the block, see [[blocks]]:
@@ Line 24: / Line 24: @@
 public final class TutorialBlocks {
   [...]
+  // Before 1.21.2
   public static final Block COLOR_BLOCK = register("color_block", new Block(AbstractBlock.Settings.create()));
+  // 1.21.2 and after:
+  public static final Block COLOR_BLOCK = register("color_block", Block::new, AbstractBlock.Settings.create());
 }
 </code>
@@ Line 67: / Line 70: @@
 </code>
-Then we create the block model with //tintindex//:
+Then we create the block model with //tintindex//. The model is also important: the main note here is that you are //required// to define a tintindex for each portion of the model you want to hue. To see an example of this, check out ''leaves.json'', which is the base model used for vanilla leaves. Here's the model used for our block:
-The model is also important: the main note here is that you are //required// to define a tintindex for each portion of the model you want to hue. To see an example of this, check out ''leaves.json'', which is the base model used for vanilla leaves. Here's the model used for our block:
 <code javascript src/main/resources/assets/tutorial/models/block/color_block.json>
 {
@@ Line 93: / Line 94: @@
 </code>
-In this instance, we're adding a single tintindex, which is what would appear in the ''tintIndex'' parameter (tint index 0). Actually, we can directly inherit the ''minecraft:block/leaves'' model because it also uses a cube with tintindex. Replace the model above, with:
+In this instance, we're adding a single tintindex, which is what would appear in the ''tintIndex'' parameter (tint index 0). Actually, we can directly inherit the ''minecraft:block/leaves'' model because it also uses a cube with tintindex. So you can also replace the model above, with:
 <code javascript src/main/resources/assets/tutorial/models/block/color_block.json>
 {
@@ Line 133: / Line 134: @@
   }
+  // Since 1.21.4, this method is not required anymore, because all block entities use their block model by default.
   @Override
   protected BlockRenderType getRenderType(BlockState state) {
@@ Line 153: / Line 155: @@
   protected void readNbt(NbtCompound nbt, RegistryWrapper.WrapperLookup registryLookup) {
     super.readNbt(nbt, registryLookup);
+    // For versions before 1.21.5, please directly use nbt.getInt("color");
     color = nbt.getInt("color");
@@ Line 158: / Line 162: @@
     // or placed by an item with "block_entity_data" component,
     // the render color will be updated.
-    this.world.updateListeners(pos, getCachedState(), getCachedState(), 0);
+    if (world != null) {
+      world.updateListeners(pos, getCachedState(), getCachedState(), 0);
+    }
   }
@@ Line 188: / Line 194: @@
 In the ''TutorialBlocks'' class, replace ''new Block'' with ''new ColorBlock'':
 <code java>
+  // Before 1.21.2:
   public static final ColorBlock COLOR_BLOCK = register("color_block", new ColorBlock(AbstractBlock.Settings.create()));
+  // Since 1.21.2:
+  public static final Block COLOR_BLOCK = register("color_block", ColorBlock::new, AbstractBlock.Settings.create());
 </code>
@@ Line 203: / Line 213: @@
   @Override
-  protected ItemActionResult onUseWithItem(ItemStack stack, BlockState state, World world, BlockPos pos, PlayerEntity player, Hand hand, BlockHitResult hit) {
+  protected ActionResult onUseWithItem(ItemStack stack, BlockState state, World world, BlockPos pos, PlayerEntity player, Hand hand, BlockHitResult hit) {
     if (stack.getItem() instanceof DyeItem dyeItem) {
       if (world.getBlockEntity(pos) instanceof ColorBlockEntity colorBlockEntity) {
         final int newColor = dyeItem.getColor().getEntityColor();
         final int originalColor = colorBlockEntity.color;
-        colorBlockEntity.color = ColorHelper.Argb.averageArgb(newColor, originalColor);
+        colorBlockEntity.color = ColorHelper.average(newColor, originalColor);
         stack.decrementUnlessCreative(1, player);
         colorBlockEntity.markDirty();
@@ Line 240: / Line 250: @@
   * When you pick (press mouse wheel) the block with ''Ctrl'' pressed, and place the block, it should display as the expected color.
   * When you leave the world and re-enter, the color should be kept.
-===== Item Color Provider =====
-Items are similar; the difference is the context provided. Instead of having a state, world, or position, you have access to the ''ItemStack''.
-For item models, we can directly inherite the block model, which uses tintindex:
+===== Custom item tint (1.21.4 and after) =====
+Since 1.21.4 开始, tints of items are defined in item models definitions. Some common tint source types are provided in vanilla, see [[https://minecraft.wiki/w/Item models definition|Minecraft Wiki]]. In this example, we directly set the color of the item, so we can write the item models definition as follows:
+<code javascript /resources/assets/tutorial/items/color_block.json>
+{
+  "model": {
+    "type": "model",
+    "model": "tutorial:block/color_block",
+    "tints": [
+      {
+        "type": "constant",
+        "value": 3446251
+      }
+    ]
+  }
+}
+</code>
+If you need to specify a custom tint source, you can register with ''TintResourceTypes.//ID_MAPPER//.put(...)'' provided in vanilla. Note that this should be done in client environment. The ID used in the registration is the value of ''%%"type"%%'' in the ''%%"tints"%%'' in the item model definition above.
+> If the tint does not work, check the value of tintindex in the model, which should be consistent with the element subscript in the ''%%"tints"%%'' list in the item models definition. For example, if the tintindex is 2, it uses the third tint source in the item models definition.
+In version 1.21.3 and before, item model providers are also registered with Fabric API. Different from blocks, the context provided, instead of having a state, world, or position, has access to the ''ItemStack''.
+For item models, we can directly inherite the block model that uses tintindex:
 <code javascript src/main/resources/assets/tutorial/models/item/color_block.json>
 {