Advancement Portals

Advancement Portals

现在支持 FTB Teams 集成和进度共享！

让维度访问成为有意义的进度体验。

Advancement Portals 允许整合包作者通过原版或自定义进度，锁定前往下界、末地或几乎任何模组维度的通道。目的地被锁定时，玩家会收到清晰提示；完成已配置的要求后，目的地便会自然解锁。

3.1 版本还新增了可选的 FTB Teams 进度共享，让合作小队能够共同推进进度，无需每位队友都重复击败同一个 Boss 或完成相同里程碑。

为什么使用 Advancement Portals？

许多进度整合包依靠玩家自律、任务文本、禁用配方或自定义传送门替代方案来控制维度访问。Advancement Portals 提供了一种专注于此的替代方案：

• 保留原有传送门或旅行方式。
• 选择用于解锁各个维度的进度里程碑。
• 使用原版进度、模组进度或数据包进度。
• 要求完成所有已配置的里程碑，或允许多种有效解锁路径。
• 明确说明玩家还缺少哪些要求。
• 支持 FTB Teams 小队共享进度。

它尤其适用于专家整合包、RPG 整合包、任务整合包、分阶段探索、多人游戏进度和自定义维度整合包。

功能

锁定几乎任何维度

使用维度原本的维度 ID 配置目的地：

dimensionRequirements = [
  "minecraft:the_nether | ALL | minecraft:story/mine_diamond",
  "minecraft:the_end | ALL | minecraft:nether/obtain_ancient_debris",
  "twilightforest:twilight_forest | ANY | mypack:quests/twilight_access, minecraft:adventure/kill_a_mob"
]

Advancement Portals 会检查玩家维度旅行的目的地；如果对应的门槛尚未达成，就会阻止玩家前往。未配置的维度不受影响。

选择 ALL 或 ANY

创建严格的进度路线，或提供多种可选路径。

"minecraft:the_end | ALL | mypack:chapter_3, mypack:defeat_wither"

玩家必须完成这两项进度。

"minecraft:the_end | ANY | minecraft:end/kill_dragon, mypack:quests/end_pass"

完成任意一项进度即可解锁目的地。

清晰的传送门锁定提示

玩家被阻止时，可以看到：

• 易于理解的目的地名称。
• 是否需要完成所有进度，或任意一项即可。
• 每项尚未完成进度的易读标题。
• 可选的进度描述。
• 已配置的进度 ID 无法识别时的警告。
• 目的地仍被锁定时的快捷栏提醒。

消息冷却时间可配置，以防止传送门提示刷屏。

维度解锁通知

完成最后一项要求后，玩家可以收到聊天栏和快捷栏消息，确认目的地现已开放。

可选的 FTB Teams 进度共享

Minecraft 进度通常属于单个玩家。当团队完成了集体里程碑，却只有一名玩家获得进度时，这可能会让人沮丧——例如，只有一名队友打出了末影龙的最后一击。

启用 FTB Teams 共享后：

• 符合条件的进度会共享给同一小队的成员。
• 在线队友会立即获得进度。
• 离线队友返回后会收到已保存的进度。
• 检查旅行权限前会同步门槛进度。
• 升级后的世界可以检测在线队友已获得的门槛进度。
• FTB Teams 为可选功能，正常的维度锁定无需安装它。

仅共享传送门所用的进度：

[ftbTeams]
shareAdvancementsWithTeam = true
shareOnlyPortalAdvancements = true

或分享最近获得的大多数进度：

[ftbTeams]
shareAdvancementsWithTeam = true
shareOnlyPortalAdvancements = false

默认不包含配方类进度，以避免产生大量不可见的配方进度记录。

管理员友好的控制选项

通用/服务器配置包含：

• 总开关。
• 创造模式绕过。
• 旁观模式绕过。
• 管理员绕过。
• 可配置的管理员权限等级。
• 警告冷却时间。
• 传送门被阻止后的重试延迟。
• 进度描述。
• 解锁消息。
• FTB Teams 共享行为。
• 登录时同步。
• 共享进度通知。

更安全地开发整合包

服务器启动时，Advancement Portals 会验证已配置的门槛，并报告缺失的维度、未知进度、格式错误的 ID、无效模式以及重复的目标。

拼写错误不会导致目标被悄然解锁。未知进度会继续作为阻拦条件，直到修正配置或数据包。

配置

配置文件生成于：

config/advancement_portals-common.toml

推荐的门槛格式：

dimension | ALL/ANY | advancement, advancement

完整示例：

dimensionRequirements = [
  "minecraft:the_nether | ALL | minecraft:story/enchant_item, minecraft:story/mine_diamond",
  "minecraft:the_end | ANY | minecraft:end/kill_dragon, mypack:quests/end_access"
]

[dimensionGating]
enabled = true
creativePlayersBypassGates = true
spectatorPlayersBypassGates = true
operatorsBypassGates = true
operatorBypassPermissionLevel = 2
warningCooldownSeconds = 2
blockedPortalRetryDelayTicks = 20
showAdvancementDescriptions = true
showDimensionUnlockMessages = true

[ftbTeams]
shareAdvancementsWithTeam = true
shareOnlyPortalAdvancements = false
shareRecipeAdvancements = false
syncTeamAdvancementsOnLogin = true
notifySharedAdvancements = true

现有整合包仍可使用旧格式：

"minecraft:the_end=[minecraft:end/kill_dragon]"

旧格式条目会按 ALL 门槛处理。

关于共享奖励的重要说明

FTB Teams 共享会完成接收玩家在 Minecraft 中对应进度的常规达成条件。该进度关联的奖励也可能一并发放，包括：

• 经验
• 配方
• 战利品
• 函数

若要采用最安全、专注于进度的设置，请使用专用的隐藏进度来控制维度访问，或启用：

shareOnlyPortalAdvancements = true

推荐用途

• 进入下界前要求获得钻石。
• 进入末地前要求获得远古残骸。
• 完成某一章任务后解锁维度。
• 提供两个可解锁同一目标的备选 Boss。
• 在共同击败 Boss 后，让整个合作队伍保持进度同步。
• 通过漫长的进度树逐步开放模组维度。
• 将数据包进度用作不可见的访问标记。

从旧版本更新

3.1 版本继续支持读取原有的 3.0.x dimensionRequirements 语法。现有门槛条目可以保持不变，你也可以按照自己的节奏逐步迁移到新格式。

更新后，请检查生成的配置文件，并查看服务器启动日志中的验证警告。

Bandit-bytes Discord

Pixel Dream Studios Discord