翻牌奖励配置

rewards 选项有一丢丢复杂，所有单独一个页面介绍一下。

不同于 v1，v2 的奖励类型（type选项），没那么多了，插件只认 2 种奖励：原版物品和第三方插件的挂钩物品。

原版物品

原版物品的奖励有如下选项：

• material: 奖励物品的物品ID，例如 STONE.

• cmd: 奖励物品的 Custom Model Data 值，例如 1000. (可选)

• display: 奖励物品的显示名称，例如 &eTest Item. (可选)

• lore: 奖励物品的Lore，例如:

  - '&f第一行 Lore'
  - '&f第二行 Lore'

(可选)

看不懂？来个示例:

  1:
    # 这是钻石
    material: DIAMOND
    cmd: 0
    display: '&eA Reward'
    lore:
      - '&fLine1'
      - '&fLine2'
    # 如果你只想要单独的指令奖励，把 give-item 设置为 false
    # 否则玩家既可以获得你设置的物品，又可以获得这个指令给的东西
    give-item: true
    # 随机数量.
    amount: 1~10
    chance: 20
    edge: rare

已保存物品（v1 的自定义物品）

已保存物品的奖励有如下选项:

• material: 你可以使用 /fc save <文件名称> 以保存自定义物品，material 选项与文件名称一致。

已保存物品实际上还是原版物品，我们只是自动读取它的各种信息而已。

看不懂？来个示例:

  2:
    material: SuperSword
    give-item: false
    commands:
      - 'help'
    amount: 10
    # v2 的几率可以设置变量和数学符号在里面了！
    chance: '%player_health*5'
    edge: rare

第三方插件挂钩物品

第三方插件挂钩物品有如下选项:

• hook-plugin: 挂钩的插件，目前支持 EcoItems, EcoArmor, MMOItems, ItemsAdder, Oraxen, MythicMobs, eco, NeigeItems.

• hook-item: 挂钩的物品，不同插件写法略有不同：

• 对于 EcoItems, Oraxen, MythicMobs, NeigeItems，直接填写物品ID就好了。

• 对于 ItemsAdder, eco，你应该填写 命名空间 ID:物品 ID。其中 eco 的命名空间是插件的名称，例如 talisman。

• 对于 EcoArmor，你应该填写 盔甲套装ID;;盔甲部位。 盔甲部位可以是 BOOTS, CHESTPLATE, ELYTRA, HELMET, LEGGINGS。

• 对于 MMOItems，你应该填写 物品类型ID;;物品ID。

看不懂？来个示例:

  1:
    hook-plugin: MMOItems
    hook-item: SWORD;;BASIC_SWORD
    amount: 10
    chance: 20
    edge: rare

通用选项

这些选项是这两种奖励都可以使用的选项，除了 rate（或者rates，旧版本配置写为 chance，v2 也可以使用 chance 选项替代 rate 选项）外，其余选项都是可选的。

• amount: 该奖励物品的数量，例如1，你也可以使用 "1~5" 表示在这个区间内随机取值，默认值: 1。

• times: 设置指令执行的次数，例如1，你也可以使用 "1~5" 表示在这个区间内随机取值，默认值: 1。

• give-item: 是否给予玩家对应的奖励物品，如果是单独的指令奖励（例如给玩家 500 点券），那么需要改成 false，默认值: true.

• actions：玩家完成翻盘，关闭 UI 后执行的动作。有关动作，请见 这。

• flip-actions：玩家点击一张牌，这张牌即将翻转时执行的动作。有关动作，请见 这。

• rate: 该奖励的权重，实际获得该奖励的几率为该奖励的权重除以所有奖励的权重。

v2 新增了动态权重（几率），使用 rates 选项即可做到。

rates:
  default: 0.1
  group.vip: 0.2
  group.mvp: 0.3
  one_rates_condition: 0.4

rates 选项下由多个 key: value 组成，其中 key 可以是：

• default：也是必须的，当以下所有 rates 的 key 都不能满足，那么将会使用 default 的值，例如这里是 0.1。

• 条件ID：当玩家满足 rates-conditions 选项中某个条件ID 后，将会使用对应条件 ID 的值，例如这里满足 one_rates_condition 条件的玩家将会使用 0.4。

你也可以在这里使用 PlaceholderAPI 和数学符号，如果使用数学符号，需要在 config.yml 打开 check-math 选项。

• rates-conditions:

rates-conditions:
  one_rates_condition:
    - 'world: OneWorld'

one_rates_condition 就是条件ID，底下是条件，可在条件一节查看具体信息。

• edge: 该奖励的卡牌边框材质。

• limit: 每次翻牌时该奖励的上限。