v1 UI Configs (Outdated)
Where can I find them?
All cards event configurations are saved in /plugin/FlipCard/ui
folder.
Name
Every FlipCard card flop UI configuration have its unique name. It likes example.yml. The name of card configuration determines the command arg <uiName>
when you use the plugin's commands. Taking example.yml as an example, you need use /fc <PlayerName> example command to open its card flop UI.
Composition
All card configurations are composed of UI configuration and reward configuration.
UI Configuration
Open a card configurations, you will find the following section.
slots: Slots of the item representing the card. Only can be set to: [9,11,13,15,17,36,38,40,42,44] (10 cards) or [10,12,14,16,37,39,41,43] (8 cards).
title: Titles of the card flip UI.
time: Duration of the card flip. Players must claim cards in this time. ONLY take effect when the timer option is enabled.
timer: Enable or disable timer.
display: Allow or disallow player preview the card rewards. After preview the cards will be shuffled.
auto_close: Whether the flip UI will close after all cards have floped.
close_animal: Whether display close animal when auto close enabled and activated. In this animal, all cards will display its reward (however players wont get them) before UI closes.
auto_claim_free_rewards: Whether plugin will auto send all free type rewards to players after they close flip UI.
total_max: Total max flip limit for all cards in a flip UI. Default to -1, which means no limit.
Card Type Configuration
The following section are card type configurations. Each card type configureation mean one card type, not one card.
The detailed configuration is as follows:
front: Texture of unfliped card.
back: Texture of fliped card.
max: The max flip max times in a card flip event. It should be less than amount.
amount: Amount of this type of card. The combined value of all cards amount cannot be greater than the value set by the slot option. (For example, 10 slots = 10 cards)
name: Card display name.
lore: Card lore. Can use %price% to display its cost.
prices: Price config. For more details, please view below.
rewards: Reward config. For more details, please view below.
conditions: Condition config. For more details, please view below.
Price Configuration
If you want your players must cost some money to flip cards, this part will help you.
A card type can have unlimited price plan. Every plans have its ID number. All plan ID number should be a natural number starting from 1 and incrementing by 1.
type: Price type. For more info, please see below.
apply: Represent how many flips this price plan applies to in a card flip event. For example, apply: [1,2] represent this plan apply to player clip this type of card for the first time and second time in a card flip event.
cost: Represent how much money or item amounts are consumed. For example, cost: [1500,2000] represent player will cost $1500 to clip card for the first time and $2000 for the second time in a card flip event. If type set to free, this option is not required.
Please note cost should correspond to apply one by one.
FlipCard will intelligently push the best card price plan for players according to the cost.
Fox example, in the example configuration above, both Plan 1 and Plan 2 apply to the second time clip:
Plan with small ID number will be checked first.
If player have more than $2000(Vault) which plan 1 required, plan 1 will be used.
If player does not have enough money which plan 1 required, plan 2 will be used.
Free Price
Vanilla Item Price
material: The vanilla item material name.
Custom Items Price:
key: You can use /fc save <FileName> to save the items you are holding. The key option is the same as file name.
Vault Price:
PlayerPoints Price:
GamePoints Price:
Vanilla Levels Price:
Vanilla Exp Price:
ItemsAdder Price:
id: ItemsAdder Item ID, must use '
namespace:id
' form.
Oraxen Price:
id: Oraxen Item ID.
MMOItems Price:
mi_type: MMOItems Type.
mi_name: MMOItems Item ID.
EcoItems Price:
id: EcoItems Item ID.
EcoArmor Price:
armor_slot: can set to BOOTS, CHESTPLATE, ELYTRA, HELMET, LEGGINGS. For example, in this example config, we set to HELMET.
id: EcoArmor set ID.
MythicMobs Price:
id: MythicMobs Item ID.
Condition Configuration
Players must meet all of the conditions to flip the type of cards.
A card type can have unlimited conditions. Every conditions have its ID number. All plan ID number should be a natural number starting from 1 and incrementing by 1.
This part of configuration is optional, this means you can remove this if you don't need this feature.
type: The type of the condition. For more info, please see below.
fail-message: If players can't meet the condition, the message he will receive. (Optional)
PlaceholderAPI Condition
sign: Can be set to:
>=
<=
>
<
== (String)
= (Int)
*= (String) Contains, for example, str *= string is true, but example *= ple is false.
Permission Condition
Reward Configuration
The rewards of the type of cards will be rowed out according to the reward plans in reward configuration it when the card flip UI is opened.
A card can have unlimited reward plan. Every plan have its ID number. All plan ID number should be a natural number starting from 1 and incrementing by 1.
type: The type of the reward. For more info, please see below.
amount: The amount of the reward. You can also entry in the form of "1~5" which means the amount is random in the interval.
rate: The weight of the reward. Real rate is this reward rate/all rewards total rate.
edge: The textures of reward edge. It can express rarity.
limit: The max limit of the reward in a card flip event. Set 1 means you can only get this reward once in a card flip event. (optional)
announcement: The message that server will send after player flip this card. (optional)
Vanilla Items Reward:
material: The vanilla item material name.
Custom Items Reward:
key: You can use /fc save <FileName> to save the items you are holding. The key option is the same as file name.
Command Reward:
Please note: Since 1.1.3 command reward can be used in other reward type, you can do this by adding command option to other reward type config.
times
option is optional, and use to set the number of times the command executed, default is 1.
MMOItems Reward:
ItemsAdder Reward:
id: ItemsAdder Item ID, must use '
namespace:id
' form.
Oraxen Reward:
id: Oraxen Item ID.
EcoItems Reward:
id: EcoItems Item ID.
EcoArmor Reward:
armor_slot: can set to BOOTS, CHESTPLATE, ELYTRA, HELMET, LEGGINGS. For example, in this example config, we set to HELMET.
id: EcoArmor set ID.
MythicMobs Reward:
id: MythicMobs Item ID.
Last updated