Installation

1. Download the latest sntrade-v* release from Sn-Releases.
2. Place the .jar file into your server's plugins/ folder, next to SnLib.jar.
3. Start the server once. SnTrade creates the shared license file plugins/.Sn-License/license.yml.
4. Paste your Sn license key into that file, replacing the placeholder line.
5. Restart the server. SnTrade validates the key at startup and then enables.

Dependencies

Requirements: Java 21+, Paper 1.20.x (1.20.4 or newer) or 1.21.x.

Without any economy, SnTrade still trades items. A currency whose backend is missing is skipped with a SEVERE console line that names it.

First boot

SnTrade writes every file it needs on first boot:

plugins/
  .Sn-License/
    license.yml            your bundle key, shared by every Sn bundle plugin
  SnTrade/
    config.yml             requests, currencies, confirmation, claims, history, limits, sounds
    lang/
      messages_en.yml      every line the plugin sends (English)
      messages_es.yml      the Spanish translation
    guis/
      trade.yml            the trade menu both players share
      claims.yml           the claims mailbox (/trade claims)
      history.yml          the trade history (/trade history)
      history-view.yml     the details of one logged trade
    value-incidents/       local review records, created on first use (see the FAQ)

With database.type: sqlite (the default) the database file lives in the same folder. Claims, the trade log, the crash journal, the lock state and each player's request toggle all live in the database.

Before players use it

• Check the currencies. money (Vault) is on and gems (EdTools) ships disabled. Set gems.currency-id to your EdTools currency id before you enable it, or delete the entry. See Configuration.
• Decide how amounts are typed. currency-input.mode is anvil. Set it to chat to type amounts in chat instead.
• Graves or keep-inventory plugins. Set death.escrow-policy: claim. With vanilla, a dead trader's offered items join the death drops, and a plugin that clears the drops afterwards would lose them.
• Tune the anti-abuse rules. Creative and spectator cannot trade by default. Blocked worlds, distance limits, same IP, minimum playtime and the item blacklist ship off or empty.

MySQL and several servers

Every server that uses MySQL needs its own explicit server-name. It scopes the trade log, the claims mailbox, the crash journal and the lock.

• An empty server-name, default, * or a name longer than 59 characters is refused on MySQL, and the plugin does not enable.
• The first MySQL start creates plugins/SnTrade/scope.id and binds it to server-name. Keep this file with that server's data across updates. Never copy it to another server.
• If the name is already bound to another installation, SnTrade refuses to start. After a crash, a restart may wait up to 90 seconds for the previous lease to expire.
• /trade reload cannot change server-name. Migrate its stored rows, then restart.