> For the complete documentation index, see [llms.txt](https://diviosx.gitbook.io/daily-random-shop/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://diviosx.gitbook.io/daily-random-shop/yaml-support/format.md). # Format ## Key All the items are represented with an ID that is used internally by the plugin for numerous tasks. You can create a valid key [here](https://www.uuidgenerator.net/). Both options are valid, just make sure not to copy the same id in two different items. Also don't worry if it is between quotes or not, it will work both ways. ```yaml ffc39149-4163-47b1-95c1-8d8be04cc545: #This is the id of the item material: "TERRACOTTA" dailyShop_meta: buyPrice: "50.0" sellPrice: "5.0" set: 32 confirm_gui: true rarity: "Common" econ: "vault:" ``` ## ID This is the name of the shop where all the items will be added. {% hint style="info" %} If the shop doesn't exist, a new shop with that name will be created, so you can create new shops too with the parser. {% endhint %} ## Shop Inside this category you will find all the values to configure the shop gui. ```yaml shop: name: "blocks" size: 45 display_items: 6e72d7b3-74c3-4636-b8ad-9afbc17cbbd9: name: '&c' material: BLACK_STAINED_GLASS_PANE quantity: 1 slot: 0 ``` ### Name This is the name of the gui, supports color codes. ```yaml shop: name: "blocks" ``` ### Size The size of the gui inventory. The maximum is 54 and the minimun 9. If a wrong number is given it will default to 27. ```yaml shop: size: 45 ``` ### Display\_items Here are all the items of the [Shop Display](/daily-random-shop/usage/shop-display.md). The slot represent the position of the item in the gui. If the position is greater that the shop size the item will be ignored. Also you can set Actions to ## ItemMeta ### Name The name is the display name of the item, it supports colors. It's not mandatory. ```yaml 7ac57463-f370-4c38-aa56-9697e1bb7547: name: "§cCustom Item" ``` ### Lore This is the lore of the item, it support colors. It's not mandatory. ```yaml 7ac57463-f370-4c38-aa56-9697e1bb7547: lore: - "&cThis is" - "&ca custom" - "&e&llore" ``` ### Material This is the material of the item. It is mandatory and has to be a valid material, check [the list of materials](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html). ```yaml c2c79fda-275e-43eb-b031-775ea77e1043: material: "GOLD_INGOT" ``` ### Quantity This the quantity of the item. If not specified, it defaults to 0. Some dailyMetada can override this such as set and stock. ```yaml 7ac57463-f370-4c38-aa56-9697e1bb7547: material: "GOLD_INGOT" quantity: 30 ``` ### Enchantments This are the enchantments of the item. It is not mandatory and has to be a valid enchantment, check the [list of all enchantments](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html). ```yaml 1b5a1d9c-f36d-459d-b9e1-ecdac009feaa: material: IRON_SWORD enchantments: LUCK: 1 LOYALTY: 3 ``` ## DailyShop Meta This are all the meta that allows you configure the dailyShop features. ### BuyPrice This is the buy price of the item. If you do not include this option, the default is -1, meaning that the item cannot be purchased. The format for range prices is minPrice:maxPrice. ```yaml "1b5a1d9c-f36d-459d-b9e1-ecdac009feaa": name: "§4§lDestructor §7Gkit" material: "FIRE_CHARGE" dailyShop_meta: buyPrice: "500.0" ``` ```yaml "1b5a1d9c-f36d-459d-b9e1-ecdac009feaa": name: "§4§lDestructor §7Gkit" material: "FIRE_CHARGE" dailyShop_meta: buyPrice: "30.0:200.0" ``` ### SellPrice This is the sell price of the item. If you do not include this option, the default is -1, meaning that the item cannot be sold. ```yaml "66d00438-c66f-4ce9-a2ef-e7d82eff1866": material: "SANDSTONE" dailyShop_meta: sellPrice: "3.0" ``` ### Stock This option represents the [stock](broken://pages/-MaACo3QnEiZZzAVJ304) of the item. The format is TYPE:AMOUNT. Where type can be GLOBAL or INDIVIDUAL and the amount is the default stock. ```yaml 8e158fdc-d6ef-4673-81e1-d1a7a9fd9be7: material: "ACACIA_LOG" dailyShop_meta: buyPrice: "100.0" sellPrice: "10.0" stock: "GLOBAL:15" ``` ### Set This option represent the amount for the [set feature](broken://pages/-MaACy26ahx5s2ZZD1B2). ```yaml f2028924-a7a6-4284-855f-7fba0de49487: material: "DIRT" dailyShop_meta: buyPrice: "100.0" sellPrice: "3.0" set: 64 ``` ### BuyPerms The permission needed to buy the item ```yaml 66d00438-c66f-4ce9-a2ef-e7d82eff1866: material: "SANDSTONE" dailyShop_meta: buyPrice: "30.0" sellPrice: "3.0" set: 32 buyPerms: - "permission.custom" ``` ### SellPerms The permissions need to sell the item. ```yaml 66d00438-c66f-4ce9-a2ef-e7d82eff1866: material: "SANDSTONE" dailyShop_meta: buyPrice: "30.0" sellPrice: "3.0" set: 32 sellPerms: - "permission.custom" ``` ### Commands The commands executed when this item is purchased. ```yaml ffc39149-4163-47b1-95c1-8d8be04cc545: material: "TERRACOTTA" dailyShop_meta: buyPrice: "50.0" sellPrice: "5.0" set: 32 commands: - "eco give %player% 30" ``` ### Bundle This option represent all the keys of the items that are included in this [bundle.](broken://pages/-MaACzzZXkxVZ8E4noxS) ```yaml 7e05d93b-cc9c-429a-989d-3122271d6dab: material: "CHEST_MINECART" dailyShop_meta: buyPrice: "500.0" sellPrice: "20.0" bundle: - "19c0ba85-f7c9-4bfc-a5f8-57d85da92f14" - "eced2a3a-88aa-462b-a59f-a3a631ec7f3f" - "32ac0236-4eb3-48ce-91bc-5547fabbbdfc" ``` ### Rarity This represent the rarity of the item. It has to be a [vaild rarity key](/daily-random-shop/yaml-support/format/rarities.md). ```yaml 6870de86-bf87-43d2-80f7-3c1a6d580c0d: material: "GRASS" dailyShop_meta: buyPrice: "500.0" sellPrice: "20.0" set: 30 rarity: "Common" ``` ### Economy This represents the economy used for this item. The the format ECONOMY:CURRENCY. Where ECONOMY is a [valid economy key](/daily-random-shop/yaml-support/format/economies.md) and CURRENCY is the currency used in multiCurrencies economies such as gemsEconomy. For singleEconomies like PlayerPoints just leave CURRENCY empty ```yaml 8b6a62d9-ad94-460d-a7f4-419fee4dde74": name: "§cCustom" material: "ACACIA_WOOD" dailyShop_meta: buyPrice: "500.0" sellPrice: "20.0" rarity: "Common" econ: "vault:" ``` ```yaml 8b6a62d9-ad94-460d-a7f4-419fee4dde74": name: "§cCustom" material: "ACACIA_WOOD" dailyShop_meta: buyPrice: "500.0" sellPrice: "20.0" rarity: "Common" econ: "gemsEconomy:flowers" ``` ### ConfirmGui A boolean representing if the confirmGui is activated ```yaml ac4ad7e1-59e8-4fca-bf79-e62cae31650c: material: "GRASS" dailyShop_meta: buyPrice: "500.0" sellPrice: "20.0" confirm_gui: true rarity: "Common" econ: "vault:" ``` ### Action Lets you perform actions when an non daily item is clicked. Only usefull on [display\_items](/daily-random-shop/yaml-support/format.md#display_items). It has to be a [valid key](/daily-random-shop/yaml-support/format/actions.md). The format is KEY:DATA. ```yaml 2e2fa7dc-adc8-4430-a238-707f94493fd2: name: '&cGo back to Menu' material: BARRIER quantity: 1 action: OPEN_SHOP:menu ``` ### Slot This is the value that represents where the item is placed on the inventory. Only usefull on [display\_items](/daily-random-shop/yaml-support/format.md#display_items). ```yaml 2e2fa7dc-adc8-4430-a238-707f94493fd2: name: '&cGo back to Menu' material: BARRIER quantity: 1 action: OPEN_SHOP:menu slot: 40 ``` ### Air Marks the item as an [AIR item](/daily-random-shop/usage/shop-display.md#air-items). Only usefull on [display\_items](/daily-random-shop/yaml-support/format.md#display_items). ## Custom NBT All the metadata that is not collected withing the above along with custom metadata is tagged under nbt. This allows to change some tags from custom items such as vouchers or MMOItems and advanced item meta. ```yaml 1b5a1d9c-f36d-459d-b9e1-ecdac009feaa: name: "§4§lDestructor §7Gkit" lore: - "§7Clic para obtener el Gkit" - "§7de destructor!" material: "FIRE_CHARGE" enchantments: LUCK: 1 dailyShop_meta: buyPrice: "500.0" sellPrice: "20.0" confirm_gui: true rarity: "Common" econ: "vault:" nbt: voucher: "DestructorGkit" Damage: 0 HideFlags: 1 ```