v1 翻牌UI配置

我可以在哪找到它们?

所有的翻牌UI配置全部保存在 /plugin/FlipCard/ui 文件夹。

名称

每个翻牌UI都有它独特的名称。例如 example.yml。翻牌UI的名称决定在使用指令时指令变量 <事件名称>。以 example.yml 为例,你需要使用 /fc forceopen <文件名称> example 指令以打开它的翻牌 UI。

组成

所有卡牌配置由 UI 配置 奖励配置 组成。

UI 配置

打开一个卡牌配置,你将发现如下内容:

option:
  slots: [9,11,13,15,17,36,38,40,42,44]
  title: "&9&lDungeon Complete Reward"
  time: 60
  timer: true
  display: true
  auto_close: true
  close_animal: true
  auto_claim_free_rewards: true
  total_max: 10
  • slots: 卡牌对应物品的槽位。只可以设置为: [9,11,13,15,17,36,38,40,42,44] (10 张卡牌) 或者 [10,12,14,16,37,39,41,43] (8 张卡牌)。

  • title: 翻牌 UI 的标题.

  • time: 翻牌的时长。玩家必须在对应时长内完成翻牌。只在 timer 选项被启用后才会生效。

  • timer: 是否启用翻牌时长。

  • display: 是否允许玩家预览卡牌奖励,预览后将会重新翻牌。

  • auto_close:所有卡牌全部翻牌后是否自动关闭。

  • close_animal: 是否展示UI关闭时的动画(玩家主动关闭无法展示,但是重新打开UI会有动画后效果),该动画中所有卡牌都会翻转,让玩家查看奖励(包括自己没有拿到的),如果服主在这里设置了超级好的奖励,玩家发现自己没拿到,可能会哭。

  • auto_claim_free_rewards: 在玩家主动关闭UI和自动关闭UI后,是否自动领取所有免费奖励。

  • total_max: UI所有卡牌翻牌上限。

卡牌配置

下面的部分则为卡牌配置,每个卡牌的配置代表一个卡牌类型:

card_1:
  # card_1的配置
card_2:
  # card_2的配置
card_3:
  # card_3的配置

各个卡牌具体的配置如下:

card_1:
  front: card2
  back: card3
  max: 4
  amount: 5
  name: "&dLucky Card - EPIC"
  lore:
  - "You need cost %price% "
  - "to clip it."
  prices:
    # 价格配置
  rewards:
    # 奖励配置
  • front: 卡牌正面材质。

  • back: 卡牌背面材质。

  • max: 每次翻牌可以翻该种牌的数量。不能超过 amount 选项的值。

  • amount: 该种类型卡牌的数量。所有类型的卡牌的数量总和不能超过 slot 设置的值。(例如,10个槽位=10张卡牌)

  • name: 卡牌显示的名称。

  • lore: 卡牌的 Lore。可以使用 %price% 显示其价格。

  • prices: 卡牌的价格,具体请见下方。

  • rewards: 卡牌的奖励,具体请见下方。

中文Wiki老旧,price选项新版本改为prices选项了,award选项新版本改为rewards选项了,下面的我就不改了,各位自己心里有数即可。

价格配置

如果你希望玩家必须付出点什么才能翻牌,这里将会帮助你。

一张卡牌可以有无限的价格计划。每个价格计划都有它独特的 ID。所有的 ID 必须是从 1 开始递增,每次递增 1。

  prices:
    1: #计划 1
      type: vault
      apply: [1,2]
      cost: [1500,2000]
    2: #计划 2
      type: playerpoints
      apply: [2,3,4,5]
      cost: [10,20,30,40]
    3: #计划 3
      type: item
      apply: [6,7,8]
      cost: [4,5]
      key: magicdiamond #不是[magicdiamond]!!
  • type: 价格类型。详见下方。

  • apply: 表示该价格计划适用的翻牌次数。例如,apply: [1,2] 代表这个翻牌计划适用于第一次翻牌和第二次翻牌。

  • cost: 表示到底花费的金币 (Vault) 或者点券 (PlayerPoints) 数量。例如,cost: [1500,2000] 表示玩家第一次翻牌需要 1500 金币,第二次发票需要 2000 金币。如果 type 设置为 free,那么这个选项可以去掉。

  • key: 表示具体的自定义物品。只在 type 设置为 item 时需要。

请注意 cost 必须和 apply 一对一对应。

FlipCard 将会智能地给玩家推送最佳价格方案。

例如,在上方所给示例中,计划 1 和 计划 2 都适用第二次翻牌:

  • 越小 ID 的价格计划越先被使用。

  • 如果玩家满足计划 1,那么玩家将会使用计划 1 的价格。

  • 如果玩家不满足计划 1,那么玩家将会使用计划 2 的价格。

免费

1:
  type: free
  apply: [1,2]

原版物品

2: 
  type: vanilla
  apply: [1,2]
  cost: [1,2]
  material: STONE
  • material: 原版物品ID。

自定义物品

3: 
  type: item
  apply: [1,2]
  cost: [1,2]
  key: super_diamond
  • key: 你可以使用 /fc save <文件名称> 以保存自定义物品,key 选项与文件名称一致。

Vault:

4: 
  type: vault
  apply: [1,2]
  cost: [1500,2000]

PlayerPoints:

5: 
  type: playerpoints
  apply: [1,2]
  cost: [100,200]

GamePoints:

6: 
  type: gamepoints
  apply: [1,2]
  cost: [100,200]

原版等级:

7: 
  type: levels
  apply: [1,2]
  cost: [1,2]

原版经验值:

8: 
  type: exp
  apply: [1,2]
  cost: [100,200]

ItemsAdder:

9: 
  type: itemsadder
  apply: [2,3]
  cost: [1,2]
  id: 'bow:vortex_bow_netherite'
  • id: ItemsAdder 物品id,必须使用 'namespace:id' 格式。

Oraxen:

10: 
  type: oraxen
  apply: [2,3]
  cost: [1,2]
  id: 'vortex_bow_netherite'
  • id: Oraxen 物品ID。

MMOItems:

11: 
  type: mmoitems
  apply: [2,3]
  cost: [1,2]
  mi_type: MATERIAL
  mi_name: SILVER_INGOT
  • mi_type: MMOItems 物品类型。

  • mi_name: MMOItems 物品ID。

EcoItems:

12: 
  type: ecoitems
  apply: [2,3]
  cost: [1,2]
  id: 'armor_core'
  • id: EcoItems 物品ID。

EcoArmor:

13: 
  type: ecoarmor
  apply: [2,3]
  cost: [1,2]
  id: angelic
  armor_slot: helmet
  • armor_slot: 可以设置为 BOOTS, CHESTPLATE, ELYTRA, HELMET, LEGGINGS 之一。例如,在这个示例配置中,我们设置为了 HELMET

  • id: EcoArmor 套装ID。

MythicMobs:

14: 
  type: mythicmobs
  apply: [2,3]
  cost: [1,2]
  id: SkeletonKingSword
  • id: MythicMobs 物品ID。

条件配置

v1 的条件写的比较失败。这个选项是可选的,你删掉也可以。

玩家必须满足你所设置的所有条件才能使用这个翻牌UI。

一张卡牌可以有无限的条件计划。每个条件计划都有它独特的 ID。所有的 ID 必须是从 1 开始递增,每次递增 1。

  conditions:
    1:
      type: permission
      permission: 'test.test'
  • type: 条件类型,详见下方。

  • fail-message: 如果玩家不满足条件,提示的信息。 (可选)

PlaceholderAPI

1:
  type: placeholder
  placeholder: '%player_points%'
  sign: '>='
  value: 50
  fail-message: "REQUIRE Level 3"
  • sign: 可以设置为:

    • >=

    • <=

    • >

    • <

    • == (String)

    • = (Int)

    • *= (String) 字符串包含,例如 str *= string 是 true,example *= ple 是 false.

权限节点

2:
 type: permision
 permission: 'test.test'

奖励配置

每张卡牌的奖励在玩家打开翻牌 UI 时就已被决定。

一个卡牌可以有无数的奖励计划。每个奖励计划都有它独特的 ID。所有的 ID 必须是从 1 开始递增,每次递增 1。

rewards:
  1:
    type: vanilla
    material: GOLDEN_APPLE
    amount: 1~5
    rate: 3
    edge: very_rare
    limit: 1
    announcement: "&a[FlipCard] %player% received &6%amount%-%display%"
  • type: 该奖励的类型。详见下方。

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

  • rate: 该奖励的获得权重值。

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

  • limit: 每次翻牌时该奖励的上限。(可选)

  • announcement: 玩家获得该奖励时的公告。(可选)

原版奖励:

1:
  type: mc
  material: GOLDEN_APPLE 
  #cmd: 10 (你可以添加这一行以为物品设置 CustomModelData)
  amount: 1~5
  rate: 3
  edge: very_rare

自定义物品奖励:

2:
  type: item
  key: sword
  amount: 1
  rate: 1
  edge: very_rare

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

指令奖励:

请注意: 从 1.1.3 版本开始,指令奖励也可以用于其他类型的奖励,你只需要将 command 选项添加到对应奖励类型即可。

3:
  type: command
  command:
  - "eco give %player% 1000"
  - "say §6Player %player% received $1000"
  material: GOLD_NUGGET
  # material: SKULL
  # skull_meta: xxx
  times: 2~3
  display_name: "&6$1000"
  amount: 1
  lore:
  - "×1000"
  rate: 5
  edge: common

times 选项是可选的,它可以设置指令执行的次数,默认为 1。

MMOItems 奖励:

4:
  type: mmoitems
  mi_type: MATERIAL
  mi_name: SILVER_INGOT
  amount: 3~7
  rate: 5
  edge: rare

ItemsAdder 奖励:

5:
  type: itemsadder
  id: vortex_bow_netherite
  amount: 1
  rate: 2
  edge: very_rare

你也可以设置为 nameSpace:itemID 样式。

Oraxen 奖励:

6:
  type: oraxen
  id: vortex_bow_netherite
  amount: 1
  rate: 2
  edge: very_rare

EcoItems 奖励:

7:
  type: ecoitems
  id: armor_core
  amount: 1
  rate: 2
  edge: very_rare

EcoArmor 奖励:

8:
  type: ecoarmor
  id: angelic
  armor_slot: helmet
  amount: 1
  rate: 2
  edge: very_rare

armor_slot 选项可以设置为 BOOTS, CHESTPLATE, ELYTRA, HELMET, LEGGINGS 之一。例如,在这个示例配置中,我们设置为了 HELMET

MythicMobs 奖励:

14: 
  type: mythicmobs
  apply: [2,3]
  cost: [1,2]
  id: SkeletonKingSword
  • id: MythicMobs 物品ID。

Last updated