快速範例（最新版本 2.9.4）

啟動腳本

// 創建自訂觸發器
AdvJSEvents.trigger(event => {
  event.create("advjs:get_adv")
    // 定義了多少匹配，就應該放多少測試
    // 在這個例子中，我們定義了2個匹配
    .match(advancement => advancement.getId() == "minecraft:story/smelt_iron")
    .match(playerName => playerName == "Dev")
})

伺服器腳本

AdvJSEvents.advancement(event => {
  const { PREDICATE, TRIGGER } = event;

  // 定義觸發器
  const jump5times = TRIGGER.tick(triggerBuilder =>
    triggerBuilder.addStat(Stats.JUMP, Stats.CUSTOM, { min: 5 }));
  const bred_in_nether = TRIGGER.bredAnimals(triggerBuilder => {
    triggerBuilder.setChildByPredicate(PREDICATE.entityFromJson({
      stepping_on: {
        dimension: "the_nether"
      }
    }))
  });
  // AdvJS 自訂觸發器
  const destroy_dirt = TRIGGER.blockDestroyed(triggerBuilder => triggerBuilder.setBlock("dirt"));
  // 你的自訂觸發器
  const get_adv = TRIGGER.custom("advjs:get_adv");

  // 創建根進度
  const root = event.create("advjs:hell")
    .display(displayBuilder => {
      displayBuilder.setTitle("AdvancementJS")
      displayBuilder.setDescription("快速範例")
      displayBuilder.setIcon("diamond")
    })
    .criteria(criteriaBuilder => criteriaBuilder.add("dirt", destroy_dirt))
    .rewards(rewardsBuilder => {
      rewardsBuilder.setExperience(100)
      // AdvJS 自訂獎勵
      rewardsBuilder.addEffect("absorption", 200)
    })
    // 使其可重複
    .repeatable();

  // 為根進度添加子進度
  root.addChild("child1", childBuilder => {
    childBuilder
      .display(displayBuilder => {
        displayBuilder.setTitle(Text.red("Holy"))
        displayBuilder.setDescription(Text.red("地獄開始"))
      })
      .criteria(criteriaBuilder => {
        // 'OR' 意味著如果你想達成這個進度，
        // 你只需要匹配以下兩個觸發器中的一個
        criteriaBuilder.setStrategy(RequirementsStrategy.OR)
        criteriaBuilder.add("bred", bred_in_nether)
        criteriaBuilder.add("jump", jump5times)
        criteriaBuilder.add("get_adv", get_adv)
      })
      .rewards(rewardsBuilder => {
        rewardsBuilder.setRecipes("minecraft:lodestone", "minecraft:brewing_stand")
        rewardsBuilder.setExperience(100)
      })
  });

  // 使用 AdvancementFilter 移除現有進度，可用的過濾器在文檔中有寫。
  // 你也可以通過 id 移除：'event.remove("minecraft:story/lava_bucket");'
  event.remove({
    mod: "minecraft",
    icon: "minecraft:lava_bucket",
    frame: "task"
  });

  // 修改現有進度
  event.get("minecraft:story/smelt_iron")
    // 將偏移應用於顯示
    .displayOffset(1, 1, true)
    .modifyDisplay(displayBuilder => displayBuilder.setIcon("diamond_pickaxe"))
    .addChild("child2", childBuilder => {
      childBuilder
        .display(displayBuilder => {
          displayBuilder.setIcon("recovery_compass")
          displayBuilder.setTitle('我會回來的！')
          displayBuilder.setDescription(Text.green("祝你好運"))
          // 你也可以在 DisplayBuilder 中應用顯示
          displayBuilder.offset(-1, 0)
        })
        // 觸發器也可以從 json 創建
        .criteria(criteriaBuilder => criteriaBuilder.add("go_back_to_home", TRIGGER.fromJson({
          "trigger": "minecraft:changed_dimension",
          "conditions": {
            "from": "minecraft:the_end",
            "to": "minecraft:overworld"
          }
        })))
        // 檢查父進度是否完成，否則無法完成
        .requireParentDone()
    });
})

AdvJSEvents.lock(event => {
  event.result("stone_slab", "minecraft:story/smelt_iron");
  event.itemUse("spyglass", "minecraft:story/smelt_iron");
  event.blockInteract("chest", "minecraft:story/smelt_iron");
  event.entityInteract("villager", "minecraft:story/smelt_iron");
})

// 與 'Better Advancements' 兼容
AdvJSEvents.betterAdv(event => {
  event.modify("advjs:hell/child1").posX(0).posY(32).hideLines()
})

PlayerEvents.advancement(event => {
  const player = event.getPlayer();
  // 第一個參數用於匹配玩家謂詞，另外兩個是你定義的匹配
  CustomTriggers.of("advjs:get_adv").trigger(player, event.getAdvancement(), player.username)
})

如何重新加載

只需使用 /reload

功能

• 指令 /advjs 用於生成內置範例
• 你可以在啟動事件 AdvJSEvents.trigger 中創建自訂觸發器。
• AdvJS 自訂觸發器
  • blockDestroyed
    • 當玩家破壞方塊時觸發。
  • playerTouch
    • 當玩家觸碰實體時觸發。
  • bossEvent
    • 當玩家加入首領戰時觸發。
  • increasedKillScore
    • 當玩家殺死實體時觸發。
• AdvJS 自訂獎勵
  • addEffect
    • 給予效果。
• AdvJS 自訂方法
  • displayOffset(offsetX: number, offsetY: number, modifyChildren?: boolean)
    • 將偏移應用於進度顯示及其子進度
  • requireParentDone()
    • 檢查父進度是否完成，否則無法完成。
  • requireOthersDone(requires[]: ResourceLocation...)
    • 檢查你放入的進度是否已完成。
• 兼容
  • Better Advancements，新的伺服器事件：AdvJSEvents.betterAdv