Зовнішній вигляд предметів 1.21.11

Дізнайтеся, як динамічно тонувати предмети за допомогою спеціальних джерел відтінків.

WARNING

Ця сторінка написана для версії 1.21.11. Документація для старіших версій може бути неповною.

Ви можете маніпулювати зовнішнім виглядом предмета через його клієнтський предмет. У Вікі Minecraft є список стандартних модифікацій.

З них типово використовуваним типом є джерела відтінків, який дозволяє змінювати колір елемента на основі попередньо визначених умов.

Існує лише кілька попередньо визначених джерел відтінків, тому подивімося, як створити власні.

Для цього прикладу зареєструймо предмет. Якщо ви не знайомі з цим процесом, спершу прочитайте про реєстрацію предмета.

public static final Item WAXCAP_BLOCK_ITEM = Registry.register(
				BuiltInRegistries.ITEM,
				Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "waxcap"),
				new BlockItem(WAXCAP_BLOCK, new Item.Properties()
								.setId(WAXCAP_BLOCK_ITEM_KEY))
);

Обов’язково додайте:

• Клієнтський предмет у /items/waxcap.json
• Модель предмета у /models/item/waxcap.json
• Текстура у /textures/item/waxcap.png

Предмет має з’явитися в грі.

Як бачите, ми використовуємо текстуру градацій сірого. Додаймо трохи кольору за допомогою джерела тону.

Джерела відтінків предметів

Зареєструймо спеціальне джерело відтінку, щоб розфарбувати наш предмет Waxcap, щоб під час дощу предмет виглядав синім, інакше він виглядав коричневим.

Спершу вам потрібно буде визначити власне джерело відтінку предмета. Це робиться шляхом реалізації інтерфейсу ItemTintSource для класу або запису.

public record RainTintSource(int color) implements ItemTintSource {
	public static final MapCodec<RainTintSource> MAP_CODEC = RecordCodecBuilder.mapCodec(
					instance -> instance.group(
									ExtraCodecs.RGB_COLOR_CODEC.fieldOf("color").forGetter(RainTintSource::color)).apply(instance, RainTintSource::new)
	);

	public RainTintSource() {
		this(ARGB.opaque(0x00BFFF)); // Color code in hex format
	}

	@Override
	public int calculate(ItemStack itemStack, @Nullable ClientLevel clientLevel, @Nullable LivingEntity livingEntity) {
		if (clientLevel != null && clientLevel.isRaining()) {
			return ARGB.opaque(color);
		}

		return ARGB.opaque(0xFFEFD5); // Color code in hex format
	}

	@Override
	public @NotNull MapCodec<? extends ItemTintSource> type() {
		return MAP_CODEC;
	}
}

Оскільки це частина визначення клієнтського предмета, значення відтінку можна змінити за допомогою пакета ресурсів. Тож вам потрібно визначити [мапу кодеків(../codecs#mapcodec), який здатний читати ваше визначення відтінку. У цьому випадку джерело відтінку матиме значення int, що описує колір, який він матиме під час дощу. Ми можемо використовувати вбудований ExtraCodecs.RGB_COLOR_CODEC, щоб створити наш кодек.

public static final MapCodec<RainTintSource> MAP_CODEC = RecordCodecBuilder.mapCodec(
				instance -> instance.group(
								ExtraCodecs.RGB_COLOR_CODEC.fieldOf("color").forGetter(RainTintSource::color)).apply(instance, RainTintSource::new)
);

Потім ми можемо повернути цей кодек у type().

@Override
public @NotNull MapCodec<? extends ItemTintSource> type() {
	return MAP_CODEC;
}

Нарешті, ми можемо надати реалізацію для calculate, яка вирішить, яким буде колір відтінку. Значення color — це значення, яке надходить із пакета ресурсів.

@Override
public int calculate(ItemStack itemStack, @Nullable ClientLevel clientLevel, @Nullable LivingEntity livingEntity) {
	if (clientLevel != null && clientLevel.isRaining()) {
		return ARGB.opaque(color);
	}

	return ARGB.opaque(0xFFEFD5); // Color code in hex format
}

Потім нам потрібно зареєструвати наше джерело відтінку предмета. Це робиться в ініціалізаторі клієнта за допомогою ID_MAPPER, оголошеного в ItemTintSources.

ItemTintSources.ID_MAPPER.put(Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "color"), RainTintSource.MAP_CODEC);

Коли це буде зроблено, ми можемо використовувати наше джерело відтінку предмета у визначенні клієнтського предмета.

{
  "model": {
    "type": "minecraft:model",
    "model": "example-mod:item/waxcap",
    "tints": [
      {
        "type": "example-mod:color",
        "color": -16728065
      }
    ]
  }
}

Ви можете спостерігати за зміною кольору предмета в грі.