Conversions

Conversions File

Located in your language folder, this file is where you configure custom item conversions for your farmers. You can allow players to automatically process base products into other items (like Gold Nuggets to Gold Ingots or Iron Ingots to Iron Blocks). You can charge an economy cost, require specific placeholders, and reward players with items, money, or commands.

Example

gold-nugget-to-ingot:
  item:
    material: GOLD_INGOT
    model-data: 0
    display-name: "<gold><b>Gold Ingot"
    lore:
      - "<gray>Convert all nuggets into ingots."
      - ""
      - "<white><b>REQUIREMENTS"
      - "<special_requirements>"
      - "<dark_gray>▪ <gray>Money: <gold>$1,000"
      - "<dark_gray>▪ <gray>Material: <yellow>9x Gold Nugget"
      - ""
      - "<white><b>YIELD"
      - "<dark_gray>▪ <gray>Product: <gold>1x Gold Ingot"
      - ""
      - "<white><b>STATUS"
      - "<dark_gray>▪ <gray>Available Operations: <green><possible_conversions>"
      - ""
      - "<dark_gray>▶ <yellow>Left-Click <gray>to process <white>1x"
      - "<dark_gray>▶ <gold>Shift-Click <gray>to process <white>ALL"
  slot: 0
  conversion-type: BOTH
  # conversion type can be these values:
  # SINGLE, ALL, BOTH
  # SINGLE = does a single conversion per click
  # ALL = converts everything in one click
  # BOTH = supports both types
  requirements:
    price: 1000
    static-price: false
    # if static-price is true, price will remain same even they use convert all feature
    products:
      - 9:GOLD_NUGGET
    placeholders:
      "playtime":
        display: "<dark_gray>▪ <gray>Playtime: <white>1 Hour <dark_gray>(<gray>Current: <white><papi:'math_0:floor_{statistic_PLAY_ONE_MINUTE}/72000'>h<dark_gray>)"
        condition: "%math_({statistic_PLAY_ONE_MINUTE}/72000)>60%"
        required-output: "1"
  converts-to:
    execute-player-commands-per-convert: false
    # if true, commands will be executed per-convert when convert all is used, if false, commands will be run once
    player-commands:
      - ""
    execute-console-commands-per-convert: false
    # if true, commands will be executed per-convert when convert all is used, if false, commands will be run once
    console-commands:
      - ""
    products:
      - 1:GOLD_INGOT
    send-messages-per-convert: false
    # if true, messages will be sent per-convert when convert all is used, if false, messages will be sent once
    messages:
      - "<prefix> <gray>Successfully processed <yellow>Gold Nuggets <gray>into <gold>Gold Ingots<gray>."
    money: 0
  cooldown: 30
  # cooldowns are in seconds

This is the default gold-nugget-to-ingot conversion settings. Check the tables below for understanding every option.

Tip: In your item's lore, you can use the <special_requirements> tag to automatically inject the formatted placeholder requirements, and the <possible_conversions> tag to show the player exactly how many times they can run the conversion based on their current balance and items!

Conversion Configuration Settings

Setting	Type	Description
item	Configuration	The visual configuration for the GUI item (includes material, model-data, display-name, and lore).
slot	int	The inventory slot (starting from 0) where this conversion will appear in the GUI.
conversion-type	String	Dictates how the conversion functions. SINGLE limits to 1 per click. ALL converts everything possible in one click. BOTH allows Left-Click for single and Shift-Click for all.
cooldown	int	The cooldown time applied to the farmer in seconds after a successful conversion.

---

Requirements Settings

Setting	Description
price	The amount of money required to perform this conversion once.
static-price	If true, the price will not be multiplied when a player uses the "Convert All" feature (meaning bulk crafting is discounted). If false, the price multiplies by the amount converted.
products	A list of items required for the conversion, formatted as AMOUNT:MATERIAL (e.g., 9:GOLD_NUGGET).
placeholders	The PlaceholderAPI conditions a player must meet to use this conversion.

---

Converts-To (Yield) Settings

Setting	Description
products	A list of items given to the farmer upon successful conversion, formatted as AMOUNT:MATERIAL (e.g., 1:GOLD_INGOT).
money	The amount of money rewarded to the player's balance.
messages	A list of chat messages sent to the player upon successful conversion.
send-messages-per-convert	If true, the messages will be sent for every item converted during a "Convert All" action (Warning: this can spam chat). If false, it sends the message list only once.
player-commands	Commands executed by the player.
execute-player-commands-per-convert	If true, runs the player commands per every conversion. If false, runs only once per transaction.
console-commands	Commands executed by the server console.
execute-console-commands-per-convert	If true, runs the console commands per every conversion. If false, runs only once per transaction.