Генерація зачарувань 1.21.11

Дізнайтеся, як генерувати зачарування через генерацію даних.

WARNING

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

ПЕРЕДУМОВИ

Спершу переконайтеся, що ви виконали процес налаштування datagen.

Налаштування

Перед реалізацією генератора створіть пакет enchantment в основному вихідному наборі та додайте до нього клас ModEnchantments. Потім додайте метод key до цього нового класу.

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

Використовуйте цей метод, щоб створити ResourceKey для свого зачарування.

public static final ResourceKey<Enchantment> THUNDERING = key("thundering");

Тепер ми готові додати генератор. У пакеті генерації даних створіть клас, який розширює FabricDynamicRegistryProvider. До цього щойно створеного класу додайте конструктор, який відповідає super, і реалізуйте методи configure і getName.

public class ExampleModEnchantmentGenerator extends FabricDynamicRegistryProvider {
	public ExampleModEnchantmentGenerator(FabricDataOutput output, CompletableFuture<HolderLookup.Provider> registriesFuture) {
		super(output, registriesFuture);
	}

	@Override
	protected void configure(HolderLookup.Provider registries, Entries entries) {
		entries.addAll(registries.lookupOrThrow(Registries.ENCHANTMENT)); // Add all bootstrapped enchantments for the current mod id
	}

	@Override
	public String getName() {
		return "Enchantments";
	}

}

Потім додайте допоміжний метод register до новоствореного класу.

private static void register(BootstrapContext<Enchantment> context, ResourceKey<Enchantment> key, Enchantment.Builder builder) {
	context.register(key, builder.build(key.identifier()));
}

Тепер додайте метод bootstrap. Тут ми будемо реєструвати зачарування, які хочемо додати до гри.

public static void bootstrap(BootstrapContext<Enchantment> context) {
	// ...
}

У вашій DataGeneratorEntrypoint перевизначте метод buildRegistry і зареєструйте наш початковий метод.

@Override
public void buildRegistry(RegistrySetBuilder registryBuilder) {
	registryBuilder.add(Registries.ENCHANTMENT, ExampleModEnchantmentGenerator::bootstrap);
}

Нарешті переконайтеся, що ваш новий генератор зареєстровано в методі onInitializeDataGenerator.

pack.addProvider(ExampleModEnchantmentGenerator::new);

Створення зачарування

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

Зареєструйте своє зачарування в методі bootstrap генератора, використовуючи зачарування, зареєстроване в ModEnchantments.

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

register(context, ModEnchantments.THUNDERING,
		Enchantment.enchantment(
				Enchantment.definition(
						context.lookup(Registries.ITEM).getOrThrow(ItemTags.WEAPON_ENCHANTABLE), // The items this enchantment can be applied to
						10, // The weight / probability of our enchantment being available in the enchanting table
						3, // The max level of the enchantment
						Enchantment.dynamicCost(1, 10), // The base minimum cost of the enchantment, and the additional cost for every level
						Enchantment.dynamicCost(1, 15), // Same as the other dynamic cost, but for the maximum instead
						5, // The cost to apply the enchantment in an anvil, in levels
						EquipmentSlotGroup.HAND // The slot types in which this enchantment will be able to apply its effects
				)
		)
		.withEffect(
				EnchantmentEffectComponents.POST_ATTACK, // The type of effect to be applied
				EnchantmentTarget.ATTACKER, // The target to be checked for the enchantment
				EnchantmentTarget.VICTIM, // The target to apply the enchantment effect to
				new LightningEnchantmentEffect(LevelBasedValue.perLevel(0.4f, 0.2f))
		)
);

Тепер просто запустіть генерацію даних, і ваше нове зачарування стане доступним у грі!

Умови ефекту

Більшість типів ефектів зачарування є умовними. Додаючи ці ефекти, можна передати умови виклику withEffect.

INFO

Щоб отримати огляд доступних типів умов та їх використання, перегляньте клас Enchantments.

.withEffect(
		// ...
		LootItemEntityPropertyCondition.hasProperties(
				LootContext.EntityTarget.ATTACKER,
				EntityPredicate.Builder.entity().flags(
						EntityFlagsPredicate.Builder.flags().setIsFlying(false)
				)
		)
)

Кілька ефектів

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

Щоб натомість поділитися визначеними умовами та цілями між кількома ефектами, можна використати AllOf, щоб об’єднати їх в один ефект.

AllOf.entityEffects(
		new ApplyEntityImpulse(new Vec3(0, 0.2, -1), new Vec3(1, 1, 1), LevelBasedValue.perLevel(0.7f, 0.2f)),
		new PlaySoundEffect(List.of(SoundEvents.LUNGE_1), ConstantFloat.of(5), ConstantFloat.of(1))
),

Зауважте, що спосіб використання залежить від типу ефекту, який додається. Наприклад, EnchantmentValueEffect вимагає натомість AnyOf.valueEffects. Різні типи ефектів все ще потребують додаткових викликів withEffect.

Стіл зачарування

Хоча ми вказали вагу зачарування (або ймовірність) у нашому визначенні зачарування, воно не показуватиметься в столі зачарувань усталено. Щоб нашими зачаруванням могли торгувати селяни та з’являтися в столі зачарування, нам потрібно додати їх до теґу non_treasure.

Для цього ми можемо створити постачальник теґів. Створіть клас, який розширює FabricTagProvider<Enchantment> в пакеті datagen. Потім запровадьте конструктор із Registries.ENCHANTMENT як параметр registryKey до super і створіть метод addTags.

public class ExampleModEnchantmentTagProvider extends FabricTagProvider<Enchantment> {
	public ExampleModEnchantmentTagProvider(FabricDataOutput output, CompletableFuture<HolderLookup.Provider> registriesFuture) {
		super(output, Registries.ENCHANTMENT, registriesFuture);
	}

	@Override
	protected void addTags(HolderLookup.Provider wrapperLookup) {
		// ...
	}
}

Тепер ми можемо додати наше зачарування до EnchantmentTags.NON_TREASURE, викликавши конструктор із методу addTags.

builder(EnchantmentTags.NON_TREASURE).add(ModEnchantments.THUNDERING);

Прокляття

Прокляття також реалізуються за допомогою теґів. Ми можемо використати постачальник теґів із розділу стола зачарування.

У методі addTags просто додайте своє зачарування до теґу CURSE, щоб позначити його як прокляття.

builder(EnchantmentTags.CURSE).add(ModEnchantments.REPULSION_CURSE);