World Progress

WorldProgress

Система постоянного прогресса / флагов на уровне мира для Minecraft

📖 简介 | Introduction

WorldProgress — это вспомогательный мод-библиотека на основе AnvilLib.

• Используется как predicate через InWorldRecipe из AnvilLib, что позволяет управлять доступностью рецептов

---

WorldProgress — это вспомогательный мод-библиотека для AnvilLib.
Он предоставляет систему постоянного прогресса / флагов на уровне мира, позволяя модам и датапакам записывать, были ли выполнены определённые события в сохранении. Данные прогресса сохраняются на диск вместе с миром и могут быть:

• Запрошены или изменены через Java API
• Управляться через команды
• Использованы как predicate в AnvilLib InWorldRecipe, что позволяет создавать рецепты, зависящие от состояния мира

---

📦 依赖 | Dependencies

• NeoForge
• AnvilLib (обязательно)

---

✨ 特性 | Features

• 🧩 Предоставляет простой Java API
• 🔗 Глубокая интеграция с AnvilLib InWorldRecipe

---

🧩 API 使用 | API Usage

Проверить, выполнен ли прогресс мира:

boolean completed = WorldProgressAPI.testProgress(server, progressId);

Отметить прогресс мира как выполненный:

WorldProgressAPI.achieveProgress(server, progressId);

Удалить выполненный прогресс мира:

WorldProgressAPI.removeProgress(server, progressId);

Получить все ID выполненных прогрессов мира:

List<ResourceLocation> list = WorldProgressAPI.getProgressList(server);

Получить локализованное отображаемое имя прогресса:

String name = WorldProgressAPI.getProgressString(progressId);

本地化规则 | Localization rule

progress_name.<namespace>.<path>="显示名称"

Если перевод не предоставлен, будет отображаться namespace:path

⌨ 指令 | Commands

Показать все выполненные прогрессы мира в текущем мире

/worldprogress list

Проверить, выполнен ли прогресс

/worldprogress test <id>

Отметить прогресс как выполненный

/worldprogress achieve <id>

Удалить выполненный прогресс

/worldprogress remove <id>

🔧 与 InWorldRecipe 集成 | InWorldRecipe Integration

WorldProgress предоставляет новый predicate для InWorldRecipe:

world_progress:complete_progress

示例 | Example

{
  "type": "world_progress:complete_progress",
  "progress_id": "world_progress:downed_ender_dragon"
}

Этот predicate проходит только если указанный прогресс мира был выполнен.

配方示例（节选） | Recipe Example (Excerpt)

"non_conflicting": [
  {
    "type": "anvilcraft:has_cauldron",
    "offset": [0.0, -1.0, 0.0]
  },
  {
    "type": "world_progress:complete_progress",
    "progress_id": "world_progress:downed_ender_dragon"
  }
]

🎯 适用场景 | Use Cases

• 🌍 Система стадий мира (World Stages)

📄 许可证 | License

LGPL3