# Plugin Files ### config.yml ```yaml # The prefix for the plugin prefix: '&8[&eShops&8]' # The primary language of the plugin language: en_us settings: currency: # When using default/vault currency, what symbol should be used. Mainly for admin guis vault symbol: $ # The default currency selection, PluginName/CurrencyName -> Ex. Vault/Vault default selection: Vault/Vault format: # An ISO 3166 alpha-2 country code or a UN M.49 numeric-3 area code. country: US # An ISO 639 alpha-2 or alpha-3 language code. language: en # A list of owning plugins & the currency to be blacklisted. Ex. UltraEconomy:Gems black listed: - UltraEconomy:Gems # If true, Shops will only allow the usage of another item for currency. use item only: false tax: # The tax percentage. By default it's 13% percentage: 13.0 # If true, will apply sales tax to the total when a user is buying an item enabled: false # If true, selling items to a shop will remove tax percentage tax on sell: false # How should timestamps be formatted date time format: MMM dd, yyyy hh:mm:ss a gui: layout control picker: items: filter: # item: REPEATER exit: # item: BARRIER search: # item: DARK_OAK_SIGN prev page: # item: ARROW cart: # item: MINECART next page: # item: ARROW shared buttons: back button: # item: DARK_OAK_DOOR previous button: # item: ARROW next button: # item: ARROW exit button: # item: BARRIER shops main: # If true, shops will auto fill into specified slots use auto fill: true # You can use MATERIAL:Model Number if you want here, or textures.minecraft links background: WHITE_STAINED_GLASS_PANE # Used manually specify shop slots, auto fill must be off. format -> slot: shop: fixed shops: - slot:10 shop:food # TBD decorations: - slot:0-8 item:BLACK_STAINED_GLASS_PANE - slot:45-53 item:BLACK_STAINED_GLASS_PANE - slot:9 item:BLACK_STAINED_GLASS_PANE - slot:18 item:BLACK_STAINED_GLASS_PANE - slot:27 item:BLACK_STAINED_GLASS_PANE - slot:36 item:BLACK_STAINED_GLASS_PANE - slot:17 item:BLACK_STAINED_GLASS_PANE - slot:26 item:BLACK_STAINED_GLASS_PANE - slot:35 item:BLACK_STAINED_GLASS_PANE - slot:44 item:BLACK_STAINED_GLASS_PANE # Number of rows for the gui, min 2 max 6 rows: 6 # The slots shops will be placed into if auto fill is on. fill slots: - 20 - 21 - 22 - 23 - 24 - 30 - 31 - 32 shop contents: items: filter: # item: REPEATER review: # item: DARK_OAK_SIGN cart: # item: MINECART checkout: items: breakdown: # item: PAPER increase: # Format: item, slot, change amount(how much the qty will increase/decrease by) items: - item:LIME_STAINED_GLASS_PANE quantity:1 slot:24 change:1 - item:LIME_STAINED_GLASS_PANE quantity:5 slot:34 change:5 - item:LIME_STAINED_GLASS_PANE quantity:10 slot:42 change:10 checkout: # item: LIME_DYE decrease: # Format: item, slot, change amount(how much the qty will increase/decrease by) items: - item:RED_STAINED_GLASS_PANE quantity:1 slot:20 change:1 - item:RED_STAINED_GLASS_PANE quantity:5 slot:28 change:5 - item:RED_STAINED_GLASS_PANE quantity:10 slot:38 change:10 cart: items: clear: # item: LAVA_BUCKET checkout: # item: LIME_DYE ``` ## **en\_us.yml** ```yaml gui: admin main: title: &lShops &7v%plugin_version% shared buttons: back button: lore: '&e&l%left_click% &7to go back' name: &LGo Back previous button: lore: '&e&l%left_click% &7to go back a page' name: &lPrevious Page next button: lore: '&e&l%left_click% &7to go to next page' name: &lNext Page exit button: lore: '&e&l%left_click% &7to exit menu' name: &LExit shops main: title: &lShops shop edit: title: &lShops &8> &7Edit &8> &e%shop_id% items: settings: lore: - '&7Used to adjust shop specific settings' - '' - '&e&lClick &7to open shop settings' name: &LShop Settings create: lore: - '&7Used to add new items to this shop.' - '' - '&e&l%left_click% &7to add item/command' - '&b&l%right_click% &7to quick select material' name: &LAdd Item item content: lore: - '&8&m------------------------------' - '&7Buying&f: %is_buy_enabled%' - '&7Selling&f: %is_sell_enabled%' - '' - '&7Buy Price (&fx&e1&7)&f: &a%shop_item_buy_price%' - '&7Sell Price (&fx&e1&7)&f: &a%shop_item_sell_price%' - '' - '&7Minimum Buy Qty&f: &e%shop_item_purchase_qty%' - '' - '&e&l%left_click% &7to edit shop item' - '&c&l%right_click% &7to delete item' delete: lore: - '&7Used to delete the shop' - '' - '&c&lClick &7to delete this shop' name: &LDelete Shop admin shop list: title: &lShops &8> &7List items: create: lore: '&7Click to create a new shop' name: &LNew Shop shop edit content: title: &lShops &8> &7Editing Item items: add: lore: '&e&lClick &7to update item.' name: &LUpdate Item layout editor: title: &lShops &8> &7Layout Editor items: filter: lore: - '&7Used to adjust the filtering' - '&7options for this shop' name: &lFilter search: lore: - '&7Used to search for items' - '&7within this shop.' name: &lSearch empty slot: lore: - '&7This is a free slot, you can add' - '&7decorations here or assign it as a ' - '&7populated slot or even move controls.' - '' - '&e&l%left_click% &7to set as fill slot' - '&b&l%right_click% &7to move a control here' - '&d&l%right_click% &7with an item on your cursor' - '&7to decorate this slot.' name: &lEmpty Slot decoration slot: lore: - '&7This is a decoration slot' - '' - '&e&l%left_click% &7to make empty slot' - '&d&l%right_click% &7with an item on your cursor' - '&7to change the decoration item.' name: &lDecoration Slot cart: lore: - '&7Your shopping cart, may contain' - '&7items from other shops.' name: &lCart fill slot: lore: - '&7This slot will be populated by' - '&7the contents added to the shop' - '' - '&e&l%left_click% &7to disable this slot' name: &lFill Slot shop contents: items: filter: lore: - '&7Used to filter items in shop' - '' - '&7Current Type&F: &e%shop_filter_type%' - '' - '&e&lClick &7to change filter order.' name: &lFilter search: lore: - '&7Used to search for items' - '&7within this specific shop.' - '' - '&e&lLeft Click &7to search in this shop.' - '&b&lRight Click &7to reset search' name: &lSearch content: lore: sell lore: '&7Sell Price (&fx&e1&7)&f: &a%shop_item_sell_price%' description lore: '&e%shop_item_description%' base lore: - '&8&m------------------------------' - '%shop_content_desc_info%' - '%shop_content_purchase_qty_info%' - '%shop_content_buy_info%' - '%shop_content_sell_info%' - '' - '&e&l%left_click% &7to buy now' - '&b&l%right_click% &7to add to cart' min buy lore: - '' - '&7Minimum Purchase Qty&f: x&e%shop_item_purchase_qty%' buy lore: '&7Buy Price (&fx&e1&7)&f: &a%shop_item_buy_price%' cart: lore: - '&7Your shopping cart contains any items' - '&7you may have added from other shops.' - '' - '&7Total Items&F: &e%shopping_cart_item_count%' - '' - '&e&lClick &7to view your cart.' name: &lYour Cart currency picker: title: &lShops &8> &7Select Currency items: custom currency: lore: - '&7If you want to use use a specific item for' - '&7the currency, you can set that here.' - '' - '&b&l%right_click% &7to open a material picker &eor' - '&e&l%left_click% &7with the item you want to use' - '&7as the currency onto this icon.' name: &LCustom Item transactions: title: &lShops &8> &7Transactions items: transaction: lore: - '&8&m------------------------------' - '&7Transaction Type&f: &e%transaction_type%' - '&7Content Type&f: &e%content_type%' - '' - '&7Original Shop&f: &e%shop_name%' - '&7Player Name&f: &e%player_name%' - '' - '&7Quantity&F: &e%quantity%' - '&7Final Price&F: &e%final_price%' - '&7Currency&F: &e%currency%' - '&7Date&f: &e%transaction_date%' - '' - '&8&m------------------------------' cart: title: &lShops &8> &7Your Cart items: clear: lore: - '&7Used to clear your cart' - '' - '&e&lClick &7to clear cart items' name: &LClear Cart checkout: lore: - '&e&l%left_click% &7to buy items' - '&b&l%right_click% &7to sell items' name: &LConfirm Checkout content: lore: sell lore: '&7Sell Price (&fx&e1&7)&f: &a%shop_item_sell_price%' selected qty lore: - '' - '&7Selected Qty&f: x&e%shop_item_purchase_qty%' buy total lore: '&7Buy &fx&e%shop_item_purchase_qty%&f: &a%shop_item_buy_price_total%' base lore: - '&8&m------------------------------' - '%shop_content_desc_info%' - '%shop_content_purchase_qty_info%' - '%shop_content_buy_info%' - '%shop_content_sell_info%' - '' - '%shop_content_buy_info_total%' - '%shop_content_sell_info_total%' - '' - '&e&l%left_click% &7to quick buy item' - '&c&l%right_click% &7to remove from cart' description lore: '&e%shop_item_description%' sell total lore: '&7Sell &fx&e%shop_item_purchase_qty%&f: &a%shop_item_sell_price_total%' buy lore: '&7Buy Price (&fx&e1&7)&f: &a%shop_item_buy_price%' shop settings: title: &lShops &8> &7Settings &8> &e%shop_id% items: deco: lore: - '&7How the shop content will be positioned,' - '&7and any extra decoration items in the gui' - '' - '&e&lClick &7to edit the layout/decoration' name: &lShop Deco/Layout display name: lore: - '&7The display name of the shop' - '' - '&7Current&F: %shop_display_name%' - '' - '&e&lClick &7to edit display name' name: &lDisplay Name icon: lore: - '&7The display icon that is shown in /shops' - '' - '&e&lClick &7to edit the display icon' name: &lShop Icon description: lore: - '&7The description of the shop' - '' - '&7Current&F:' - '%shop_description%' - '' - '&e&lClick &7to edit description' name: &lShop Description permission: lore: - '&7The permission required to access the' - '&7shop in /shops or through commands' - '' - '&7Shop Permission&f: %shop_permission%' - '&7Enabled&f: %is_true%' - '' - '&e&l%left_click% &7to change shop permission' - '&b&l%right_click% &7to toggle on/off' name: &lShop Permission open: lore: - '&7Opens & Closes the shop, if closed then it will' - '&7not appear within /shops or be accessible through commands.' - '' - '&7Shop Opened&f: %is_true%' - '' - '&e&lClick &7to toggle open status' name: &lOpen/Close Shop command: lore: - '&7The custom command that can be used' - '&7to access the shop without going through /shops' - '' - '&7Shop Command&f: %shop_command%' - '&7Enabled&f: %is_true%' - '' - '&e&l%left_click% &7to change shop command' - '&b&l%right_click% &7to toggle on/off' name: &lShop Command layout control picker: title: '&EShops &f- &7Select Layout Control' items: filter: lore: - '&7Used to filter the shop items' - '&e&l%left_click% &7to select this control' name: &lFilter Button exit: lore: - '&7Used to exit shop menu' - '&e&l%left_click% &7to select this control' name: &lExit Button search: lore: - '&7Used to search for items in the shop' - '&e&l%left_click% &7to select this control' name: &lSearch Button prev page: lore: - '&7Used to navigate back if theres multiple pages' - '&e&l%left_click% &7to select this control' name: &lBack Button cart: lore: - '&7Used to view items added to your cart' - '&e&l%left_click% &7to select this control' name: &LCart Button next page: lore: - '&7Used to navigate forward if theres multiple pages' - '&e&l%left_click% &7to select this control' name: &lNext Button shop select content type: title: &lShops &8> &7Select Content Type items: item: lore: - '&7An item content is pretty much just' - '&7a normal item you want to sell to players.' - '' - '&e&lClick &7to select this content type.' name: &lItem Content cmd: lore: - '&7A command content is essentially a command ' - '&7that gets executed when the player buys it.' - '' - '&e&lClick &7to select this content type.' name: &lCommand Content shop add content: title: &lShops &8> &7New Item items: add: lore: '&e&lClick &7to add to shop.' name: &lAdd Item toggle buy: lore: - '&7Used to toggle whether this item can be' - '&7purchased within this shop or not.' - '' - '&7Purchase Allowed&f: %is_true%' - '' - '&e&lClick &7to toggle on or off' name: &lAllow Purchase command icon: lore: - '&8&m------------------------------' - '&7Buy Price (&fx&e1&7)&f: &a%shop_item_buy_price%' - '' - '&7Minimum Buy Qty&f: &e%shop_item_purchase_qty%' - '&7Command&f: &7/&e%shop_item_command%' - '' - '&7This item will cost the player a total of &a%shop_item_purchase_total%' - '&7to purchase in this shop before tax & discounts.' - '' - '&8&m------------------------------' - '&e&l%left_click% &7to open material picker' - '&b&l%right_click% &7to use item on cursor' sell price: lore: - '&7The sell price for &fx&e1 &7of this item.' - '' - '&7Current Price&f: &e%shop_item_sell_price%' - '' - '&e&lClick &7to adjust sell price.' name: &lSell Price toggle sell: lore: - '&7Used to toggle whether this item can be' - '&7sold within this shop or not.' - '' - '&7Sell Allowed&f: %is_true%' - '' - '&e&lClick &7to toggle on or off' name: &lAllow Sell buy price: lore: - '&7The purchase price for &fx&e1 &7of this item.' - '' - '&7Current Price&f: &e%shop_item_buy_price%' - '' - '&e&lClick &7to adjust purchase price.' name: &lPurchase Price icon: lore: - '&8&m------------------------------' - '&7Buying&f: %is_buy_enabled%' - '&7Selling&f: %is_sell_enabled%' - '' - '&7Buy Price (&fx&e1&7)&f: &a%shop_item_buy_price%' - '&7Sell Price (&fx&e1&7)&f: &a%shop_item_sell_price%' - '' - '&7Minimum Buy Qty&f: &e%shop_item_purchase_qty%' - '' - '&7This item will cost the player a total of &a%shop_item_purchase_total%' - '&7to purchase in this shop before tax & discounts.' - '' - '&8&m------------------------------' - '&e&l%left_click% &7to open material picker' - '&b&l%right_click% &7to use item on cursor' currency: lore: - '&7Used to adjust which currency' - '&7will be used to buy/sell this item' - '' - '&7Current&f: &e%currency%' - '' - '&e&lClick &7to edit currency' name: &lSwitch Currency purchase qty: lore: - '&7The minimum amount of this item' - '&7that a player must purchase.' - '' - '&7Purchase Qty&f: &e%shop_item_purchase_qty%' - '' - '&e&lClick &7to adjust purchase quantity' name: &lPurchase Quantity command desc: lore: - '&7The description that will be used' - '&7when showing this command in the shop.' - '' - '&7Description&f:' - '%shop_item_command_desc%' - '' - '&e&lClick &7to change the description' name: &lDescription command: lore: - '&7The command that will be executed' - '&7when a player purchases this item' - '' - '&7Command&f: &7/&e%shop_item_command%' - '' - '&e&lClick &7to change the command' name: &lCommand command name: lore: - '&7The display name that will be used' - '&7when showing this command in the shop.' - '' - '&7Name&f: %shop_item_command_name%' - '' - '&e&lClick &7to change the name' name: &lName checkout: title: &lShops &8> &7Checkout items: decrement: lore: '&e&lClick &7to decrement qty' name: '&c&l-%decrement_value%' breakdown: no tax lore: '&cNo tax is currently applied.' lore: - '&8&m------------------------------' - '&7Selected Quantity&F: &e%checkout_item_qty%' - '' - '&A&LPurchase' - '&7Subtotal&F: &a%checkout_item_buy_subtotal%' - '' - '&7&e&lTaxes' - '%checkout_tax_info%' - '' - '&A&LPurchase (Total)' - '&7Total&F: &a%checkout_item_buy_total%' - '' - '&8&m------------------------------' name: &LPricing Breakdown has tax lore: '&eServer Tax Rate &F(&7%tax_rate%&a%&f)' increment: lore: '&e&lClick &7to increment qty' name: '&a&l+%increment_value%' checkout: lore: - '&e&l%left_click% &7to buy now' - '&b&l%right_click% &7to add to cart' name: &LConfirm Purchase content: lore: selected qty lore: - '' - '&7Selected Qty&f: x&e%shop_item_purchase_qty%' sell lore: '&7Sell Price (&fx&e1&7)&f: &a%shop_item_sell_price%' buy total lore: '&7Buy &fx&e%shop_item_purchase_qty%&f: &a%shop_item_buy_price_total%' description lore: '&e%shop_item_description%' base lore: - '&8&m------------------------------' - '%shop_content_desc_info%' - '%shop_content_purchase_qty_info%' - '%shop_content_buy_info%' - '%shop_content_sell_info%' - '' - '%shop_content_buy_info_total%' - '%shop_content_sell_info_total%' sell total lore: '&7Sell &fx&e%shop_item_purchase_qty%&f: &a%shop_item_sell_price_total%' buy lore: '&7Buy Price (&fx&e1&7)&f: &a%shop_item_buy_price%' prompts: server shop item min qty: subtitle: '&fEnter the minimum purchase amount.' title: &lEnter Minimum Qty server shop item buy price: subtitle: '&fEnter the price for &ex&f1 of this item.' title: &lEnter Buy Price server shop item command: subtitle: '&fEnter the command for this item in chat.' title: &lEnter Command server shop item sell price: subtitle: '&fEnter the price for &ex&f1 of this item.' title: &lEnter Sell Price search: subtitle: '&fEnter search keywords into chat' title: &lSearch server shop item command name: subtitle: '&fEnter display name for command' title: &LCommand Name server shop description: subtitle: '&fEnter the new description in chat.' title: &lShop Description server shop command: subtitle: '&fEnter the new command in chat.' title: &lShop Command server shop display name: subtitle: '&fEnter the new display name in chat.' title: &lShop Name server shop item command desc: subtitle: '&fEnter description for command' title: &LCommand Description server shop id: subtitle: '&fEnter id for new shop in chat.' title: &lShop Id server shop permission: subtitle: '&fEnter the new permission in chat.' title: &lShop Permission info: shop: add: item: '&aSuccessfully added &e%item_name% &ato &b%shop_id%' deleted: '&aSuccessfully deleted that shop!' closed: '&cThat shop is currently closed!' money: add: '&f&l+ &a&l%currency%' remove: '&f&l- &c&l%currency%' error: no permission: '&cYou do not have enough permission!' shop not found: '&cCould not find any shops with that id!' shop: delete: '&cError, could not delete that shop!' player offline: '&4%value% &cis not online currently!' one fill slot required: '&cThis layout requires at least one fill slot!' not enough money: '&cYou do not have enough money!' number cannot be zero: '&cPlease enter a number greater than 0' player not found: '&4%value% &cwas not found!' checkout is not min qty: '&cYou must buy at least &fx&e%shop_item_purchase_qty% &cof this item!' not a number: '&4%value% &cis not a valid number!' item cannot be air: '&cYou cannot add air to the shop.' shop id taken: '&cA shop with that id already exists!' no shop permission: '&cYou are not allowed to use that shop' button: number key: 'Press # Key' left click: Left Click right click: Right Click left shift click: Shift+Left Click middle click: Middle Click drop key: Press Drop Key conditionals: 'true': '&aTrue' 'false': '&CFalse' closed: '&cClosed' disabled: '&cDisabled' open: '&aOpen' enabled: '&aEnabled' ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.tweetzy.ca/official-plugins/shops/plugin-files.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.