Geração de Encantamentos
Um guia para gerar encantamentos via datagen.
PRÉ-REQUISITOS
Tenha certeza que você completou o processo de configuração do datagen primeiro.
Configuração
Antes de implementar o gerador, crie o pacote enchantment no conjunto de fonte principal e adicione a classe ModEnchantments dentro dele. Então adicione o método key nessa nova classe.
private static ResourceKey<Enchantment> key(String path) {
Identifier id = ExampleMod.id(path);
return ResourceKey.create(Registries.ENCHANTMENT, id);
}2
3
4
Use esse método para criar um ResourceKey para o seu encantamento.
public static final ResourceKey<Enchantment> THUNDERING = key("thundering");Agora estamos prontos para adicionar o gerador. No pacote datagen, crie uma classe que estenda FabricDynamicRegistryProvider. Nessa classe recém-criada, adicione um construtor que combine com super e implemente os métodos configure e getName.
public class ExampleModEnchantmentGenerator extends FabricDynamicRegistryProvider {
public ExampleModEnchantmentGenerator(FabricPackOutput 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";
}
}2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Então, adicione o método ajudante register na classe recém-criada.
private static void register(BootstrapContext<Enchantment> context, ResourceKey<Enchantment> key, Enchantment.Builder builder) {
context.register(key, builder.build(key.identifier()));
}2
3
Agora adicione o método bootstrap. Aqui, nós registraremos os encantamentos que nós queremos adicionar ao jogo.
public static void bootstrap(BootstrapContext<Enchantment> context) {
// ...
}2
3
No seu DataGeneratorEntrypoint, sobrescreva o método buildRegistry e registre o nosso método bootstrap.
@Override
public void buildRegistry(RegistrySetBuilder registryBuilder) {
registryBuilder.add(Registries.ENCHANTMENT, ExampleModEnchantmentGenerator::bootstrap);
}2
3
4
Finalmente, certifique-se que o seu novo gerador está registrado dentro do método onInitializeDataGenerator.
pack.addProvider(ExampleModEnchantmentGenerator::new);Criando o Encantamento
Para criar a definição para o nosso encantamento personalizado, nós usaremos o método register na nossa classe geradora.
Registre o seu encantamento no método bootstrap do gerador, usando o encantamento registrado em ModEnchantments.
Nesse exemplo, nós usaremos o efeito de encantamento criado no Efeitos de Encantamento Personalizados, mas você pode também usar os efeitos de encantamento vanilla.
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))
)
);2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Agora simplesmente execute a geração de dados e o seu novo encantamento estará disponível no jogo!
Condições de Efeitos
A maior parte dos tipos de efeitos de encantamento são condicionais. Ao adicionar esses efeitos, é possível passar condições à chamada withEffect.
INFO
Para ter uma visão geral dos tipos de condições disponíveis e dos seus usos, dê uma olhada na classe Enchantments.
.withEffect(
// ...
LootItemEntityPropertyCondition.hasProperties(
LootContext.EntityTarget.ATTACKER,
EntityPredicate.Builder.entity().flags(
EntityFlagsPredicate.Builder.flags().setIsFlying(false)
)
)
)2
3
4
5
6
7
8
9
Efeitos Múltiplos
O withEffect pode ser encadeado para adicionar múltiplos efeitos a um único encantamento. No entanto, esse método exige que você especifique as condições de efeito para todos os efeitos.
No lugar de compartilhar as condições definidas e os alvos com múltiplos efeitos. AllOf pode ser usado para combinar eles em um único efeito.
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))
),2
3
4
Note que o método a ser usado depende do tipo de efeito sendo adicionado. Por exemplo, EnchantmentValueEffect exige AnyOf.valueEffects. Diferir tipos de efeitos ainda exige chamadas withEffect adicionais.
Mesa de Encantamentos
Mesmo que nós tenhamos especificado o peso do encantamento (ou a chance) na nossa definição de encantamento, ele não aparecerá na mesa de encantamentos por padrão. Para permitir que o nosso encantamento seja negociado por aldeões e que ele apareça na mesa de encantamentos, nós precisamos adicioná-lo à tag non_treasure.
Para fazer isso, nós podemos criar um provedor de tag. Crie uma classe que estende FabricTagProvider<Enchantment> no pacote datagen. Então implemente o construtor com Registries.ENCHANTMENT como o parametro registryKey para super, e então crie o método addTags.
public class ExampleModEnchantmentTagProvider extends FabricTagsProvider<Enchantment> {
public ExampleModEnchantmentTagProvider(FabricPackOutput output, CompletableFuture<HolderLookup.Provider> registriesFuture) {
super(output, Registries.ENCHANTMENT, registriesFuture);
}
@Override
protected void addTags(HolderLookup.Provider wrapperLookup) {
// ...
}
}2
3
4
5
6
7
8
9
10
Agora nós podemos adicionar o nosso encantamento ao EnchantmentTags.NON_TREASURE chamando o construtor de dentro do método addTags.
builder(EnchantmentTags.NON_TREASURE).add(ModEnchantments.THUNDERING);Maldições
Maldições também são implementadas usando tags. Nós podemos usar o provedor de tags da seção da Mesa de Encantamentos.
No método addTags, simplesmente adicione os seus encantamentos na tag CURSE para marcá-los como uma maldição.
builder(EnchantmentTags.CURSE).add(ModEnchantments.REPULSION_CURSE);
