Генерація досягнень
Посібник із налаштування генерації досягнень за допомогою генерації даних.
WARNING
Ця сторінка написана для версії 26.2. Документація для старіших версій може бути неповною.
ПЕРЕДУМОВИ
Спершу переконайтеся, що ви виконали процес налаштування генерації даних.
Налаштування
По-перше, нам потрібно створити свого постачальника. Створіть клас, який розширює FabricAdvancementProvider та заповніть базові методи:
public class ExampleModAdvancementProvider extends FabricAdvancementProvider {
public ExampleModAdvancementProvider(FabricPackOutput output, CompletableFuture<HolderLookup.Provider> registryLookup) {
super(output, registryLookup);
}
@Override
public void generateAdvancement(HolderLookup.Provider wrapperLookup, Consumer<AdvancementHolder> consumer) {
}
}2
3
4
5
6
7
8
9
Щоб завершити налаштування, додайте цього постачальника до своєї DataGeneratorEntrypoint у методі onInitializeDataGenerator.
pack.addProvider(ExampleModAdvancementProvider::new);Структура досягнення
Досягнення складається з кількох різних компонентів. Разом із вимогами, які називаються «критерієм», він може мати:
DisplayInfo, який повідомляє грі, як показувати до досягнення гравцям,AdvancementRequirements, які є списками списків критеріїв, які вимагають заповнення принаймні одного критерію з кожного підсписку,AdvancementRewards, які гравець отримує за виконання досягнення.Strategy, який повідомляє досягненню, як обробляти кілька критеріїв, і- Батьківський
Advancement, який організовує ієрархію, яку ви бачите на екрані «Досягнення».
Прості досягнення
Ось просте досягнення для отримання ґрунту:
AdvancementHolder getDirt = Advancement.Builder.advancement()
.display(
Items.DIRT, // The display icon
Component.literal("Your First Dirt Block"), // The title
Component.literal("Now make a house from it"), // The description
Identifier.withDefaultNamespace("gui/advancements/backgrounds/adventure"), // Background image for the tab in the advancements page, if this is a root advancement (has no parent)
AdvancementType.TASK, // TASK, CHALLENGE, or GOAL
true, // Show the toast when completing it
true, // Announce it to chat
false // Hide it in the advancement tab until it's achieved
)
// "got_dirt" is the name referenced by other advancements when they want to have "requirements."
.addCriterion("got_dirt", InventoryChangeTrigger.TriggerInstance.hasItems(Items.DIRT))
// Give the advancement an id
.save(consumer, ExampleMod.id("get_dirt"));2
3
4
5
6
7
8
9
10
11
12
13
14
15
Вивід JSON
{
"criteria": {
"got_dirt": {
"conditions": {
"items": [
{
"items": "minecraft:dirt"
}
]
},
"trigger": "minecraft:inventory_changed"
}
},
"display": {
"background": "minecraft:gui/advancements/backgrounds/adventure",
"description": "Now make a house from it",
"icon": {
"id": "minecraft:dirt"
},
"title": "Your First Dirt Block"
},
"requirements": [
[
"got_dirt"
]
],
"sends_telemetry_event": true
}2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
Батьківські
Щоб створити або розширити дерево досягнень, ми можемо встановити батьківське досягнення для нашого досягнення. Для цього викличте Advancement.Builder#parent(...) і передайте посилання на батьківське досягнення.
Advancement.Builder.advancement()
.parent(getDirt)
// ...2
3
Якщо немає прямого посилання на батьківське досягнення (наприклад, використання стандартного досягнення як батьківського), заповнювач можна створити за допомогою ідентифікатора.
Advancement.Builder.advancement()
.parent(createPlaceholder(Identifier.withDefaultNamespace("adventure/root")))
// ...2
3
Тепер ваші досягнення мають показуватися у вигляді дерева в меню досягнень.

Кілька критеріїв
Щоб мати більш розширені умови в наших досягненнях, ми можемо викликати Advancement.Builder#addCriteria(...) кілька разів із додатковими критеріями.
Advancement.Builder.advancement()
.addCriterion("ate_apple", ConsumeItemTrigger.TriggerInstance.usedItem(itemLookup, Items.APPLE))
.addCriterion("ate_cooked_beef", ConsumeItemTrigger.TriggerInstance.usedItem(itemLookup, Items.COOKED_BEEF))
// ...2
3
4
Усталено всі критерії мають бути виконані для завершення досягнення. Ми можемо змінити цю поведінку, запропонувавши іншу стратегію.
Advancement.Builder.advancement()
.addCriterion("brew_mundane", CriteriaTriggers.BREWED_POTION.createCriterion(
new BrewedPotionTrigger.TriggerInstance(Optional.empty(), Optional.of(Potions.MUNDANE))
))
.addCriterion("brew_thick", CriteriaTriggers.BREWED_POTION.createCriterion(
new BrewedPotionTrigger.TriggerInstance(Optional.empty(), Optional.of(Potions.THICK))
))
.requirements(AdvancementRequirements.Strategy.OR)
// ...2
3
4
5
6
7
8
9
Винагороди
Ми можемо додавати винагороди до наших досягнень, які будуть надані, коли гравець завершить досягнення. Ми можемо зробити це, викликавши Advancement.Builder#rewards(...) з винагородами, які ми хочемо додати.
Advancement.Builder.advancement()
.rewards(AdvancementRewards.Builder.experience(10))
// ...2
3
Існує кілька інших типів винагород:
Advancement.Builder.advancement()
.rewards(
new AdvancementRewards.Builder()
// Give entries from a loot table
.addLootTable(ModLootTables.ADVANCEMENT_COLLECT_NETHER_STAR)
// Make recipes available in the recipe book
.addRecipe(RecipeBuilder.getDefaultRecipeId(new ItemStackTemplate(Items.BEACON)))
// Run a .mcfunction - https://minecraft.wiki/w/Function_(Java_Edition)
.runs(ExampleMod.id("got_nether_star"))
// Give experience points
.addExperience(200)
)
// ...2
3
4
5
6
7
8
9
10
11
12
13
Власні критерії
WARNING
У той час як генерація даних може бути на стороні клієнта, Criterion і Predicate знаходяться в основному початковому наборі (обидві сторони), оскільки сервер повинен ініціювати та оцінювати їх.
Визначення
criterion (у множині: criteria) — це те, що гравець може зробити (або що може статися з гравцем), що може бути зараховано для досягнення. У грі є багато критеріїв, які можна знайти в пакеті net.minecraft.advancements.criterion. Як правило, вам знадобиться новий критерій, лише якщо ви запровадите в гру спеціальну механіку.
Умови оцінюються за критеріями. Критерій зараховується, лише якщо виконуються всі відповідні умови. Умови зазвичай виражаються присудком.
Предикат — це те, що приймає значення та повертає boolean. Наприклад, Predicate<Item> може повернути true, якщо предмет є діамантом, тоді як Predicate<LivingEntity> може повернути true, якщо сутність не є ворожою до селян.
Створення власних критеріїв
По-перше, нам знадобиться нова механіка для впровадження. Скажімо гравцеві, який інструмент він використовував щоразу, коли ламав блок.
public class ExampleModDatagenAdvancement implements ModInitializer {
@Override
public void onInitialize() {
HashMap<Item, Integer> tools = new HashMap<>();
PlayerBlockBreakEvents.AFTER.register(((level, player, blockPos, blockState, blockEntity) -> {
if (player instanceof ServerPlayer serverPlayer) { // Only triggers on the server side
Item item = player.getMainHandItem().getItem();
Integer usedCount = tools.getOrDefault(item, 0);
usedCount++;
tools.put(item, usedCount);
serverPlayer.sendSystemMessage(Component.nullToEmpty("You've used \"" + item + "\" as a tool " + usedCount + " times!"));
}
}));
}
}2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
Зауважте, що цей код дійсно поганий. HashMap не зберігається ніде постійно, тому він буде скидатися кожного разу, коли гра перезапускається. Це просто для того, щоб похизуватися критеріями. Почніть гру та спробуйте!
Далі створимо наш спеціальний критерій, UseToolCriterion. Йому знадобиться власний клас Conditions, тому ми створимо їх обидва одночасно:
public class UseToolCriterion extends SimpleCriterionTrigger<UseToolCriterion.Conditions> {
@Override
public Codec<Conditions> codec() {
return Conditions.CODEC;
}
public record Conditions(Optional<ContextAwarePredicate> playerPredicate) implements SimpleCriterionTrigger.SimpleInstance {
public static Codec<UseToolCriterion.Conditions> CODEC = ContextAwarePredicate.CODEC.optionalFieldOf("player")
.xmap(Conditions::new, Conditions::player).codec();
@Override
public Optional<ContextAwarePredicate> player() {
return this.playerPredicate;
}
}
}2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Вау, це багато! Розберімо це.
UseToolCriterion– цеSimpleCriterionTrigger, до якого можуть застосовуватисяConditions.Conditionsмають полеplayerPredicate. УсіConditionsповинні мати предикат гравця (технічноLootContextPredicate).Conditionsтакож маютьCODEC. ЦейCodecє просто кодеком для його одного поля,playerPredicate, з додатковими інструкціями для перетворення між ними (xmap).
INFO
Щоб дізнатися більше про кодеки, див. сторінку про кодеки.
Нам знадобиться спосіб перевірити, чи виконуються умови. Нумо додаймо допоміжний метод до Conditions:
public boolean requirementsMet() {
return true; // AbstractCriterion#trigger helpfully checks the playerPredicate for us.
}2
3
Тепер, коли ми маємо критерій і його умови, нам потрібен спосіб його запустити. Додайте метод запуску до UseToolCriterion:
public void trigger(ServerPlayer player) {
trigger(player, Conditions::requirementsMet);
}2
3
Майже готово! Далі нам потрібен екземпляр нашого критерію для роботи. Розмістімо це в новому класі під назвою ModCriteria та додамо допоміжний метод для зручної реєстрації нових критеріїв.
public class ModCriteria {
public static final UseToolCriterion USE_TOOL = register("use_tool", new UseToolCriterion());
private static <T extends CriterionTrigger<?>> T register(final String name, final T criterion) {
return Registry.register(BuiltInRegistries.TRIGGER_TYPES, ExampleMod.id(name), criterion);
}
}2
3
4
5
6
7
Щоб переконатися, що наші критерії ініціалізуються в потрібний час, додайте порожній метод init:
public static void init() {
}2
І викличте це у своєму ініціалізаторі мода:
ModCriteria.init();Нарешті, нам потрібно запустити наші критерії. Додайте це туди, де ми надіслали повідомлення гравцеві в головному класі мода.
ModCriteria.USE_TOOL.trigger(serverPlayer);Ваш новий блискучий критерій готовий до використання! Нумо додамо до нашого постачальника:
AdvancementHolder breakBlockWithTool = Advancement.Builder.advancement()
.parent(getDirt)
.display(
Items.DIAMOND_SHOVEL,
Component.literal("Not a Shovel"),
Component.literal("That's not a shovel (probably)"),
null,
AdvancementType.GOAL,
true,
true,
false
)
.addCriterion("break_block_with_tool", ModCriteria.USE_TOOL.createCriterion(new UseToolCriterion.Conditions(Optional.empty())))
.save(consumer, ExampleMod.id("break_block_with_tool"));2
3
4
5
6
7
8
9
10
11
12
13
14
Запустіть завдання генерації даних ще раз, і ви отримаєте нове досягнення, з яким можна грати!
Умови з параметрами
Це все добре, але що, якщо ми хочемо надати досягнення лише після виконання певної роботи 5 разів? А чому б не ще один у 10 разів? Для цього нам потрібно надати умові параметр. Ви можете залишитися з UseToolCriterion, або ви можете слідувати разом із новим ParameterizedUseToolCriterion. На практиці ви повинні мати лише параметризований, але ми збережемо обидва для цього посібника.
Попрацюймо знизу вгору. Нам потрібно буде перевірити, чи виконуються вимоги, тому відредагуємо наш метод Conditions#requirementsMet:
public boolean requirementsMet(int totalTimes) {
return totalTimes > this.requiredTimes; // AbstractCriterion#trigger helpfully checks the playerPredicate for us.
}2
3
requiredTimes не існує, тому зробіть його параметром Conditions:
public record Conditions(Optional<ContextAwarePredicate> playerPredicate, int requiredTimes) implements SimpleCriterionTrigger.SimpleInstance {
@Override
public Optional<ContextAwarePredicate> player() {
return this.playerPredicate;
}
public boolean requirementsMet(int totalTimes) {
return totalTimes > this.requiredTimes; // AbstractCriterion#trigger helpfully checks the playerPredicate for us.
}
}2
3
4
5
6
7
8
9
10
Тепер наш кодек неправильний. Напишімо новий кодек для нових змін:
public static Codec<ParameterizedUseToolCriterion.Conditions> CODEC = RecordCodecBuilder.create(instance -> instance.group(
ContextAwarePredicate.CODEC.optionalFieldOf("player").forGetter(Conditions::player),
Codec.INT.fieldOf("requiredTimes").forGetter(Conditions::requiredTimes)
).apply(instance, Conditions::new));2
3
4
Рухаючись далі, тепер нам потрібно виправити наш метод trigger:
public void trigger(ServerPlayer player, int totalTimes) {
this.trigger(player, conditions -> conditions.requirementsMet(totalTimes));
}2
3
Якщо ви створили новий критерій, нам потрібно додати його до ModCriteria
public static final ParameterizedUseToolCriterion PARAMETERIZED_USE_TOOL = register("parameterized_use_tool", new ParameterizedUseToolCriterion());І назвіть це в нашому головному класі, там, де й старий:
ModCriteria.PARAMETERIZED_USE_TOOL.trigger(serverPlayer, usedCount);Додайте досягнення до свого постачальника:
AdvancementHolder breakBlockWithToolFiveTimes = Advancement.Builder.advancement()
.parent(breakBlockWithTool)
.display(
Items.GOLDEN_SHOVEL,
Component.literal("Not a Shovel Still"),
Component.literal("That's still not a shovel (probably)"),
null,
AdvancementType.GOAL,
true,
true,
false
)
.addCriterion("break_block_with_tool_five_times", ModCriteria.PARAMETERIZED_USE_TOOL.createCriterion(new ParameterizedUseToolCriterion.Conditions(Optional.empty(), 5)))
.save(consumer, ExampleMod.id("break_block_with_tool_five_times"));2
3
4
5
6
7
8
9
10
11
12
13
14
Запустіть генерацію даних знову, і ви нарешті закінчили!
Умови ресурсів
Щоб застосувати умову ресурсів до генерованого даними досягнення, оберніть споживача за допомогою withConditions і вкажіть будь-які умови ресурсів, які ви хочете застосувати. Тоді це створить досягнення із застосованими умовами ресурсів:
Advancement.Builder.advancement()
.display(
ModBlocks.DUPLICATOR_BLOCK,
Component.literal("Experimental Duplication"),
Component.literal("Place a duplicator block with the Redstone Experiments flag enabled."),
null,
AdvancementType.CHALLENGE,
false, false, false)
.addCriterion("place_block", ItemUsedOnLocationTrigger.TriggerInstance.placedBlock(ModBlocks.DUPLICATOR_BLOCK))
.save(withConditions(consumer,
ResourceConditions.featuresEnabled(FeatureFlags.REDSTONE_EXPERIMENTS)), ExampleMod.id("experimental_duplication"));2
3
4
5
6
7
8
9
10
11







