• 26.2
• 26.1.2
• 1.21.11
• 1.21.10
• 1.21.8
• 1.21.4
• 1.21.1
• 1.20.4

Пользовательские эффекты чар

Узнайте, как создавать эффекты чар.

WARNING

Эта страница написана для версии 1.21.10. Документация для более старых версий может быть неполной.

Начиная с версии 1.21, пользовательские чары в Minecraft используют подход, "управляемый данными". Это упрощает добавление простых чар, таких как увеличение урона от атаки, но усложняет создание сложных. Этот процесс включает в себя разбиение чар на компоненты эффекта.

Компонент эффекта содержит код, определяющий специальные эффекты чар. Minecraft поддерживает различные эффекты по умолчанию, такие как повреждение предметов, отбрасывание и опыт.

TIP

Обязательно проверьте, удовлетворяют ли эффекты Minecraft по умолчанию вашим потребностям, посетив страницу компонентов эффектов зачарования Minecraft Wiki. В этом руководстве предполагается, что вы понимаете, как настраивать «простые» чары, управляемые данными, и основное внимание уделяется созданию пользовательских эффектов чар, которые не поддерживаются по умолчанию.

Пользовательские эффекты чар

Начните с создания папки enchantment, а внутри неё создайте папку effect. Внутри этого мы создадим запись LightningEnchantmentEffect.

Далее мы можем создать конструктор и переопределить методы интерфейса EnchantmentEntityEffect. Мы также создадим переменную CODEC для кодирования и декодирования нашего эффекта; вы можете прочитать больше о кодеках здесь.

Большая часть нашего кода будет передана в событие apply(), которое вызывается, когда выполняются критерии для работы вашего зачарования. Позже мы настроим этот Эффект, чтобы он вызывался при ударе по объекту, а сейчас давайте напишем простой код для поражения цели молнией.

public record LightningEnchantmentEffect(LevelBasedValue amount) implements EnchantmentEntityEffect {
	public static final MapCodec<LightningEnchantmentEffect> CODEC = RecordCodecBuilder.mapCodec(instance ->
			instance.group(
					LevelBasedValue.CODEC.fieldOf("amount").forGetter(LightningEnchantmentEffect::amount)
			).apply(instance, LightningEnchantmentEffect::new)
	);

	@Override
	public void apply(ServerLevel world, int level, EnchantedItemInUse context, Entity target, Vec3 pos) {
		if (target instanceof LivingEntity victim) {
			if (context.owner() != null && context.owner() instanceof Player player) {
				float numStrikes = this.amount.calculate(level);

				for (float i = 0; i < numStrikes; i++) {
					BlockPos position = victim.blockPosition();
					EntityType.LIGHTNING_BOLT.spawn(world, position, EntitySpawnReason.TRIGGERED);
				}
			}
		}
	}

	@Override
	public MapCodec<? extends EnchantmentEntityEffect> codec() {
		return CODEC;
	}
}

Здесь переменная amount указывает значение, масштабированное до уровня зачарования. Мы можем использовать это, чтобы изменить эффективность зачарования в зависимости от уровня. В приведенном выше коде мы используем уровень чар, чтобы определить, сколько ударов молнии будет вызвано.

Регистрация эффекта зачарования

Как и любой другой компонент вашего мода, нам придется добавить этот EnchantmentEffect в реестр Minecraft. Для этого добавьте класс ModEnchantmentEffects (или назовите его как хотите) и вспомогательный метод для регистрации чар. Обязательно вызовите registerModEnchantmentEffects() в вашем основном классе, который содержит метод onInitialize().

public class ModEnchantmentEffects {
	public static final ResourceKey<Enchantment> THUNDERING = of("thundering");
	public static MapCodec<LightningEnchantmentEffect> LIGHTNING_EFFECT = register("lightning_effect", LightningEnchantmentEffect.CODEC);

	private static ResourceKey<Enchantment> of(String path) {
		ResourceLocation id = ResourceLocation.fromNamespaceAndPath(ExampleMod.MOD_ID, path);
		return ResourceKey.create(Registries.ENCHANTMENT, id);
	}

	private static <T extends EnchantmentEntityEffect> MapCodec<T> register(String id, MapCodec<T> codec) {
		return Registry.register(BuiltInRegistries.ENCHANTMENT_ENTITY_EFFECT_TYPE, ResourceLocation.fromNamespaceAndPath(ExampleMod.MOD_ID, id), codec);
	}

	public static void registerModEnchantmentEffects() {
		ExampleMod.LOGGER.info("Registering EnchantmentEffects for" + ExampleMod.MOD_ID);
	}
}

Создание чар

Теперь у нас есть эффект зачарования! Последний шаг — создать чары, которые будут применять наш собственный эффект. Хотя это можно сделать, создав файл JSON, аналогичный файлам в пакетах данных, в этом руководстве показано, как динамически генерировать JSON с помощью инструментов генерации данных Fabric. Для начала создайте класс EnchantmentGenerator.

В этом классе мы сначала зарегистрируем новое зачарование, а затем воспользуемся методом configure() для программного создания нашего JSON.

Not Found: /home/runner/work/fabric-docs/fabric-docs/reference/1.21.10/src/client/java/com/example/docs/datagen/EnchantmentGenerator.java

Прежде чем продолжить, вам следует убедиться, что ваш проект настроен для генерации данных; если вы не уверены, просмотрите соответствующую страницу документации.

Наконец, мы должны указать нашему моду добавить наш EnchantmentGenerator в список задач генерации данных. Для этого просто добавьте EnchantmentGenerator внутри метода onInitializeDataGenerator.

Теперь, когда вы запускаете задачу генерации данных вашего мода, JSON-файлы чар будут генерироваться внутри папки generated. Пример можно увидеть ниже:

{
  "anvil_cost": 5,
  "description": {
    "translate": "enchantment.example-mod.thundering"
  },
  "effects": {
    "minecraft:post_attack": [
      {
        "affected": "victim",
        "effect": {
          "type": "example-mod:lightning_effect",
          "amount": {
            "type": "minecraft:linear",
            "base": 0.4,
            "per_level_above_first": 0.2
          }
        },
        "enchanted": "attacker"
      }
    ]
  },
  "max_cost": {
    "base": 1,
    "per_level_above_first": 15
  },
  "max_level": 3,
  "min_cost": {
    "base": 1,
    "per_level_above_first": 10
  },
  "slots": [
    "hand"
  ],
  "supported_items": "#minecraft:enchantable/weapon",
  "weight": 10
}

Вам также следует добавить переводы в файл en_us.json, чтобы дать вашему зачарованию читаемое имя:

"enchantment.ExampleMod.thundering": "Thundering",

Теперь у вас должен быть рабочий эффект зачарования! Проверьте это, зачаровав оружие чарами и ударив моба. Пример приведен в следующем видео: