Генерація досягнень

ПЕРЕДУМОВИ

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

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

По-перше, нам потрібно створити свого постачальника. Створіть клас, який розширює FabricAdvancementProvider та заповніть базові методи:

No lines matched.

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

No lines matched.

Структура досягнення

Досягнення складається з кількох різних компонентів. Разом із вимогами, які називаються «критерієм», він може мати:

• DisplayInfo, який повідомляє грі, як показувати до досягнення гравцям,
• AdvancementRequirements, які є списками списків критеріїв, які вимагають заповнення принаймні одного критерію з кожного підсписку,
• AdvancementRewards, які гравець отримує за виконання досягнення.
• Strategy, який повідомляє досягненню, як обробляти кілька критеріїв, і
• Батьківський Advancement, який організовує ієрархію, яку ви бачите на екрані «Досягнення».

Прості досягнення

Ось просте досягнення для отримання ґрунту:

No lines matched.

WARNING

Під час створення записів про досягнення пам’ятайте, що функція приймає Identifier досягнення у форматі String!

Вивід JSON

{
  "criteria": {
    "got_dirt": {
      "conditions": {
        "items": [
          {
            "items": "minecraft:dirt"
          }
        ]
      },
      "trigger": "minecraft:inventory_changed"
    }
  },
  "display": {
    "background": "minecraft:textures/gui/advancements/backgrounds/adventure.png",
    "description": "Now make a house from it",
    "icon": {
      "id": "minecraft:dirt"
    },
    "title": "Your First Dirt Block"
  },
  "requirements": [
    [
      "got_dirt"
    ]
  ],
  "sends_telemetry_event": true
}

Ще один приклад

Щоб зрозуміти, додамо ще одне досягнення. Ми попрактикуємося додавати нагороди, використовувати кілька критеріїв і призначати батьківські досягнення:

No lines matched.

Власні критерії

WARNING

У той час як datagen може бути на стороні клієнта, Criterion і Predicate знаходяться в основному вихідному наборі (обидві сторони), оскільки сервер повинен ініціювати та оцінювати їх.

Визначення

criterion (у множині: criteria) — це те, що гравець може зробити (або що може статися з гравцем), що може бути зараховано для досягнення. У грі є багато критеріїв, які можна знайти в пакеті net.minecraft.advancements.criterion. Як правило, вам знадобиться новий критерій, лише якщо ви запровадите в гру спеціальну механіку.

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

Предикат — це те, що приймає значення та повертає boolean. Наприклад, Predicate<Item> може повернути true, якщо предмет є діамантом, тоді як Predicate<LivingEntity> може повернути true, якщо сутність не є ворожою до селян.

Створення власних критеріїв

По-перше, нам знадобиться нова механіка для впровадження. Скажімо гравцеві, який інструмент він використовував щоразу, коли ламав блок.

No lines matched.

Зауважте, що цей код дійсно поганий. HashMap не зберігається ніде постійно, тому він буде скидатися кожного разу, коли гра перезапускається. Це просто для того, щоб похизуватися критеріями. Почніть гру та спробуйте!

Далі створимо наш спеціальний критерій, UseToolCriterion. Йому знадобиться власний клас Conditions, тому ми створимо їх обидва одночасно:

No lines matched.

Вау, це багато! Розберімо це.

• UseToolCriterion – це SimpleCriterionTrigger, до якого можуть застосовуватися Conditions.
• Conditions мають поле playerPredicate. Усі Conditions повинні мати предикат гравця (технічно LootContextPredicate).
• Conditions також мають CODEC. Цей Codec є просто кодеком для його одного поля, playerPredicate, з додатковими інструкціями для перетворення між ними (xmap).

INFO

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

Нам знадобиться спосіб перевірити, чи виконуються умови. Нумо додаймо допоміжний метод до Conditions:

No lines matched.

Тепер, коли ми маємо критерій і його умови, нам потрібен спосіб його запустити. Додайте метод запуску до UseToolCriterion:

No lines matched.

Майже готово! Далі нам потрібен екземпляр нашого критерію для роботи. Помістімо його в новий клас під назвою ModCriteria.

No lines matched.

Щоб переконатися, що наші критерії ініціалізуються в потрібний час, додайте порожній метод init:

No lines matched.

І викличте це у своєму ініціалізаторі мода:

No lines matched.

Нарешті, нам потрібно запустити наші критерії. Додайте це туди, де ми надіслали повідомлення гравцеві в головному класі мода.

No lines matched.

Ваш новий блискучий критерій готовий до використання! Нумо додамо до нашого постачальника:

No lines matched.

Запустіть завдання datagen ще раз, і ви отримаєте нове досягнення, з яким можна грати!

Умови з параметрами

Це все добре, але що, якщо ми хочемо надати досягнення лише після виконання певної роботи 5 разів? А чому б не ще один у 10 разів? Для цього нам потрібно надати умові параметр. Ви можете залишитися з UseToolCriterion, або ви можете слідувати разом із новим ParameterizedUseToolCriterion. На практиці ви повинні мати лише параметризований, але ми збережемо обидва для цього посібника.

Попрацюймо знизу вгору. Нам потрібно буде перевірити, чи виконуються вимоги, тому відредагуємо наш метод Conditions#requirementsMet:

No lines matched.

requiredTimes не існує, тому зробіть його параметром Conditions:

No lines matched.

Тепер наш кодек неправильний. Напишімо новий кодек для нових змін:

No lines matched.

Рухаючись далі, тепер нам потрібно виправити наш метод trigger:

No lines matched.

Якщо ви створили новий критерій, нам потрібно додати його до ModCriteria

No lines matched.

І назвіть це в нашому головному класі, там, де й старий:

No lines matched.

Додайте досягнення до свого постачальника:

No lines matched.

Запустіть datagen ще раз, і ви нарешті закінчили!