World Progress

模组

· 作者 Abslb

AnvilLib 的一个附加模组。添加了世界进度系统,以及用于 InWorldRecipe 的 CompeletedProgress 谓词。

0 本站下载 0 关注 更新于 10 个月前

最新 0.0.1 · 1.21.1 · NeoForge

一键开服(送7天)

WorldProgress

A world-level persistent progress / flag system for Minecraft
一个用于 Minecraft 的世界级持久化进度 / 标记系统


? 简介 | Introduction

WorldProgress 是一个基于 AnvilLib 的附属库模组。
它为 Minecraft 提供了一套世界级(World-level)进度标记系统,可用于在整个存档范围内持久化记录“某件事是否已经发生”。

这些进度信息会被写入世界存档,并且可以:

  • 通过 API 在代码中查询 / 设置
  • 通过 命令 手动管理
  • 通过 AnvilLib 的 InWorldRecipe 作为谓词(predicate)使用,从而控制配方是否可用

WorldProgress is an addon library mod for AnvilLib.
It provides a persistent world-level progress / flag system, allowing mods and datapacks to record whether certain events have been completed in a save.

Progress data is saved to disk with the world, and can be:

  • Queried or modified via Java API
  • Managed via commands
  • Used as a predicate in AnvilLib InWorldRecipe, enabling world-state–dependent recipes

? 依赖 | Dependencies

  • NeoForge
  • AnvilLib (required)

✨ 特性 | Features

  • ✅ 世界级进度(与玩家无关)
  • ? 自动随世界存档持久化
  • ? 提供简洁的 Java API
  • ? 内置管理指令
  • ? 与 AnvilLib InWorldRecipe 深度集成
  • ? 支持本地化显示名称(通过资源包)

? API 使用 | API Usage

测试进度是否完成

Test whether a world progress is completed:

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

完成某个世界进度

Mark a world progress as completed:

WorldProgressAPI.achieveProgress(server, progressId);

移除某个世界进度

Remove a completed world progress:

WorldProgressAPI.removeProgress(server, progressId);

获取所有世界进度

Get all completed world progress IDs:

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

获取进度的显示名称

Get localized display name of a progress:

String name = WorldProgressAPI.getProgressString(progressId);

本地化规则 | Localization rule

在语言文件中添加:

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

如果未提供翻译,则会显示 namespace:path


⌨ 指令 | Commands

权限等级:2(默认 OP)

列出当前世界中所有已完成的进度

List all completed world progress in the current world

/worldprogress list

测试某个进度是否已完成

Test whether a progress is completed

/worldprogress test <id>

将某个进度标记为完成

Mark a progress as completed

/worldprogress achieve <id>

移除某个已完成的进度

Remove a completed progress

/worldprogress remove <id>

? 与 InWorldRecipe 集成 | InWorldRecipe Integration

WorldProgress 提供了一个新的 InWorldRecipe 谓词(predicate):

world_progress:complete_progress

示例 | Example

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

该谓词 仅在指定世界进度已完成时才会满足条件。

This predicate passes only if the specified world progress has been completed.

配方示例(节选) | 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)

  • ? Boss 击杀判定

  • ? 科技线 / 配方解锁

  • ? 剧情 / 事件触发

  • ? 作为其他模组的底层库

? 许可证 | License

LGPL3

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源