Fighting Game · Guides & deep dives

V2 Economy Direct Trade

currency offer limits, and the two-confirmation policy.

3sections1 minread
Markdown source
On this page

EconomyDirectTrade.V2 is the economy-layer direct player trading runtime. It keeps item offers and currency offers in one proposal, records both participant confirmations, and executes the exchange through working-copy inventories plus server-authoritative currency ledger mutations.

Runtime Surface#

  • FV2EconomyDirectTradeConfig stores server authority/source ids, item and currency offer limits, and the two-confirmation policy.
  • FV2EconomyDirectTradeCurrencyOffer stores a currency id and positive minor unit amount.
  • FV2EconomyDirectTradeParticipantOffer stores the participant account, offered item instance ids, and offered currencies.
  • FV2EconomyDirectTradeProposal stores participant ids, both offers, confirmation bits, state, and timestamps.
  • Operation and execution results return updated proposals, inventories, currency ledgers, server authority results, transferred item ids, and typed issues.

Transaction Rules#

  1. Either participant can add item or currency offers while the trade is not terminal.
  2. Any offer change clears both confirmations and returns the proposal to a negotiating state.
  3. Execution requires both confirmations when bRequireBothConfirmations is enabled.
  4. Item exchange uses working-copy inventories: all offered items are removed and added to the counterparty before any state is committed.
  5. Currency exchange uses batched server-authoritative mutations per participant ledger, with outgoing TransferOut debits and incoming TransferIn credits.
  6. Any inventory or currency authority failure returns the original proposal, inventories, and ledgers.

Validation Commands#

Run these checks when touching economy direct trade behavior:

bash
python3 V2/ue/Tools/check-v2-economy-direct-trade.py
python3 V2/ue/Tools/check-v2-auction-house.py
python3 V2/ue/Tools/check-v2-server-currency-authority.py
python3 V2/ue/Tools/check-v2-currency-ledger.py
python3 V2/ue/Tools/check-v2-currency-definition.py
python3 V2/ue/Tools/check-v2-inventory-trading.py
python3 V2/ue/Tools/check-v2-ci-workflow.py
python3 -m json.tool V2/ue/Content/V2/Gameplay/Economy/EconomyDirectTrade_V2_Contract.json
python3 -m json.tool V2/ue/Build/Horde/v2-buildgraph-job.json
python3 V2/tools/validate-v2-docs.py