Skip to content
TTS-STUDIO docs Discord

Plugins / TradeForge

Configuration reference

This is the config.yml TradeForge writes on first start, comments included. Every key you see here is the key the plugin reads; there are no hidden ones. Change a value, reload, and it applies.

Top-level sections: language, license-key, trade, money, log, debug.

# TradeForge — player-to-player trading.
#
# Every message lives in lang/<language>.yml. Everything that decides what is
# allowed lives here.

language: en

# The key BuiltByBit gave you. Checked in the background at startup; if their
# API is unreachable the plugin starts anyway.
license-key: ""

trade:
  # Seconds a request waits before it expires on its own.
  request-timeout: 60

  # How far apart two traders may stand, in blocks. 0 = no limit.
  # Measured again on every settlement: walking away mid-trade cancels it.
  max-distance: 15

  # Slots each side may fill. 12 is three rows of four on each half.
  slots-per-side: 12

  # Both sides must confirm, and any change to either offer clears BOTH
  # confirmations. That is what stops the swap-at-the-last-moment scam, and it
  # is not optional: there is no setting here to weaken it.

  # Materials that cannot be put on the table, by name. Anyone with
  # tradeforge.bypass.blocked ignores this.
  blocked-materials: []

  # Refuse to start a trade while either player is in combat. Needs a plugin
  # that marks combat through the metadata key below; ignored when absent.
  block-in-combat: true
  combat-metadata-key: "in-combat"

money:
  # Put money on the table alongside items. Needs Vault.
  enabled: true
  # Largest amount a single trade may carry. 0 = no limit.
  max-amount: 0

log:
  # Every settled trade is appended to plugins/TradeForge/trades.log, which is
  # tab separated so you can grep it. This is how many of them are kept in
  # memory for /trade log, and how many are read back from the file on start.
  keep-last: 200
  # Also write each settled trade to the server console.
  to-console: false

debug:
  # Anonymous usage stats at bstats.org. Turn it off on an offline network.
  bstats: true